Collection Metadata
Takes an array of collections
input containing address and chainId information. Returns detailed collection data including:
- Paginated response of each NFT in the collection
- Sales, transfers, and mint history
- Floor price, top offer, market cap data
- Complete Holders List
- Social links and images
nftCollectionsV2
Example Use Case: Collection Details
Variables
{
"collections": [
{
"address": "0xa449b4f43d9a33fcdcf397b9cc7aa909012709fd",
"chainId": 8453
}
],
}
Example Query
query NftCollectionWithNfts($collections: [NftCollectionInputV2!]!) {
nftCollectionsV2(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": {
"nftCollectionsV2": [
{
"id": "TmZ0Q29sbGVjdGlvbi0yMDM3MTMyNQ==",
"name": "onchain gaias",
"description": "handcrafted spatial connections\r\n\r\nhttps://gaias.xyz",
"network": "BASE_MAINNET",
"address": "0xa449b4f43d9a33fcdcf397b9cc7aa909012709fd",
"nftStandard": "ERC_721",
"supply": "5222",
"totalSupply": "5011",
"circulatingSupply": "5222",
"totalCirculatingSupply": "5011",
"holdersCount": "2426",
"marketCap": "811.68178",
"floorPrice": {
"valueUsd": 301.84670372766,
"valueWithDenomination": 0.16198,
"denomination": {
"network": "base",
"symbol": "ETH",
"address": "0x0000000000000000000000000000000000000000"
}
},
"topOfferPrice": {
"valueUsd": 950.37547167,
"valueWithDenomination": 0.51,
"denomination": {
"network": "base",
"symbol": "ETH",
"address": "0x0000000000000000000000000000000000000000"
}
},
"floorPriceSourceMarketPlace": null,
"topOfferSourceMarketPlace": "OPENSEA",
"medias": {
"logo": {
"original": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/collections/base/0xa449b4f43d9a33fcdcf397b9cc7aa909012709fd/logo.jpeg&checksum=bcI-kQSVa4zgG0QCHNIhzUYnLJZjoIyOjMKtwdw642M",
"thumbnail": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/collections/base/0xa449b4f43d9a33fcdcf397b9cc7aa909012709fd/logo.jpeg&width=100&checksum=NAvzylceAqFu8DXlH9C8ICRE00IbAeWoUDZfkMibpx8",
"medium": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/collections/base/0xa449b4f43d9a33fcdcf397b9cc7aa909012709fd/logo.jpeg&width=250&checksum=b9fbw9F5SXFlCzuYzXXaLPSC1ufb3U1itc3vq4OwfsQ",
"large": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/collections/base/0xa449b4f43d9a33fcdcf397b9cc7aa909012709fd/logo.jpeg&width=500&checksum=VOXAVubrG9qIlqJQcvoIAp57yTGQPzhO-6LnwyBnKng",
"blurhash": "UKH2D+i*H]~B-=9uS#xv00Ri?HjbafxuWUNG",
"width": 250,
"height": 166,
"mimeType": "image/jpeg",
"fileSize": 6945
},
"banner": {
"original": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/collections/base/0xa449b4f43d9a33fcdcf397b9cc7aa909012709fd/banner.jpeg&checksum=-_0WRXXBmdQCoCD7SylGnffpGJ7N9zqd8fylDSmObGA",
"thumbnail": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/collections/base/0xa449b4f43d9a33fcdcf397b9cc7aa909012709fd/banner.jpeg&width=100&checksum=KVR5y-si-5XgucT225lApanTUJ-L0qHhRlHq7I1i2U8",
"medium": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/collections/base/0xa449b4f43d9a33fcdcf397b9cc7aa909012709fd/banner.jpeg&width=250&checksum=C2wjoAVbzHVVjkYdJJRg-DtelZ84EmzpDzl12rfpuwE",
"large": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/collections/base/0xa449b4f43d9a33fcdcf397b9cc7aa909012709fd/banner.jpeg&width=500&checksum=mOpMnHnWNIe8PX7TfVKLwHfhVqgrtct-zy2iZHxic5k",
"blurhash": "UBEo[gkD9Gxvp3t8%2js00RiobWB=}WEIqWB",
"width": 1000,
"height": 666,
"mimeType": "image/jpeg",
"fileSize": 84749
}
},
"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 gaia #0",
"description": "handcrafted spatial connections",
"holdersCount": "1",
"supply": "1",
"circulatingSupply": "1",
"mediasV3": {
"images": {
"edges": [
{
"node": {
"original": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/medias/38172dca0b6280257adc10616889c17d536efa94fc822a7cf62c9135a54231d1.jpeg&checksum=TVB3lxjgVKrPeDSyCyetuLrWjmPC4-lJhttJsn59Fj0",
"thumbnail": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/medias/38172dca0b6280257adc10616889c17d536efa94fc822a7cf62c9135a54231d1.jpeg&width=100&checksum=K_CzaOiPsuZbuuI5KeOm_kfW4YyN7cpH6kSpfpnJ9G0",
"medium": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/medias/38172dca0b6280257adc10616889c17d536efa94fc822a7cf62c9135a54231d1.jpeg&width=250&checksum=WvCcJTIKN8ev00gns6MEFzp-_TLtD4k9yn_6xpNI5zI",
"large": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/medias/38172dca0b6280257adc10616889c17d536efa94fc822a7cf62c9135a54231d1.jpeg&width=500&checksum=aRqPMXD-wnpvLSKAM5w-29ARCJ-ezm8dRN-FS8KdFXc",
"blurhash": "UAEo_nog9FxvXYxu%2j[00RiobWB^kWXIqWB",
"width": 3000,
"height": 3000,
"mimeType": "image/jpeg",
"fileSize": 2752061
}
}
],
"pageInfo": {
"hasNextPage": false,
"endCursor": "MA=="
}
},
"animations": {
"edges": [],
"pageInfo": {
"hasNextPage": false,
"endCursor": null
}
},
"audios": {
"edges": []
}
},
"traits": [
{
"id": "1312131607",
"attributeName": "class",
"attributeValue": "architect",
"supply": "493",
"supplyPercentage": 9.4408272692455
}
],
"estimatedValue": {
"valueUsd": 1043.721395957424,
"valueWithDenomination": 0.5600922243951985,
"denomination": {
"network": "base",
"address": "0x0000000000000000000000000000000000000000",
"symbol": "ETH",
"imageUrl": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0x0000000000000000000000000000000000000000.png"
}
},
"lastSale": {
"valueUsd": 1490.7850536,
"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": 31771266
},
{
"node": {
"timestamp": 1713467079,
"txHash": "0x17faaa84b6958ed8369c16af5b43900c7e178ac1dfed833d5427450ff353df19",
"payments": []
},
"heldForInSeconds": 878704
}
],
"pageInfo": {
"hasNextPage": true,
"endCursor": "MTcxMzQ2NzA3OToxNTUxNDQyODgy"
}
}
},
"cursor": "MC0wLjgtMC41NjAwOTIyMjQzOTUxOTg1LW51bGwtODk2OTM5NjI4"
}
],
"pageInfo": {
"hasNextPage": true,
"endCursor": "MC0wLjgtMC41NjAwOTIyMjQzOTUxOTg1LW51bGwtODk2OTM5NjI4"
}
},
"holders": {
"totalCount": 2426,
"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": 1746086347,
"txHash": "0xdb9a321ab55bf567a07deb6e761a2191ab2f901eae748b2bf82a2f90d8f6b82e",
"fromAccount": {
"address": "0x2ffff4b662440f8076effd6385a44edbab1a7f93",
"displayName": {
"value": "castun.eth"
}
},
"toAccount": {
"address": "0xe86c85c4de3a6a0aed3f9cb328664a25b47fb6f3",
"displayName": {
"value": "0xe86c...b6f3"
}
},
"token": {
"tokenId": "4813",
"name": "onchain gaia #4813"
},
"payments": [
{
"tokenValueUSD": "253.6381298828125",
"tokenValueETH": "0.14"
}
]
}
},
{
"node": {
"timestamp": 1746061871,
"txHash": "0x98202144386f539a24cd46ff61ee19b7831d0df37864bd75c661a60a1c044a36",
"fromAccount": {
"address": "0x2cc911cf993746280a64c1d00522b901de0a53ca",
"displayName": {
"value": "0x2cc9...53ca"
}
},
"toAccount": {
"address": "0x66667c4732e450e8ca98b48bf011735bbca27b25",
"displayName": {
"value": "ethereumpay.base.eth"
}
},
"token": {
"tokenId": "284",
"name": "onchain gaia #284"
},
"payments": [
{
"tokenValueUSD": "1517.9845536142577",
"tokenValueETH": "0.840998"
}
]
}
}
],
"pageInfo": {
"hasNextPage": true,
"endCursor": "MTc0NjA2MTg3MQ=="
}
}
}
]
}
}
Example Use Case: Collection Transfers
Used for getting all the events (transfers and sales) that have happened for a particular collection.
Try it nowExample Query
query NftCollectionsTransfers($collections: [NftCollectionInputV2!]!) {
nftCollectionsV2(collections: $collections) {
# Basic collection metadata
id
name
description
network
address
# Recent collection events/activity
events(first: 10) {
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": {
"nftCollectionsV2": [
{
"id": "TmZ0Q29sbGVjdGlvbi0yMDM3MTMyNQ==",
"name": "onchain gaias",
"description": "handcrafted spatial connections\r\n\r\nhttps://gaias.xyz",
"network": "BASE_MAINNET",
"address": "0xa449b4f43d9a33fcdcf397b9cc7aa909012709fd",
"events": {
"edges": [
{
"node": {
"timestamp": 1746086347,
"txHash": "0xdb9a321ab55bf567a07deb6e761a2191ab2f901eae748b2bf82a2f90d8f6b82e",
"fromAccount": {
"address": "0x2ffff4b662440f8076effd6385a44edbab1a7f93",
"displayName": {
"value": "castun.eth"
}
},
"toAccount": {
"address": "0xe86c85c4de3a6a0aed3f9cb328664a25b47fb6f3",
"displayName": {
"value": "0xe86c...b6f3"
}
},
"token": {
"tokenId": "4813",
"name": "onchain gaia #4813"
},
"payments": [
{
"tokenValueUSD": "253.6381298828125",
"tokenValueETH": "0.14"
}
]
}
},
...
{
"node": {
"timestamp": 1746046023,
"txHash": "0x8ebf6ae3e386c8d437ae14a6cd6270fbb57ddec3385402d1cb500152803c6d2c",
"fromAccount": {
"address": "0x794c94f1b5e455c1dba27bb28c6085db0fe544f9",
"displayName": {
"value": "midaswhale.eth"
}
},
"toAccount": {
"address": "0x2cc911cf993746280a64c1d00522b901de0a53ca",
"displayName": {
"value": "0x2cc9...53ca"
}
},
"token": {
"tokenId": "284",
"name": "onchain gaia #284"
},
"payments": [
{
"tokenValueUSD": "1284.8317834472657",
"tokenValueETH": "0.715"
}
]
}
}
],
"pageInfo": {
"hasNextPage": true,
"endCursor": "MTc0NjA0NjAyMw=="
}
}
}
]
}
}
Example Use Case: Collection NFTs
Get all the individual NFTs that are part of a given collection, complete with media, traits, estimated values, and transfer history.
Try it nowVariables
{
"collections": [
{
"address": "0xde7c3435c34ddee79234adf612467727e980400d",
"chainId": 8453
}
],
"tokenIds": ["15037","18336"], //Optional, filter by token ID
"traits": [ //Optional, filter by traits
{
"type": "Rarity",
"value": "COMMON"
}],
"owners": ["0xf0e5fbedbf83edc03b321860973ac48cc533c188"] //Optional, filter by owner
"order": {
"orderBy": "ESTIMATED_VALUE_ETH" // or RARITY_RANK, LAST_SALE_ETH
},
}
Example Query
query CollectionNFTs($collections: [NftCollectionInputV2!]!, $tokenIds: [String!], $traitIds: [String!], $traits: [NftTokenTraitInput!], $order: NftTokenConnectionOrderInput, $owners: [Address!]) {
nftCollectionsV2(collections: $collections) {
# Basic collection metadata
id
name
description
network
address
nftStandard
supply
totalSupply
circulatingSupply
# First N NFTs in the collection with detailed metadata
nfts(first: 10, tokenIds: $tokenIds, traitIds: $traitIds, traits: $traits, order: $order, owners: $owners) {
edges {
node {
# Basic NFT information
id
tokenId
name
description
estimatedValue {
valueUsd
}
# 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
}
}
}
}
Example Response
{
"data": {
"nftCollectionsV2": [
{
"id": "TmZ0Q29sbGVjdGlvbi0yMDI1NjIzNQ==",
"name": "FARWORLD // Farmon",
"description": "A Mysterious World 🪐 Filled With Mysterious Creatures 👾 // Packs & Items @ https://opensea.io/collection/farworld\r\n\r\nWebsite: https://www.farworld.gg\r\nWarpcast Channel: https://warpcast.com/~/channel/farworld",
"network": "BASE_MAINNET",
"address": "0xde7c3435c34ddee79234adf612467727e980400d",
"nftStandard": "ERC_1155",
"supply": "19140",
"totalSupply": "19135",
"circulatingSupply": "19140",
"nfts": {
"edges": [
{
"node": {
"id": "TmZ0VG9rZW4tMTAzMzg2MTUyNg==",
"tokenId": "15037",
"name": "Thundrax",
"description": null,
"estimatedValue": {
"valueUsd": 26.664810042596,
"valueWithDenomination": 0.0097400006,
"denomination": {
"network": "base",
"address": "0x0000000000000000000000000000000000000000",
"symbol": "ETH",
"imageUrl": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0x0000000000000000000000000000000000000000.png"
}
},
"holdersCount": "1",
"supply": "1",
"circulatingSupply": "1",
"mediasV3": {
"images": {
"edges": [
{
"node": {
"original": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/medias/dbadd70be3beb384369edfaaa25ffd93add7d77e53ea8de529db1257c1790c59.jpeg&checksum=FQE1vms9CxUQVB1cjXZu5sCx3ZFXXbanPeU9F9QqJiE",
"thumbnail": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/medias/dbadd70be3beb384369edfaaa25ffd93add7d77e53ea8de529db1257c1790c59.jpeg&width=100&checksum=sAXb97z3L0pp4XAbpSI1SWQM7b83YcXZMhXgE7vYWVw",
"medium": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/medias/dbadd70be3beb384369edfaaa25ffd93add7d77e53ea8de529db1257c1790c59.jpeg&width=250&checksum=GwZ6f8sDqeokie065qMMm1yiXenwXmYRIHeblDY_1JQ",
"large": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/medias/dbadd70be3beb384369edfaaa25ffd93add7d77e53ea8de529db1257c1790c59.jpeg&width=500&checksum=D71poeKyhdLCijG7dyO2hvDAy4QYDMZ830zyLe2IyFk",
"blurhash": "U57fry8wHX%zUHMIk@acD4yWI8RUUb%~%iQm",
"width": 1024,
"height": 1024,
"mimeType": "image/jpeg",
"fileSize": 874002
}
}
],
"pageInfo": {
"hasNextPage": false,
"endCursor": "MA=="
}
},
"animations": {
"edges": [],
"pageInfo": {
"hasNextPage": false,
"endCursor": null
}
},
"audios": {
"edges": []
}
},
"traits": [
{
"id": "789432960",
"attributeName": "Attack",
"attributeValue": "12",
"supply": "1090",
"supplyPercentage": 5.694879832810868
},
{
"id": "698025553",
"attributeName": "Rarity",
"attributeValue": "COMMON",
"supply": "17521",
"supplyPercentage": 91.54127481713688
},
{
"id": "698025567",
"attributeName": "Type",
"attributeValue": "MYTHIC",
"supply": "1776",
"supplyPercentage": 9.278996865203762
},
{
"id": "698025552",
"attributeName": "Chronicle",
"attributeValue": "1",
"supply": "17918",
"supplyPercentage": 93.61546499477534
},
{
"id": "698025554",
"attributeName": "Series",
"attributeValue": "1",
"supply": "17918",
"supplyPercentage": 93.61546499477534
},
{
"id": "834472731",
"attributeName": "Collection",
"attributeValue": "The Lost Lakes",
"supply": "3390",
"supplyPercentage": 17.711598746081506
},
{
"id": "783307638",
"attributeName": "Level",
"attributeValue": "1",
"supply": "7513",
"supplyPercentage": 39.252873563218394
},
{
"id": "789402602",
"attributeName": "Health",
"attributeValue": "104",
"supply": "78",
"supplyPercentage": 0.40752351097178685
},
{
"id": "789392387",
"attributeName": "Defense",
"attributeValue": "14",
"supply": "843",
"supplyPercentage": 4.4043887147335425
},
{
"id": "834495732",
"attributeName": "Name",
"attributeValue": "Thundrax",
"supply": "98",
"supplyPercentage": 0.5120167189132706
},
{
"id": "789418912",
"attributeName": "Speed",
"attributeValue": "11",
"supply": "983",
"supplyPercentage": 5.135841170323929
}
],
"lastSale": {
"valueUsd": 26.664810042596,
"valueWithDenomination": 0.0097400006,
"denomination": {
"network": "base",
"address": "0x0000000000000000000000000000000000000000",
"symbol": "ETH",
"imageUrl": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0x0000000000000000000000000000000000000000.png"
}
},
"transfers": {
"edges": [
{
"node": {
"timestamp": 1726061407,
"txHash": "0x0bc3cb95ee81acd2b482a5be4b7222f6d6eeb0c099faacc33e9ec0f521e8eaeb",
"payments": [
{
"tokenAddress": "0x0000000000000000000000000000000000000000",
"tokenSymbol": null,
"tokenValue": "0.0097400006",
"tokenValueETH": "0.0097400006",
"tokenValueUSD": "22.726493685145506"
}
]
},
"heldForInSeconds": 23510333
},
{
"node": {
"timestamp": 1719066949,
"txHash": "0x8b5933012484f61caf04780dec29389657ff3587da3b80d6d1513fe51f5cec0c",
"payments": []
},
"heldForInSeconds": 6994458
}
],
"pageInfo": {
"hasNextPage": true,
"endCursor": "MTcxOTA2Njk0OToyMjkxNzE5MzMy"
}
}
},
"cursor": "MTUwMzctMC4wMDk3NDAwMDA2LTAuMDA5NzQwMDAwNi1udWxsLTEwMzM4NjE1MjY="
}
],
"pageInfo": {
"hasNextPage": false,
"endCursor": "MTUwMzctMC4wMDk3NDAwMDA2LTAuMDA5NzQwMDAwNi1udWxsLTEwMzM4NjE1MjY="
}
}
}
]
}
}
Example Use Case: Holders
Paginated response of all the collection holders sorted in decending order from most held to least held.
Try it nowExample Query
query CollectionHolders($collections: [NftCollectionInputV2!]!) {
nftCollectionsV2(collections: $collections) {
# Basic collection metadata
id
name
network
address
nftStandard
supply
totalSupply
circulatingSupply
totalCirculatingSupply
holdersCount
# First 5 holders with identity information
holders(first: 5) {
totalCount
edges {
node {
account {
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
}
}
}
}
Example Response
{
"data": {
"nftCollectionsV2": [
{
"id": "TmZ0Q29sbGVjdGlvbi0yMDM3MTMyNQ==",
"name": "onchain gaias",
"network": "BASE_MAINNET",
"address": "0xa449b4f43d9a33fcdcf397b9cc7aa909012709fd",
"nftStandard": "ERC_721",
"supply": "5222",
"totalSupply": "5011",
"circulatingSupply": "5222",
"totalCirculatingSupply": "5011",
"holdersCount": "2426",
"holders": {
"totalCount": 2426,
"edges": [
{
"node": {
"account": {
"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": {
"account": {
"address": "0x3fd22c42cafa8f09df959c853f70f9ced8409967",
"displayName": {
"value": "0x3fd2...9967",
"source": "ADDRESS"
},
"farcasterProfile": null
},
"holdCount": "50",
"holdTotalCount": "50"
},
"cursor": "NTAtMTcyMDgyMDA1MA=="
},
{
"node": {
"account": {
"address": "0x72c3c8b0cacdf6e36b39c9462a42756b2a294ccb",
"displayName": {
"value": "basedandearly.eth",
"source": "ENS"
},
"farcasterProfile": null
},
"holdCount": "49",
"holdTotalCount": "49"
},
"cursor": "NDktMTcyMTE2MDU1Ng=="
},
{
"node": {
"account": {
"address": "0x03dd9d2ed090df41e149527a44922b55e7762d19",
"displayName": {
"value": "0x03dd...2d19",
"source": "ADDRESS"
},
"farcasterProfile": null
},
"holdCount": "45",
"holdTotalCount": "45"
},
"cursor": "NDUtMTcxNTc5NzM1MQ=="
},
{
"node": {
"account": {
"address": "0x3bfa05f792851a693a7b95baf6c1dc59c8fe42ac",
"displayName": {
"value": "0x3bfa...42ac",
"source": "ADDRESS"
},
"farcasterProfile": null
},
"holdCount": "42",
"holdTotalCount": "42"
},
"cursor": "NDItMTc5NzIxNTA0Mg=="
}
],
"pageInfo": {
"hasNextPage": true,
"endCursor": "NDItMTc5NzIxNTA0Mg=="
}
}
}
]
}
}
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 | [NftCollectionInputV2!]! | Yes |
NftCollectionInputV2
Field | Description | Type | Required |
---|---|---|---|
collectionAddress | The address of the NFT collection | String! | Yes |
chainId | The chain where the NFT exists | Int! | 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