Collections By Owner

Query NFT collections owned by specific addresses across multiple networks, with comprehensive collection information and pagination support.

Try it now

nftCollectionsForOwners

Takes an input object with owners (array of addresses), networks, and pagination parameters. It returns a connection of NFT collections that are owned by the specified addresses, including:

• Collection metadata (name, symbol, description)
• Network information
• Supply and holder statistics
• Floor price data
• Social links
• Media/image assets

Example Use Case: User Portfolio

Let's say you want to display all NFT collections owned by a specific address or group of addresses. This can be useful for showing which NFTs a user has created for example. Pass the owners addresses to query, specify which networks to include, and use pagination with first and after arguments to handle results in batches.

Example Variables

{
  "owners": ["0x3d280fde2ddb59323c891cf30995e1862510342f"],
  "networks": ["ETHEREUM_MAINNET"],
  "first": 5
}

Example Query

query OwnerCollections($owners: [Address!], $networks: [Network!]!, $first: Int, $after: String) {
  nftCollectionsForOwners(input: { owners: $owners, networks: $networks, first: $first, after: $after }) {
    edges {
      node {
        # Basic collection information
        id
        address
        name
        symbol
        description
        network
        nftStandard
        type

        # Statistics
        supply
        totalSupply
        holdersCount
        circulatingSupply

        # Floor price information
        floorPrice {
          valueUsd
          valueWithDenomination
          denomination {
            symbol
            network
            address
          }
        }

        # Media assets
        medias {
          logo {
            blurhash
            height
            width
            fileSize
            original
            thumbnail
            medium
            large

          }
          banner {
            blurhash
            height
            width
            fileSize
            original
            thumbnail
            medium
            large
          }
        }

        # Social links
        socialLinks {
          name
          label
          url
          logoUrl
        }
      }
    }

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

Example Response

{
  "data": {
    "nftCollectionsForOwners": {
      "edges": [
        {
          "node": {
            "id": "TmZ0Q29sbGVjdGlvbi0yMDU2MDcyMg==",
            "address": "0x10a2b552cb9847605db390afd1ad66158d77c4e2",
            "name": "The Workshop",
            "symbol": "SHOP",
            "description": "",
            "network": "ETHEREUM_MAINNET",
            "nftStandard": "ERC_721",
            "type": "GENERAL",
            "supply": "2",
            "totalSupply": "2",
            "holdersCount": "2",
            "circulatingSupply": "2",
            "floorPrice": null,
            "medias": {
              "logo": {
                "blurhash": "U01okJv$56BPM|X7t7wzQ.S#tkjGKgWB#Us:",
                "height": 244,
                "width": 512,
                "fileSize": 21760,
                "original": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0x10a2b552cb9847605db390afd1ad66158d77c4e2%2Flogo.png&checksum=1b2ec",
                "thumbnail": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0x10a2b552cb9847605db390afd1ad66158d77c4e2%2Flogo.png&width=100&checksum=1a8d1",
                "medium": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0x10a2b552cb9847605db390afd1ad66158d77c4e2%2Flogo.png&width=250&checksum=38f56",
                "large": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0x10a2b552cb9847605db390afd1ad66158d77c4e2%2Flogo.png&width=500&checksum=8759c"
              },
              "banner": {
                "blurhash": "U01e|bv~9ZFsM|X7t6wfQ.X7tRe:KgWB#Ts:",
                "height": 1070,
                "width": 2250,
                "fileSize": 131471,
                "original": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0x10a2b552cb9847605db390afd1ad66158d77c4e2%2Fbanner.png&checksum=2b7fa",
                "thumbnail": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0x10a2b552cb9847605db390afd1ad66158d77c4e2%2Fbanner.png&width=100&checksum=32b59",
                "medium": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0x10a2b552cb9847605db390afd1ad66158d77c4e2%2Fbanner.png&width=250&checksum=5aa9b",
                "large": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0x10a2b552cb9847605db390afd1ad66158d77c4e2%2Fbanner.png&width=500&checksum=ab8b3"
              }
            },
            "socialLinks": [
              {
                "name": "opensea",
                "label": "Opensea",
                "url": "https://opensea.io/collection/the-workshop",
                "logoUrl": "https://storage.googleapis.com/zapper-fi-assets/logos/opensea.png"
              }
            ]
          }
        }
      ],
      "pageInfo": {
        "hasNextPage": true,
        "endCursor": "ZXRoZXJldW0tMjA1NjA3MjI=",
        "startCursor": "ZXRoZXJldW0tMjA1NjA3MjI=",
        "hasPreviousPage": false
      }
    }
  }
}

---

Arguments

Argument	Description	Type	Required
input	Input object for the query	NftCollectionsForOwnersInput!	Yes

NftCollectionsForOwnersInput

Field	Description	Type	Required
owners	Array of owner addresses to query	[Address!]	Yes
networks	Networks to include in the search	[Network!]!	Yes
first	Number of collections to return	Int	No
after	Cursor for pagination	String	No

Fields

NftCollectionsForOwnersCollectionsConnection

Field	Description	Type
edges	Array of collection edges	[NftCollectionEdge!]!
pageInfo	Pagination information	PageInfo!
totalCount	Total number of collections	Int!

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 (if different)	String
symbol	Collection symbol	String!
description	Collection description	String!
network	Network the collection is on	Network!
deployer	Address that deployed the contract	Address!
socialLinks	Social media links	[SocialLink!]!
supply	Current supply	BigDecimal!
totalSupply	Total possible supply	BigDecimal!
circulatingSupply	Tokens in circulation	BigDecimal!
totalCirculatingSupply	Total circulating supply	BigDecimal!
holdersCount	Number of unique holders	BigDecimal!
nftStandard	NFT standard (ERC721/ERC1155)	NftStandard!
type	Collection type	NftCollectionType!
floorPrice	Current floor price	NftValueDenomination
topOfferPrice	Top offer price	NftValueDenomination
medias	Collection media assets	NftCollectionMedias!
disabled	Whether collection is disabled	Boolean!
spamScore	Spam score	BigDecimal
marketCap	Estimated market cap	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
}

Notes

• Use this query to discover all collections owned by specific addresses
• Filter by multiple networks simultaneously for cross-chain portfolios
• Returns comprehensive collection metadata and statistics
• Includes floor price data where available
• Supports pagination for browsing large collection portfolios