NFT Collection Holdings

Get information about NFT collections owned by specific wallet addresses.

`nftUsersCollections`

Takes an array of addresses as input, with optional parameters for network, standard, and minCollectionValueUsd. It returns aggregated NFT collection data including:

Collections owned across addresses
Floor prices and valuations
Collection metadata and stats
Owner counts and volume
Social links and images

Example Use Case: User's NFT Portfolio

Let's say you want to display all NFT collections owned by a user or group of users. Start by passing the owners addresses you want to query. Then return details about each collection including its name, medias for displaying images, and current floorPrice. You can filter results by network or minimum value, and use pagination with first and after arguments to load results in batches.

Example Variables

{
  "owners": [
    "0x3d280fde2ddb59323c891cf30995e1862510342f", "0xc8f8e2f59dd95ff67c3d39109eca2e2a017d4c8a"],
  "network": "ETHEREUM_MAINNET",
  "first": 12
}

Example Query

query UserNftCollections(
  $owners: [Address!]!
  $network: Network
  $first: Int = 2
  $after: String
  $search: String
  $minCollectionValueUsd: Float
) {
  nftUsersCollections(
    owners: $owners
    network: $network
    first: $first
    after: $after
    search: $search
    minCollectionValueUsd: $minCollectionValueUsd
  ) {
    edges {
      node {
        # Basic collection metadata
        name
        description
        network
        address
        nftStandard
        type

        # Supply and holder metrics
        supply
        totalSupply
        circulatingSupply
        holdersCount

        # Market data
        marketCap
        floorPrice {
          valueUsd
          valueWithDenomination
          denomination {
            symbol
            network
            address
          }
        }
        topOfferPrice {
          valueUsd
          valueWithDenomination
          denomination {
            symbol
          }
        }

        # Media assets
        medias {
          banner {
            url
            original
            large
          }
          logo {
            url
            original
            thumbnail
          }
          card {
            url
            original
          }
        }

        # Community and social information
        socialLinks {
          name
          url
          label
          logoUrl
        }
      }

      # User-specific collection data
      balance # Number of NFTs the user holds from this collection
      balanceUSD # Total USD value of user's holdings in this collection
    }

    # Pagination information
    pageInfo {
      hasNextPage
      endCursor
      startCursor
      hasPreviousPage
    }
  }
}

Example Response

