NFT Collection Details
Surfaces information about any ERC721 or ERC1155 NFT collection.
Try it nownftCollections
Takes an array of collections
input containing address and network information. Returns detailed collection data including:
- Collection metadata
- Floor price, top offer, market cap data
- Complete Holders List
- Social links and images
- Sales history
- Trait information
Example Use Case: Collection Details
Variables
{
"collections": [
{
"collectionAddress": "0xa449b4f43d9a33fcdcf397b9cc7aa909012709fd",
"network": "BASE_MAINNET"
}
],
}
Example Query
query NftCollectionWithNfts($collections: [NftCollectionInput!]!, $first: Int = 10) {
nftCollections(collections: $collections) {
# Basic collection metadata
id
name
description
network
address
nftStandard
supply
totalSupply
circulatingSupply
totalCirculatingSupply
holdersCount
# Market statistics and valuation
marketCap
floorPrice {
valueUsd
valueWithDenomination
denomination {
network
symbol
address
}
}
topOfferPrice {
valueUsd
valueWithDenomination
denomination {
network
symbol
address
}
}
floorPriceSourceMarketPlace
topOfferSourceMarketPlace
# Visual assets and media - enhanced with better fields
medias {
logo {
original
thumbnail
medium
large
blurhash
width
height
mimeType
fileSize
}
banner {
original
thumbnail
medium
large
blurhash
width
height
mimeType
fileSize
}
}
# External links and social presence
socialLinks {
name
label
url
logoUrl
}
# First N NFTs in the collection with detailed metadata
nfts(first: 1) {
edges {
node {
# Basic NFT information
id
tokenId
name
description
# Ownership information
holdersCount
supply
circulatingSupply
# Media and visual assets
mediasV3 {
images(first: 3) {
edges {
node {
original
thumbnail
medium
large
blurhash
width
height
mimeType
fileSize
}
}
pageInfo {
hasNextPage
endCursor
}
}
animations(first: 2) {
edges {
node {
original
mimeType
fileSize
}
}
pageInfo {
hasNextPage
endCursor
}
}
audios(first: 1) {
edges {
node {
original
mimeType
fileSize
}
}
}
}
# Rarity and trait information
traits {
id
attributeName
attributeValue
supply
supplyPercentage
}
# Market data
estimatedValue {
valueUsd
valueWithDenomination
denomination {
network
address
symbol
imageUrl
}
}
# Last sale information
lastSale {
valueUsd
valueWithDenomination
denomination {
network
address
symbol
imageUrl
}
}
# Recent transfers
transfers(first: 2, order: { orderBy: TIMESTAMP, orderDirection: DESC }) {
edges {
node {
timestamp
txHash
payments {
tokenAddress
tokenSymbol
tokenValue
tokenValueETH
tokenValueUSD
}
}
heldForInSeconds
}
pageInfo {
hasNextPage
endCursor
}
}
}
cursor
}
pageInfo {
hasNextPage
endCursor
}
}
# First 2 holders with identity information
holders(first: 2) {
totalCount
edges {
node {
id
account {
id
address
displayName {
value
source
}
farcasterProfile {
fid
username
metadata {
displayName
imageUrl
description
}
}
}
# Number of unique items
holdCount
# Total number of items (used for ERC-1155)
holdTotalCount
}
cursor
}
pageInfo {
hasNextPage
endCursor
}
}
# Recent collection events/activity
events(first: 2) {
edges {
node {
... on CollectionEventSale {
timestamp
txHash
fromAccount {
address
displayName {
value
}
}
toAccount {
address
displayName {
value
}
}
token {
tokenId
name
}
payments {
tokenValueUSD
tokenValueETH
}
}
... on CollectionEventTransfer {
timestamp
txHash
fromAccount {
address
displayName {
value
}
}
toAccount {
address
displayName {
value
}
}
token {
tokenId
name
}
}
}
}
pageInfo {
hasNextPage
endCursor
}
}
}
}
Example Response
{
"data": {
"nftCollections": [
{
"id": "TmZ0Q29sbGVjdGlvbi0yMDM3MTMyNQ==",
"name": "onchain gaias",
"description": "https://warpcast.com/~/channel/ogs",
"network": "BASE_MAINNET",
"address": "0xa449b4f43d9a33fcdcf397b9cc7aa909012709fd",
"nftStandard": "ERC_721",
"supply": "5222",
"totalSupply": "5011",
"circulatingSupply": "5222",
"totalCirculatingSupply": "5011",
"holdersCount": "2447",
"marketCap": "965.21882",
"floorPrice": {
"valueUsd": 359.59314550056,
"valueWithDenomination": 0.19262,
"denomination": {
"network": "base",
"symbol": "ETH",
"address": "0x0000000000000000000000000000000000000000"
}
},
"topOfferPrice": {
"valueUsd": 952.09481988,
"valueWithDenomination": 0.51,
"denomination": {
"network": "base",
"symbol": "ETH",
"address": "0x0000000000000000000000000000000000000000"
}
},
"floorPriceSourceMarketPlace": "OPENSEA",
"topOfferSourceMarketPlace": "OPENSEA",
"medias": {
"logo": {
"original": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fbase%2F0xa449b4f43d9a33fcdcf397b9cc7aa909012709fd%2Flogo.png&checksum=a34b1",
"thumbnail": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fbase%2F0xa449b4f43d9a33fcdcf397b9cc7aa909012709fd%2Flogo.png&width=100&checksum=be3af",
"medium": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fbase%2F0xa449b4f43d9a33fcdcf397b9cc7aa909012709fd%2Flogo.png&width=250&checksum=5532f",
"large": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fbase%2F0xa449b4f43d9a33fcdcf397b9cc7aa909012709fd%2Flogo.png&width=500&checksum=16f2c",
"blurhash": "U142SUt700S2XTWXnhsm4Tax?wjbwHo0S$S4",
"width": 512,
"height": 365,
"mimeType": "image/png",
"fileSize": 63028
},
"banner": {
"original": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fbase%2F0xa449b4f43d9a33fcdcf397b9cc7aa909012709fd%2Fbanner.gif&checksum=d12d4",
"thumbnail": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fbase%2F0xa449b4f43d9a33fcdcf397b9cc7aa909012709fd%2Fbanner.gif&width=100&checksum=7b6e7",
"medium": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fbase%2F0xa449b4f43d9a33fcdcf397b9cc7aa909012709fd%2Fbanner.gif&width=250&checksum=23eb1",
"large": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fbase%2F0xa449b4f43d9a33fcdcf397b9cc7aa909012709fd%2Fbanner.gif&width=500&checksum=a6a96",
"blurhash": "UDHKrB%PnMtA~B-rkEoI00M_bcW9VqInNFa$",
"width": 1000,
"height": 714,
"mimeType": "image/gif",
"fileSize": 5691323
}
},
"socialLinks": [
{
"name": "opensea",
"label": "Opensea",
"url": "https://opensea.io/collection/onchain-gaias",
"logoUrl": "https://storage.googleapis.com/zapper-fi-assets/logos/opensea.png"
},
{
"name": "website",
"label": "Website",
"url": "https://warpcast.com/~/channel/ogs",
"logoUrl": "https://storage.googleapis.com/zapper-fi-assets/logos/website.png"
},
{
"name": "twitter",
"label": "Twitter",
"url": "https://twitter.com/onchaingaias",
"logoUrl": "https://storage.googleapis.com/zapper-fi-assets/logos/twitter.png"
}
],
"nfts": {
"edges": [
{
"node": {
"id": "TmZ0VG9rZW4tODk2OTM5NjI4",
"tokenId": "0",
"name": "onchain gaias",
"description": "https://warpcast.com/~/channel/ogs",
"holdersCount": "1",
"supply": "1",
"circulatingSupply": "1",
"mediasV3": {
"images": {
"edges": [
{
"node": {
"original": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fmedias%2F81e1e8c175f784916c3af5d8d98c7c437955d31dd2696bc553da2948a60c7f6a.gif&checksum=5a066",
"thumbnail": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fmedias%2F81e1e8c175f784916c3af5d8d98c7c437955d31dd2696bc553da2948a60c7f6a.gif&width=100&checksum=4c8b5",
"medium": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fmedias%2F81e1e8c175f784916c3af5d8d98c7c437955d31dd2696bc553da2948a60c7f6a.gif&width=250&checksum=181a7",
"large": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fmedias%2F81e1e8c175f784916c3af5d8d98c7c437955d31dd2696bc553da2948a60c7f6a.gif&width=500&checksum=5db86",
"blurhash": "UDHKrB%ii]tA~B-rf-oI00M_f,W9Z}InNFa$",
"width": 1000,
"height": 714,
"mimeType": "image/gif",
"fileSize": 14730609
}
}
],
"pageInfo": {
"hasNextPage": false,
"endCursor": "MA=="
}
},
"animations": {
"edges": [],
"pageInfo": {
"hasNextPage": false,
"endCursor": null
}
},
"audios": {
"edges": []
}
},
"traits": [],
"estimatedValue": {
"valueUsd": 952.9819810845909,
"valueWithDenomination": 0.5104752175990185,
"denomination": {
"network": "base",
"address": "0x0000000000000000000000000000000000000000",
"symbol": "ETH",
"imageUrl": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0x0000000000000000000000000000000000000000.png"
}
},
"lastSale": {
"valueUsd": 1493.4820704,
"valueWithDenomination": 0.8,
"denomination": {
"network": "base",
"address": "0x0000000000000000000000000000000000000000",
"symbol": "ETH",
"imageUrl": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0x0000000000000000000000000000000000000000.png"
}
},
"transfers": {
"edges": [
{
"node": {
"timestamp": 1714345783,
"txHash": "0x115e56575c3b881706ffb18e30990ca4353aef350f536a5773b0e3ce6a60cb78",
"payments": []
},
"heldForInSeconds": 27294913
},
{
"node": {
"timestamp": 1713467079,
"txHash": "0x17faaa84b6958ed8369c16af5b43900c7e178ac1dfed833d5427450ff353df19",
"payments": []
},
"heldForInSeconds": 878704
}
],
"pageInfo": {
"hasNextPage": true,
"endCursor": "MTcxMzQ2NzA3OToxNTUxNDQyODgy"
}
}
},
"cursor": "MC0wLjgtMC41MTA0NzUyMTc1OTkwMTg1LW51bGwtODk2OTM5NjI4"
}
],
"pageInfo": {
"hasNextPage": true,
"endCursor": "MC0wLjgtMC41MTA0NzUyMTc1OTkwMTg1LW51bGwtODk2OTM5NjI4"
}
},
"holders": {
"totalCount": 2447,
"edges": [
{
"node": {
"id": "TmZ0Q29sbGVjdGlvbkhvbGRlci0xNzE1MzcxMTg4",
"account": {
"id": "QWNjb3VudC0weDc1ZDRiZGJmNjU5M2VkNDYzZTk2MjU2OTQyNzJhMGZmOWE2ZDM0NmY=",
"address": "0x75d4bdbf6593ed463e9625694272a0ff9a6d346f",
"displayName": {
"value": "xmon.eth",
"source": "ENS"
},
"farcasterProfile": {
"fid": 216983,
"username": "xmon.eth",
"metadata": {
"displayName": "0xmons",
"imageUrl": "https://i.imgur.com/Xei6cvg.png",
"description": "-w-"
}
}
},
"holdCount": "51",
"holdTotalCount": "51"
},
"cursor": "NTEtMTcxNTM3MTE4OA=="
},
{
"node": {
"id": "TmZ0Q29sbGVjdGlvbkhvbGRlci0xNzIwODIwMDUw",
"account": {
"id": "QWNjb3VudC0weDNmZDIyYzQyY2FmYThmMDlkZjk1OWM4NTNmNzBmOWNlZDg0MDk5Njc=",
"address": "0x3fd22c42cafa8f09df959c853f70f9ced8409967",
"displayName": {
"value": "0x3fd2...9967",
"source": "ADDRESS"
},
"farcasterProfile": null
},
"holdCount": "50",
"holdTotalCount": "50"
},
"cursor": "NTAtMTcyMDgyMDA1MA=="
}
],
"pageInfo": {
"hasNextPage": true,
"endCursor": "NTAtMTcyMDgyMDA1MA=="
}
},
"events": {
"edges": [
{
"node": {
"timestamp": 1741616621,
"txHash": "0x4d563ea3494687834f81f00a08e4d0b91e3e9de89477d64daaa5ba66eb7cb714",
"fromAccount": {
"address": "0xc59416ed0833ce6002a8fa15917c4bf5c2350589",
"displayName": {
"value": "weeb.eth"
}
},
"toAccount": {
"address": "0xef4e9bdd3f72a19acdb73ece01bb031c7bb1f750",
"displayName": {
"value": "0xef4e...f750"
}
},
"token": {
"tokenId": "1837",
"name": "onchain gaias"
},
"payments": [
{
"tokenValueUSD": "360.23636376953124",
"tokenValueETH": "0.179"
}
]
}
},
{
"node": {
"timestamp": 1741616621,
"txHash": "0x4d563ea3494687834f81f00a08e4d0b91e3e9de89477d64daaa5ba66eb7cb714",
"fromAccount": {
"address": "0xc59416ed0833ce6002a8fa15917c4bf5c2350589",
"displayName": {
"value": "weeb.eth"
}
},
"toAccount": {
"address": "0x90d33403683ac39225928a1c6feee1011d568e37",
"displayName": {
"value": "0x90d3...8e37"
}
},
"token": {
"tokenId": "3490",
"name": "onchain gaias"
},
"payments": [
{
"tokenValueUSD": "342.1239208984375",
"tokenValueETH": "0.17"
}
]
}
}
],
"pageInfo": {
"hasNextPage": true,
"endCursor": "MTc0MTYxNjYyMQ=="
}
}
}
]
}
}
Rich filtering options
nfts(
first: 5, # Limit to first 5 NFTs
tokenIds: ["8031", "7804"], # Specific token IDs to fetch
owners: ["0xd387a6e4e84a6c86bd90c158c6028a58cc8ac459"], # Filter by owner
traits: [ # Filter by specific traits
{
type: "Background",
value: "Blue"
},
{
type: "Clothes",
value: "Smoking Jacket"
}
],
order: { # Sorting options
orderBy: ESTIMATED_VALUE_ETH,
orderDirection: DESC
}
)
Arguments
Argument | Description | Type | Required |
---|---|---|---|
collections | Array of inputs specifying collection details | [NftCollectionInput!]! | Yes |
NftCollectionInput
Field | Description | Type | Required |
---|---|---|---|
collectionAddress | The address of the NFT collection | String! | Yes |
network | The network where the NFT exists | Network! | Yes |
subCollectionIdentifier | Identifier for a sub-collection | String | No |
Fields
Field | Description | Type |
---|---|---|
id | Unique identifier for the collection | ID! |
address | Contract address of the collection | Address! |
subCollectionIdentifier | Identifier for sub-collection | String! |
name | Name of the collection | String! |
displayName | Display name of the collection | String |
symbol | Symbol/ticker of the collection | String! |
description | Description of the collection | String! |
network | Network where the collection exists | Network! |
socialLinks | Array of social media links | [SocialLink!]! |
supply | Total supply of the collection | BigDecimal! |
totalSupply | Total supply including burned tokens | BigDecimal! |
floorPriceEth | Floor price in ETH (deprecated) | BigDecimal |
floorPriceSourceMarketPlace | Source marketplace for floor price | NftDataSourceMarketplace |
topOfferPriceEth | Top offer in ETH (deprecated) | BigDecimal |
topOfferSourceMarketPlace | Source marketplace for top offer | NftDataSourceMarketplace |
holdersCount | Number of unique holders | BigDecimal! |
nftStandard | Token standard | NftStandard! |
disabled | Whether the collection is disabled | Boolean! |
type | Type of collection | NftCollectionType! |
openseaId | OpenSea identifier | String |
spamScore | Spam score of the collection | BigDecimal |
floorPrice | Current floor price | NftValueDenomination |
topOfferPrice | Highest current offer | NftValueDenomination |
isApproved | Check if collection is approved for a spender | (spenderAddress: Address!, ownerAddress: Address!) => Boolean! |
approvalTransaction | Get transaction config for approval | (spenderAddress: Address!, ownerAddress: Address!) => TransactionConfig! |
revokeApprovalTransaction | Get transaction config for revoking approval | (spenderAddress: Address!, ownerAddress: Address!) => TransactionConfig! |
nfts | List of NFTs in the collection | NftTokenConnection! |
events | Collection events (sales, transfers) | CollectionEventConnection! |
traitGroups | Groups of traits for the collection | [NftCollectionTraitGroupBase!]! |
traitGroupValues | Values for trait groups | NftCollectionTraitValueConnection! |
traits | Collection traits | [NftCollectionTraitType!]! |
holders | Collection holders | PaginatedNftHolder! |
medias | Collection media assets | NftCollectionMedias! |
circulatingSupply | Number of tokens in circulation | BigDecimal! |
totalCirculatingSupply | Total circulating supply | BigDecimal! |
groups | Collection groups information | [NftCollectionGroup!]! |
marketCap | Market capitalization | BigDecimal |
Enums
enum NftStandard {
ERC_721
ERC_1155
}
enum NftCollectionType {
GENERAL
BRIDGED
BADGE
POAP
TICKET
ACCOUNT_BOUND
WRITING
GAMING
ART_BLOCKS
BRAIN_DROPS
LENS_PROFILE
LENS_FOLLOW
LENS_COLLECT
ZORA_ERC721
ZORA_ERC1155
BLUEPRINT
}
enum NftDataSourceMarketplace {
OPENSEA
X2Y2
LOOKSRARE
RESERVOIR
BLUR
}
enum NftPaymentStatsPeriod {
Week
Month
Quarter
}
enum NftTokenSort {
RARITY_RANK
LAST_SALE_ETH
ESTIMATED_VALUE_ETH
}
Notes
- Provides real-time floor price data
- Supports both ERC721 and ERC1155 standards
- Includes social links and media assets
- Offers trait and holder information
- Tracks market data and collection events
- Supports collection approval management
- Returns paginated results for NFTs, events, and holders