Skip to main content

NFT Collection Details

Surfaces information about any ERC721 or ERC1155 NFT collection.

Try it now

nftCollections

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

ArgumentDescriptionTypeRequired
collectionsArray of inputs specifying collection details[NftCollectionInput!]!Yes

NftCollectionInput

FieldDescriptionTypeRequired
collectionAddressThe address of the NFT collectionString!Yes
networkThe network where the NFT existsNetwork!Yes
subCollectionIdentifierIdentifier for a sub-collectionStringNo

Fields

FieldDescriptionType
idUnique identifier for the collectionID!
addressContract address of the collectionAddress!
subCollectionIdentifierIdentifier for sub-collectionString!
nameName of the collectionString!
displayNameDisplay name of the collectionString
symbolSymbol/ticker of the collectionString!
descriptionDescription of the collectionString!
networkNetwork where the collection existsNetwork!
socialLinksArray of social media links[SocialLink!]!
supplyTotal supply of the collectionBigDecimal!
totalSupplyTotal supply including burned tokensBigDecimal!
floorPriceEthFloor price in ETH (deprecated)BigDecimal
floorPriceSourceMarketPlaceSource marketplace for floor priceNftDataSourceMarketplace
topOfferPriceEthTop offer in ETH (deprecated)BigDecimal
topOfferSourceMarketPlaceSource marketplace for top offerNftDataSourceMarketplace
holdersCountNumber of unique holdersBigDecimal!
nftStandardToken standardNftStandard!
disabledWhether the collection is disabledBoolean!
typeType of collectionNftCollectionType!
openseaIdOpenSea identifierString
spamScoreSpam score of the collectionBigDecimal
floorPriceCurrent floor priceNftValueDenomination
topOfferPriceHighest current offerNftValueDenomination
isApprovedCheck if collection is approved for a spender(spenderAddress: Address!, ownerAddress: Address!) => Boolean!
approvalTransactionGet transaction config for approval(spenderAddress: Address!, ownerAddress: Address!) => TransactionConfig!
revokeApprovalTransactionGet transaction config for revoking approval(spenderAddress: Address!, ownerAddress: Address!) => TransactionConfig!
nftsList of NFTs in the collectionNftTokenConnection!
eventsCollection events (sales, transfers)CollectionEventConnection!
traitGroupsGroups of traits for the collection[NftCollectionTraitGroupBase!]!
traitGroupValuesValues for trait groupsNftCollectionTraitValueConnection!
traitsCollection traits[NftCollectionTraitType!]!
holdersCollection holdersPaginatedNftHolder!
mediasCollection media assetsNftCollectionMedias!
circulatingSupplyNumber of tokens in circulationBigDecimal!
totalCirculatingSupplyTotal circulating supplyBigDecimal!
groupsCollection groups information[NftCollectionGroup!]!
marketCapMarket capitalizationBigDecimal

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