{
  "data": {
    "nftUsersCollections": {
      "edges": [
        {
          "node": {
            "name": "Opepen Edition",
            "description": "This artwork may or may not be handmade.",
            "network": "ETHEREUM_MAINNET",
            "address": "0x6339e5e072086621540d0362c4e3cea0d643e114",
            "nftStandard": "ERC_721",
            "type": "GENERAL",
            "supply": "16000",
            "totalSupply": "16000",
            "circulatingSupply": "15811",
            "holdersCount": "3748",
            "marketCap": "2212.90756",
            "floorPrice": {
              "valueUsd": 297.9608608973708,
              "valueWithDenomination": 0.13996,
              "denomination": {
                "symbol": "ETH",
                "network": "ethereum",
                "address": "0x0000000000000000000000000000000000000000"
              }
            },
            "topOfferPrice": {
              "valueUsd": 264.196504982593,
              "valueWithDenomination": 0.1241,
              "denomination": {
                "symbol": "ETH"
              }
            },
            "medias": {
              "banner": {
                "url": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0x6339e5e072086621540d0362c4e3cea0d643e114%2Fbanner.svg&checksum=35506",
                "original": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0x6339e5e072086621540d0362c4e3cea0d643e114%2Fbanner.svg&checksum=35506",
                "large": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0x6339e5e072086621540d0362c4e3cea0d643e114%2Fbanner.svg&width=500&checksum=336c3"
              },
              "logo": {
                "url": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0x6339e5e072086621540d0362c4e3cea0d643e114%2Flogo.png&checksum=0f7f6",
                "original": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0x6339e5e072086621540d0362c4e3cea0d643e114%2Flogo.png&checksum=0f7f6",
                "thumbnail": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0x6339e5e072086621540d0362c4e3cea0d643e114%2Flogo.png&width=100&checksum=7d14f"
              },
              "card": {
                "url": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0x6339e5e072086621540d0362c4e3cea0d643e114%2Fcard.svg&checksum=74180",
                "original": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0x6339e5e072086621540d0362c4e3cea0d643e114%2Fcard.svg&checksum=74180"
              }
            },
            "socialLinks": [
              {
                "name": "opensea",
                "url": "https://opensea.io/collection/opepen-edition",
                "label": "Opensea",
                "logoUrl": "https://storage.googleapis.com/zapper-fi-assets/logos/opensea.png"
              },
              {
                "name": "website",
                "url": "http://opepen.art",
                "label": "Website",
                "logoUrl": "https://storage.googleapis.com/zapper-fi-assets/logos/website.png"
              },
              {
                "name": "twitter",
                "url": "https://twitter.com/jackbutcher",
                "label": "Twitter",
                "logoUrl": "https://storage.googleapis.com/zapper-fi-assets/logos/twitter.png"
              }
            ]
          },
          "balance": 122,
          "balanceUSD": 82485.20217384
        },
        {
          "node": {
            "name": "CryptoPunks",
            "description": "CryptoPunks launched as a fixed set of 10,000 items in mid-2017 and became one of the inspirations for the ERC-721 standard. They have been featured in places like The New York Times, Christie’s of London, Art|Basel Miami, and The PBS NewsHour.",
            "network": "ETHEREUM_MAINNET",
            "address": "0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb",
            "nftStandard": "ERC_721",
            "type": "GENERAL",
            "supply": "10000",
            "totalSupply": "10000",
            "circulatingSupply": "9998",
            "holdersCount": "3906",
            "marketCap": "354929",
            "floorPrice": {
              "valueUsd": 75575.954285915,
              "valueWithDenomination": 35.5,
              "denomination": {
                "symbol": "ETH",
                "network": "ethereum",
                "address": "0x0000000000000000000000000000000000000000"
              }
            },
            "topOfferPrice": null,
            "medias": {
              "banner": {
                "url": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb%2Fbanner.png&checksum=0fade",
                "original": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb%2Fbanner.png&checksum=0fade",
                "large": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb%2Fbanner.png&width=500&checksum=3b086"
              },
              "logo": {
                "url": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb%2Flogo.png&checksum=cf0e4",
                "original": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb%2Flogo.png&checksum=cf0e4",
                "thumbnail": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb%2Flogo.png&width=100&checksum=d654e"
              },
              "card": {
                "url": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb%2Fcard.png&checksum=bc2f2",
                "original": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0xb47e3cd837ddf8e4c57f05d70ab865de6e193bbb%2Fcard.png&checksum=bc2f2"
              }
            },
            "socialLinks": [
              {
                "name": "opensea",
                "url": "https://opensea.io/collection/cryptopunks",
                "label": "Opensea",
                "logoUrl": "https://storage.googleapis.com/zapper-fi-assets/logos/opensea.png"
              },
              {
                "name": "website",
                "url": "https://cryptopunks.app/",
                "label": "Website",
                "logoUrl": "https://storage.googleapis.com/zapper-fi-assets/logos/website.png"
              },
              {
                "name": "discord",
                "url": "https://discord.gg/tQp4pSE",
                "label": "Discord",
                "logoUrl": "https://storage.googleapis.com/zapper-fi-assets/logos/discord.png"
              },
              {
                "name": "twitter",
                "url": "https://twitter.com/cryptopunksnfts",
                "label": "Twitter",
                "logoUrl": "https://storage.googleapis.com/zapper-fi-assets/logos/twitter.png"
              }
            ]
          },
          "balance": 1,
          "balanceUSD": 75788.87837823
        },
        {
          "node": {
            "name": "Life In West America by Roope Rainisto",
            "description": "Life In West America is a post-photography project investigating America: the land as a concept, as an ideal, and the stories of the people inhabiting the space. The collection combines the visual language of traditional photography with the limitless artifice of AI, capturing a moment in time and in generative technology. Each of the pieces is generated using custom-trained models specific to this project.",
            "network": "ETHEREUM_MAINNET",
            "address": "0xdfde78d2baec499fe18f2be74b6c287eed9511d7",
            "nftStandard": "ERC_721",
            "type": "BRAIN_DROPS",
            "supply": "500",
            "totalSupply": "500",
            "circulatingSupply": "500",
            "holdersCount": "286",
            "marketCap": "1750",
            "floorPrice": {
              "valueUsd": 7451.150422555,
              "valueWithDenomination": 3.5,
              "denomination": {
                "symbol": "ETH",
                "network": "ethereum",
                "address": "0x0000000000000000000000000000000000000000"
              }
            },
            "topOfferPrice": {
              "valueUsd": 5322.250301825,
              "valueWithDenomination": 2.5,
              "denomination": {
                "symbol": "ETH"
              }
            },
            "medias": {
              "banner": {
                "url": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0xdfde78d2baec499fe18f2be74b6c287eed9511d7%2F15_banner.png&checksum=faa47",
                "original": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0xdfde78d2baec499fe18f2be74b6c287eed9511d7%2F15_banner.png&checksum=faa47",
                "large": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0xdfde78d2baec499fe18f2be74b6c287eed9511d7%2F15_banner.png&width=500&checksum=82850"
              },
              "logo": {
                "url": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0xdfde78d2baec499fe18f2be74b6c287eed9511d7%2F15_logo.png&checksum=5ecad",
                "original": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0xdfde78d2baec499fe18f2be74b6c287eed9511d7%2F15_logo.png&checksum=5ecad",
                "thumbnail": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0xdfde78d2baec499fe18f2be74b6c287eed9511d7%2F15_logo.png&width=100&checksum=afad1"
              },
              "card": null
            },
            "socialLinks": [
              {
                "name": "opensea",
                "url": "https://opensea.io/collection/life-in-west-america-by-roope-rainisto",
                "label": "Opensea",
                "logoUrl": "https://storage.googleapis.com/zapper-fi-assets/logos/opensea.png"
              },
              {
                "name": "website",
                "url": "https://braindrops.cloud/",
                "label": "Website",
                "logoUrl": "https://storage.googleapis.com/zapper-fi-assets/logos/website.png"
              }
            ]
          },
          "balance": 3,
          "balanceUSD": 15950.925
        }
      ],
      "pageInfo": {
        "hasNextPage": true,
        "endCursor": "MTU5NTAuOTI1LTE3Mjg3MDM5",
        "startCursor": "ODI0ODUuMjAyMTczODQtNzU0OTQw",
        "hasPreviousPage": false
      }
    }
  }
}

