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

Try it now

`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 now

Example 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 now

Example Query

query NFTsByCollection($collections: [NftCollectionInputV2!]!) {
  nftCollectionsV2(collections: $collections) {
    # Basic collection metadata
    id
    name
    description
    network
    address
    nftStandard
    supply
    totalSupply
    circulatingSupply
    totalCirculatingSupply
    holdersCount

    # 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
      }
    }
  }
}

Example Response

{
  "data": {
    "nftCollectionsV2": [
      {
        "id": "TmZ0Q29sbGVjdGlvbi0yNjU4MQ==",
        "name": "LilPudgys",
        "description": "Lil Pudgys is a collection of 22,222 NFTs originating from Pudgy Penguins. Don’t let their small stature fool you, Lil Pudgys are an integral piece of the Pudgy Penguins history. Their story began during the most frigid of winters. In the midst of adversity, the birth of the Lil Pudgys helped spark new-life into the Pudgy Penguins community. \r\n\r\nWith their unique traits and personalities, there’s a Lil Pudgy for everyone. Lil Pudgy holders receive exclusive access to experiences, events, IP licensing opportunities and more. \r\n\r\nPudgy Collections:\r\n[Pudgy Penguins](https://opensea.io/collection/pudgypenguins) | [Pudgy Rods](https://opensea.io/collection/pudgyrods)\r\n\r\nCrosschain Lil Pudgys:\r\n[Bridge](https://bridge.pudgypenguins.com) | [Polygon](https://opensea.io/collection//lilpudgys-polygon) | [Binance](https://opensea.io/collection//lilpudgys-binance) | [Arbitrum](https://opensea.io/collection//lilpudgys-arbitrum)",
        "network": "ETHEREUM_MAINNET",
        "address": "0x524cab2ec69124574082676e6f654a18df49a048",
        "nftStandard": "ERC_721",
        "supply": "21907",
        "totalSupply": "21907",
        "circulatingSupply": "21907",
        "totalCirculatingSupply": "21907",
        "holdersCount": "10012",
        "nfts": {
          "edges": [
            {
              "node": {
                "id": "TmZ0VG9rZW4tNjIzMTM5MTc=",
                "tokenId": "11822",
                "name": "Lil Pudgy #11822",
                "description": "Lil Pudgys are a collection of 22,222 randomly generated NFTs minted on Ethereum.",
                "holdersCount": "1",
                "supply": "1",
                "circulatingSupply": "1",
                "mediasV3": {
                  "images": {
                    "edges": [
                      {
                        "node": {
                          "original": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/medias/a3fc967ef0daffa655dc408e6072d94c5f22383377520a170134d12d7ad5d720.png&checksum=Ij-zIafUcbcbM3P6VvAUrhcNdMJXmFpUObk-xUbUQmY",
                          "thumbnail": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/medias/a3fc967ef0daffa655dc408e6072d94c5f22383377520a170134d12d7ad5d720.png&width=100&checksum=-4mzE0IpQ5ByhRu2-SP2AeH5FJl5mzzyTprip-h0sGA",
                          "medium": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/medias/a3fc967ef0daffa655dc408e6072d94c5f22383377520a170134d12d7ad5d720.png&width=250&checksum=QLDoVTdmpc9bpnx41dq01DE89p2RwXwTdIgalYS5y6g",
                          "large": "https://images.zapper.xyz/z/?path=zapper-fi-assets/nfts/medias/a3fc967ef0daffa655dc408e6072d94c5f22383377520a170134d12d7ad5d720.png&width=500&checksum=thqgjRXHg2wFtpPZnuiQrRJA_r5edF_z--y6eKILzIM",
                          "blurhash": "UBNacK=^y|:__enVLUXLD*V|-qxo_MouM1V{",
                          "width": 2700,
                          "height": 2700,
                          "mimeType": "image/png",
                          "fileSize": 200717
                        }
                      }
                    ],
                    "pageInfo": {
                      "hasNextPage": false,
                      "endCursor": "MA=="
                    }
                  },
                  "animations": {
                    "edges": [],
                    "pageInfo": {
                      "hasNextPage": false,
                      "endCursor": null
                    }
                  },
                  "audios": {
                    "edges": []
                  }
                },
                "traits": [
                  {
                    "id": "12212240",
                    "attributeName": "Head",
                    "attributeValue": "None",
                    "supply": "1696",
                    "supplyPercentage": 7.741817683845346
                  },
                  {
                    "id": "5219216",
                    "attributeName": "Skin",
                    "attributeValue": "Mint",
                    "supply": "3087",
                    "supplyPercentage": 14.091386314876523
                  },
                  {
                    "id": "5698822",
                    "attributeName": "Body",
                    "attributeValue": "Puffer Green",
                    "supply": "365",
                    "supplyPercentage": 1.6661341123841695
                  },
                  {
                    "id": "4430399",
                    "attributeName": "Left Flipper",
                    "attributeValue": "None",
                    "supply": "39543",
                    "supplyPercentage": 180.5039485096088
                  },
                  {
                    "id": "12238396",
                    "attributeName": "Right Flipper",
                    "attributeValue": "Surfboard Tan",
                    "supply": "462",
                    "supplyPercentage": 2.1089149586890037
                  },
                  {
                    "id": "4783609",
                    "attributeName": "Background",
                    "attributeValue": "Pink",
                    "supply": "6101",
                    "supplyPercentage": 27.849545807276215
                  },
                  {
                    "id": "4784126",
                    "attributeName": "Face",
                    "attributeValue": "Cute",
                    "supply": "7851",
                    "supplyPercentage": 35.83786004473456
                  }
                ],
                "estimatedValue": {
                  "valueUsd": 2900.362941737231,
                  "valueWithDenomination": 1.5540370698799753,
                  "denomination": {
                    "network": "ethereum",
                    "address": "0x0000000000000000000000000000000000000000",
                    "symbol": "ETH",
                    "imageUrl": "https://storage.googleapis.com/zapper-fi-assets/tokens/ethereum/0x0000000000000000000000000000000000000000.png"
                  }
                },
                "lastSale": null,
                "transfers": {
                  "edges": [
                    {
                      "node": {
                        "timestamp": 1745360951,
                        "txHash": "0x171db8116fab0eab6ca3e80a35f5ea9c923c6f01d3fe5f8bd2e58a54bb72e5db",
                        "payments": []
                      },
                      "heldForInSeconds": 756495
                    },
                    {
                      "node": {
                        "timestamp": 1743727703,
                        "txHash": "0xf1abcf6ab91996c2eebac57d303dc775cd8da286940ed55ef803a8b129e4fd52",
                        "payments": []
                      },
                      "heldForInSeconds": 1633248
                    }
                  ],
                  "pageInfo": {
                    "hasNextPage": true,
                    "endCursor": "MTc0MzcyNzcwMzozMjk3MDIzNzUz"
                  }
                }
              },
              "cursor": "MTE4MjItbnVsbC0xLjU1NDAzNzA2OTg3OTk3NTMtMS02MjMxMzkxNw=="
            }
          ],
          "pageInfo": {
            "hasNextPage": true,
            "endCursor": "MTE4MjItbnVsbC0xLjU1NDAzNzA2OTg3OTk3NTMtMS02MjMxMzkxNw=="
          }
        }
      }
    ]
  }
}

Example Use Case: Holders

Paginated response of all the collection holders sorted in decending order from most held to least held.

Try it now

Example 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

nftCollectionsV2​

Example Use Case: Collection Details​

Variables​

Example Query​

Example Response​

Example Use Case: Collection Transfers​

Example Query​

Example Response​

Example Use Case: Collection NFTs​

Example Query​

Example Response​

Example Use Case: Holders​

Example Query​

Example Response​

Rich filtering options​

Arguments​

NftCollectionInputV2​

Fields​

Enums​

Notes​

`nftCollectionsV2`

Example Use Case: Collection Details

Variables

Example Query

Example Response

Example Use Case: Collection Transfers

Example Query

Example Response

Example Use Case: Collection NFTs

Example Query

Example Response

Example Use Case: Holders

Example Query

Example Response

Rich filtering options

Arguments

NftCollectionInputV2

Fields

Enums

Notes