Arguments

Argument	Description	Type	Required
`owners`	Array of addresses to query collections for	`[Address!]!`	Yes
`network`	Filter collections by specific network	`Network`	No
`minCollectionValueUsd`	Minimum USD value threshold for collections	`Float`	No
`search`	Search string to filter collections	`String`	No
`collectionIds`	Array of specific collection IDs to include	`[ID!]`	No
`standard`	Filter by NFT standard (ERC721/ERC1155)	`NftStandard`	No
`onlyHidden`	Show only hidden collections	`Boolean`	No
`first`	Number of collections to return (default: 24)	`Int`	No
`after`	Cursor for pagination	`String`	No
`withOverrides`	Include value overrides	`Boolean`	No

Fields

Field	Description	Type
`edges`	Array of collection edges	`[NftUserCollectionEdge!]!`
`pageInfo`	Pagination information	`PageInfo!`
`node`	Collection information	`NftCollection!`
`cursor`	Pagination cursor	`String!`

Fields in NftUserCollectionConnection

Field	Description	Type
`edges`	Array of collection edges	`[NftUserCollectionEdge!]!`
`pageInfo`	Pagination information	`PageInfo!`

Fields in NftCollection (node)

Field	Description	Type
`id`	Unique identifier	`ID!`
`address`	Collection contract address	`Address!`
`subCollectionIdentifier`	Sub-collection identifier	`String!`
`name`	Collection name	`String!`
`displayName`	Display name	`String`
`symbol`	Collection symbol	`String!`
`description`	Collection description	`String!`
`network`	Blockchain network	`Network!`
`socialLinks`	Social media links	`[SocialLink!]!`
`supply`	Current supply	`BigDecimal!`
`totalSupply`	Total supply	`BigDecimal!`
`holdersCount`	Number of holders	`BigDecimal!`
`nftStandard`	NFT standard (ERC721/1155)	`NftStandard!`
`disabled`	Collection disabled status	`Boolean!`
`type`	Collection type	`NftCollectionType!`
`openseaId`	OpenSea identifier	`String`
`spamScore`	Spam risk score	`BigDecimal`
`floorPrice`	Current floor price	`NftValueDenomination`
`topOfferPrice`	Highest current offer	`NftValueDenomination`
`medias`	Collection media assets	`NftCollectionMedias!`
`circulatingSupply`	Circulating supply	`BigDecimal!`
`totalCirculatingSupply`	Total circulating supply	`BigDecimal!`
`marketCap`	Market capitalization	`BigDecimal`
`groups`	Collection groups	`[NftCollectionGroup!]!`

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 NftPaymentStatsPeriod {
  Week
  Month
  Quarter
}

enum NftTokenSort {
  RARITY_RANK
  LAST_SALE_ETH
  ESTIMATED_VALUE_ETH
}

Notes

Supports pagination for handling large collections
Filter by network, value, and NFT standard
Returns comprehensive collection metadata including floor prices and media
Includes social links and collection statistics

nftUsersCollections​

Example Use Case: User's NFT Portfolio​

Example Variables​

Example Query​

Example Response​

Arguments​

Fields​

Fields in NftUserCollectionConnection​

Fields in NftCollection (node)​

Enums​

Notes​