Legacy Queries & Mutations

Note

The following queries have been deprecated and may become inaccessible in the future. For guidance on which alternative queries to use instead, please refer to each deprecated query's deprecation description in the API Schema or Sandbox.

Personalized token discovery based on the Farcaster social graph.

`tokenTrends`

The tokenTrends endpoint produces an algorithmically ranked token feed based on swap activity and velocity of adoption across a user's network - updating in real-time as onchain activity happens. Similar to how a traditional content feed refreshes when friends post, this delivers a fresh stream of relevant tokens as their social graph interacts onchain.

Test query in sandbox

Variables

{
  "fid": 177,
  "first": 5,
}

note

Each feed is tailored to a given account using the fid parameter.

Example Query

query TokenTrends($fid: Int!, $first: Int) {
  tokenTrends(fid: $fid, first: $first) {
    edges {
      node {
        # Token Metadata
        tokenAddress
        chainId
        token {
          name
          symbol
          imageUrlV2
          decimals
          # Price & Market Data
          priceData {
            price
            priceChange24h
            volume24h
            marketCap
            # Swaps by followed accounts (if any)
            latestRelevantFarcasterSwaps(fid: $fid, first: 1) {
              edges {
                node {
                  timestamp
                  volumeUsd
                  amount
                  isBuy
                  profile {
                    username
                    fid
                    metadata {
                      displayName
                      imageUrl
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}

tip

Increase feed engagement by surfacing the swaps made by accounts that a user follows by returning latestRelevantFarcasterSwaps.

Example Response

{
  "data": {
    "tokenTrends": {
      "edges": [
        {
          "node": {
            "tokenAddress": "0x5ba8d32579a4497c12d327289a103c3ad5b64eb1",
            "chainId": 8453,
            "token": {
              "name": "Tipn",
              "symbol": "TIPN",
              "imageUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0x5ba8d32579a4497c12d327289a103c3ad5b64eb1.png",
              "decimals": 18,
              "priceData": {
                "price": 0.0005557188721959456,
                "priceChange24h": 15.991171767436763,
                "volume24h": 227291.734375,
                "marketCap": 555718.8721959456,
                "latestRelevantFarcasterSwaps": {
                  "edges": [
                    {
                      "node": {
                        "timestamp": 1750866271000,
                        "volumeUsd": 4.6370152602404335,
                        "amount": 9775.532455295443,
                        "isBuy": true,
                        "profile": {
                          "username": "squirtle0x.eth",
                          "fid": 4022,
                          "metadata": {
                            "displayName": "Squirtle0x",
                            "imageUrl": "https://i.imgur.com/O7W7iUL.jpg"
                          }
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        {
          "node": {
            "tokenAddress": "0x9cb41fd9dc6891bae8187029461bfaadf6cc0c69",
            "chainId": 8453,
            "token": {
              "name": "noice",
              "symbol": "noice",
              "imageUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0x9cb41fd9dc6891bae8187029461bfaadf6cc0c69.png",
              "decimals": 18,
              "priceData": {
                "price": 0.000059008100327634114,
                "priceChange24h": 0.8789355375560026,
                "volume24h": 232034.8125,
                "marketCap": 5900810.032763411,
                "latestRelevantFarcasterSwaps": {
                  "edges": [
                    {
                      "node": {
                        "timestamp": 1750960005000,
                        "volumeUsd": 24.017783639665403,
                        "amount": 379541.4507747071,
                        "isBuy": true,
                        "profile": {
                          "username": "baseddesigner.eth",
                          "fid": 196957,
                          "metadata": {
                            "displayName": "max ↑",
                            "imageUrl": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/5df27ed5-a866-4a1d-765e-c756f11aae00/rectcrop3"
                          }
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        },
        {
          "node": {
            "tokenAddress": "0x2da56acb9ea78330f947bd57c54119debda7af71",
            "chainId": 8453,
            "token": {
              "name": "Mog Coin",
              "symbol": "Mog",
              "imageUrlV2": "https://storage.googleapis.com/zapper-fi-assets/tokens/base/0x2da56acb9ea78330f947bd57c54119debda7af71.png",
              "decimals": 18,
              "priceData": {
                "price": 9.069044510568329e-7,
                "priceChange24h": -3.8561894476643377,
                "volume24h": 171638.59375,
                "marketCap": 0,
                "latestRelevantFarcasterSwaps": {
                  "edges": [
                    {
                      "node": {
                        "timestamp": 1750837045000,
                        "volumeUsd": 0.9902968287564057,
                        "amount": 1019834.8820828298,
                        "isBuy": true,
                        "profile": {
                          "username": "terricola.eth",
                          "fid": 21024,
                          "metadata": {
                            "displayName": "terricola",
                            "imageUrl": "https://imagedelivery.net/BXluQx4ige9GuW0Ia56BHw/2d5e2463-6a1b-4973-c808-3ec0b0eb8300/original"
                          }
                        }
                      }
                    }
                  ]
                }
              }
            }
          }
        }
      ]
    }
  }
}

Balance Computation

Legacy portfolio query only

Token and app balances no longer require prior computation on the new portfolioV2 query. This updated endpoint eliminates the need for separate balance computation jobs and provides enhanced functionality. The original portfolio query will continue to require computation jobs but we recommend migrating to portfolioV2.

computeTokenBalances

Initiates a job to compute token balances for a wallet.

The input type for both mutations is PortfolioInput:

input PortfolioInput {
  """
  The wallet addresses for which to fetch balances
  """
  addresses: [Address!]!
  """
  The networks for which to fetch balances
  """
  networks: [Network!]
  """
  The app slugs for which to fetch balances
  """
  appIds: [String!]
  flagAsStale: Boolean
}

Example Variables

{
  "input": {
    "addresses": ["Habp5bncMSsBC3vkChyebepym5dcTNRYeg2LVG464E96"],
    "networks": ["BITCOIN_MAINNET", "SOLANA_MAINNET"]
  }
}

Example Mutation

mutation ComputeTokenBalances($input: PortfolioInput!) {
  computeTokenBalances(input: $input) {
    jobId
  }
}

Example Response

{
  "data": {
    "computeTokenBalances": {
      "jobId": "38b53084-9e84-46fd-a5fc-e7463baba936"
    }
  }
}

computeAppBalances

Initiates a job to compute app balances for a wallet.

Example Variables

{
  "input": {
    "addresses": [
      "0x123...", // EVM address being tracked for first time
      "Habp5bncMSsBC3vkChyebepym5dcTNRYeg2LVG464E96" // Solana address
    ],
    "networks": ["ETHEREUM_MAINNET", "SOLANA_MAINNET"]
  }
}

Example Mutation

mutation ComputeAppBalances($input: PortfolioInput!) {
  computeAppBalances(input: $input) {
    jobId
  }
}

Example Response

{
  "data": {
    "computeAppBalances": {
      "jobId": "176d50a0-c42b-49b1-a263-c1c4a63d8a3c"
    }
  }
}

balanceJobStatus

Query the status of a balance computation job.

Example Variables

{
  "jobId": "176d50a0-c42b-49b1-a263-c1c4a63d8a3c"
}

Example Query

query BalanceJobStatus($jobId: String!) {
  balanceJobStatus(jobId: $jobId) {
    jobId
    status
  }
}

Example Response

{
  "data": {
    "balanceJobStatus": {
      "jobId": "176d50a0-c42b-49b1-a263-c1c4a63d8a3c",
      "status": "completed"
    }
  }
}

Response Fields

Field	Description	Type
`jobId`	Unique identifier for the computation job	`ID!`
`status`	Current status of the job	`String!`

`fungibleTokenBatch`

Takes an array of token inputs (address and network pairs) and returns detailed information for multiple tokens in a single request. Returns the same data structure as fungibleToken but for multiple tokens at once.

Example Variables

{
  "tokens": [
    {
      "address": "0xcbb7c0000ab88b473b1f5afd9ef808440eed33bf",
      "network": "BASE_MAINNET"
    },
    {
      "address": "0x7fc66500c84a76ad7e9c93437bfc5ac33e2ddae9",
      "network": "ETHEREUM_MAINNET"
    },
    {
      "address": "0x00ef6220b7e28e890a5a265d82589e072564cc57",
      "network": "BASE_MAINNET"
    }
  ]
}

Arguments

Argument	Description	Type	Required
`address`	Token contract address	`Address!`	Yes
`network`	Network where the token exists	`Network!`	Yes
`currency`	Price currency (USD/ETH/BTC)	`Currency!`	Yes
`timeFrame`	Time interval for price data	`TimeFrame!`	Yes
`first`	Number of holders to fetch	`Float!`	Yes

Fields

Field	Description	Type
`id`	Unique identifier for the token	`ID!`
`address`	Contract address	`Address!`
`name`	Token name	`String!`
`symbol`	Token symbol	`String!`
`decimals`	Number of decimals	`Int!`
`totalSupply`	Total supply of the token	`String`
`credibility`	Token credibility score	`Float`
`rank`	Token rank	`Int`
`securityRisk`	Security risk assessment	`FungibleTokenSecurityRisk`
`isHoldersSupported`	Whether holder data is available	`Boolean!`
`imageUrl`	Token logo URL	`String!`
`priceData`	Detailed onchain market data	`PriceData`
`isVerified`	Token verification status	`Boolean!`

priceData Fields

Field	Description	Type
`price`	Current token price	`Float!`
`marketCap`	Market capitalization	`Float`
`totalLiquidity`	Total liquidity across all pairs	`Float!`
`totalGasTokenLiquidity`	Native token liquidity	`Float!`
`priceChange5m`	5-minute price change percentage	`Float`
`priceChange1h`	1-hour price change percentage	`Float`
`priceChange24h`	24-hour price change percentage	`Float`
`priceTicks`	Historical price data points	`[PriceTick!]!`
`historicalPrice`	Price at a given timestamp	`[HistoricalPrice!]!`

Enums

enum TimeFrame {
  HOUR
  DAY
  WEEK
  MONTH
  YEAR
}

enum Currency {
  USD
  EUR
  GBP
  CAD
  CNY
  KRW
  JPY
  RUB
  AUD
  NZD
  CHF
  SGD
  INR
  BRL
  ETH
  BTC
  HKD
  SEK
  NOK
  MXN
  TRY
}

NFT Holdings

Query individual NFTs owned by specific addresses, with detailed token information and filtering capabilities.

Test query in sandbox

`nftUsersTokens`

Takes an array of addresses as input, with optional parameters for network, standard, and minEstimatedValueUsd. It returns comprehensive NFT holdings data including:

Individual NFT tokens owned
Balance and quantity information
Collection metadata
Current valuations
Ownership history
Media/trait details

Example Use Case: User's NFT Gallery

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

note

If you notice some NFTs are not returned, this is likely due to Zapper's internal spam detection — which is conservative and enabled by default. To bypass this and get all NFTs, set bypassHidden to true .

Example Variables

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

Example Query

query UserNftTokens(
  $owners: [Address!]!
  $network: Network
  $first: Int = 24
  $after: String
  $search: String
  $minEstimatedValueUsd: Float
) {
  nftUsersTokens(
    owners: $owners
    network: $network
    first: $first
    after: $after
    search: $search
    minEstimatedValueUsd: $minEstimatedValueUsd
  ) {
    edges {
      node {
        # Basic token information
        tokenId
        name
        description

        # Collection information
        collection {
          name
          address
          network
          nftStandard
          type
          supply
          holdersCount
          floorPrice {
            valueUsd
            valueWithDenomination
            denomination {
              symbol
              network
              address
            }
          }
          medias {
            logo {
              thumbnail
            }
          }
        }

        # Media assets
        mediasV3 {
          images(first: 3) {
            edges {
              node {
                original
                thumbnail
                blurhash
                large
                width
                height
                mimeType
                fileSize
              }
            }
          }
          animations(first: 1) {
            edges {
              node {
                original
                mimeType
              }
            }
          }
        }

        # Value and pricing information
        estimatedValue {
          valueUsd
          valueWithDenomination
          denomination {
            symbol
            network
          }
        }
        lastSale {
          valueUsd
          valueWithDenomination
          denomination {
            symbol
          }
        }

        # Traits/attributes
        traits {
          attributeName
          attributeValue
          supplyPercentage
          supply
        }
      }

      # Ownership information
      balance
      balanceUSD
      ownedAt
      balances {
        balance
        account {
          address
          displayName {
            value
          }
        }
      }

      # Valuation strategy information
      valuationStrategy
    }

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

Example Response

{
  "data": {
    "nftUsersTokens": {
      "edges": [
        {
          "node": {
            "tokenId": "10407",
            "name": "Lil Pudgy #10407",
            "description": "Lil Pudgys are a collection of 22,222 randomly generated NFTs minted on Ethereum.",
            "collection": {
              "name": "LilPudgys",
              "address": "0x524cab2ec69124574082676e6f654a18df49a048",
              "network": "ETHEREUM_MAINNET",
              "nftStandard": "ERC_721",
              "type": "GENERAL",
              "supply": "21904",
              "holdersCount": "9973",
              "floorPrice": {
                "valueUsd": 1766.4198588442998,
                "valueWithDenomination": 0.94242,
                "denomination": {
                  "symbol": "ETH",
                  "network": "ethereum",
                  "address": "0x0000000000000000000000000000000000000000"
                }
              },
              "medias": {
                "logo": {
                  "thumbnail": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fcollections%2Fethereum%2F0x524cab2ec69124574082676e6f654a18df49a048%2Flogo.png&width=100&checksum=2ec79"
                }
              }
            },
            "mediasV3": {
              "images": {
                "edges": [
                  {
                    "node": {
                      "original": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fmedias%2Ffa856d9f7907ea90f93067a80cfe2a84be04242e834306ddcbe25876438a8684.png&checksum=9b5f8",
                      "thumbnail": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fmedias%2Ffa856d9f7907ea90f93067a80cfe2a84be04242e834306ddcbe25876438a8684.png&width=100&checksum=dd923",
                      "blurhash": "UPQ4c{$j_$+^{0n%CRX8s;jtS0bFtlbHv#n%",
                      "large": "https://zapper.xyz/z/images/?url=https%3A%2F%2Fstorage.googleapis.com%2Fzapper-fi-assets%2Fnfts%2Fmedias%2Ffa856d9f7907ea90f93067a80cfe2a84be04242e834306ddcbe25876438a8684.png&width=500&checksum=1d489",
                      "width": 2700,
                      "height": 2700,
                      "mimeType": "image/png",
                      "fileSize": 181886
                    }
                  }
                ]
              },
              "animations": {
                "edges": []
              }
            },
            "estimatedValue": {
              "valueUsd": 2043.0356381871,
              "valueWithDenomination": 1.09,
              "denomination": {
                "symbol": "ETH",
                "network": "ethereum"
              }
            },
            "lastSale": {
              "valueUsd": 29.98951395504,
              "valueWithDenomination": 0.016,
              "denomination": {
                "symbol": "ETH"
              }
            },
            "traits": [
              {
                "attributeName": "Skin",
                "attributeValue": "Volcanic Tan",
                "supplyPercentage": 7.213294375456537,
                "supply": "1580"
              },
              {
                "attributeName": "Right Flipper",
                "attributeValue": "None",
                "supplyPercentage": 127.9309715120526,
                "supply": "28022"
              },
              {
                "attributeName": "Background",
                "attributeValue": "Red",
                "supplyPercentage": 16.50383491599708,
                "supply": "3615"
              },
              {
                "attributeName": "Left Flipper",
                "attributeValue": "None",
                "supplyPercentage": 180.52867056245435,
                "supply": "39543"
              },
              {
                "attributeName": "Body",
                "attributeValue": "Turtleneck Blue",
                "supplyPercentage": 2.049853907962016,
                "supply": "449"
              },
              {
                "attributeName": "Head",
                "attributeValue": "Flat Cap Blue",
                "supplyPercentage": 2.5200876552227904,
                "supply": "552"
              },
              {
                "attributeName": "Face",
                "attributeValue": "Cute",
                "supplyPercentage": 35.8427684441198,
                "supply": "7851"
              }
            ]
          },
          "balance": 1,
          "balanceUSD": 2038.627,
          "ownedAt": null,
          "balances": [
            {
              "balance": "1",
              "account": {
                "address": "0x52c8ff44260056f896e20d8a43610dd88f05701b",
                "displayName": {
                  "value": "0xjasper.eth"
                }
              }
            }
          ],
          "valuationStrategy": "ESTIMATED_VALUE"
        }
      ],
      "pageInfo": {
        "hasNextPage": true,
        "endCursor": "MjAzOC42MjcwMDAwLTYyMzEyMzk1",
        "startCursor": "MjAzOC42MjcwMDAwLTYyMzEyMzk1",
        "hasPreviousPage": false
      }
    }
  }
}

Arguments

Argument	Description	Type	Required
`owners`	Array of addresses to query NFTs for	`[Address!]!`	Yes
`network`	Filter NFTs by specific network	`Network`	No
`minEstimatedValueUsd`	Minimum USD value threshold for NFTs	`Float`	No
`search`	Search string to filter NFTs	`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 NFTs	`Boolean`	No
`first`	Number of NFTs to return (default: 24)	`Int`	No
`after`	Cursor for pagination	`String`	No
`withOverrides`	Include value overrides	`Boolean`	No

Fields

NftUserTokenConnection

Field	Description	Type
`edges`	Array of NFT edges	`[NftUserTokenEdge!]!`
`pageInfo`	Pagination information	`PageInfo!`

NftToken (node)

Field	Description	Type
`id`	Unique identifier	`ID!`
`tokenId`	Token ID within collection	`String!`
`name`	Token name	`String!`
`description`	Token description	`String`
`supply`	Total token supply	`BigDecimal!`
`circulatingSupply`	Circulating supply	`BigDecimal!`
`holdersCount`	Number of token holders	`BigDecimal!`
`socialLinks`	Social media links	`[SocialLink!]!`
`collection`	Parent collection data	`NftCollection!`
`traits`	Token attributes	`[NftTrait!]!`
`mediasV2`	Legacy media assets	`[NftMediaV2!]!`
`mediasV3`	Current media assets	`NftMedias!`
`estimatedValue`	Current value estimate	`NftValueDenomination`
`lastSale`	Last sale details	`NftValueDenomination`
`rarityRank`	Token rarity ranking (deprecated)	`Int`
`lastSaleEth`	Last sale in ETH (deprecated)	`BigDecimal`
`estimatedValueEth`	Estimated value in ETH (deprecated)	`BigDecimal`
`isHidden`	Hidden status	`Boolean!`

Enums

enum NftValuationStrategy {
  TOP_OFFER
  ESTIMATED_VALUE
  OVERRIDE
}

Notes

Supports pagination for handling large NFT collections
Filter by network, value, and NFT standard
Returns comprehensive token metadata including estimated values
Includes ownership information and acquisition dates
Supports both ERC721 and ERC1155 tokens

`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

Trending Tokens​

tokenTrends​

Variables​

Example Query​

Example Response​

Balance Computation​

computeTokenBalances​

Example Variables​

Example Mutation​

Example Response​

computeAppBalances​

Example Variables​

Example Mutation​

Example Response​

balanceJobStatus​

Example Variables​

Example Query​

Example Response​

Response Fields​

fungibleTokenBatch​

Example Variables​

Arguments​

Fields​

priceData Fields​

Enums​

NFT Holdings

nftUsersTokens​

Example Use Case: User's NFT Gallery​

Example Variables​

Example Query​

Example Response​

Arguments​

Fields​

NftUserTokenConnection​

NftToken (node)​

Enums​

Notes​

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​

Trending Tokens

`tokenTrends`

Variables

Example Query

Example Response

Balance Computation

computeTokenBalances

Example Variables

Example Mutation

Example Response

computeAppBalances

Example Variables

Example Mutation

Example Response

balanceJobStatus

Example Variables

Example Query

Example Response

Response Fields

`fungibleTokenBatch`

Example Variables

Arguments

Fields

priceData Fields

Enums

`nftUsersTokens`

Example Use Case: User's NFT Gallery

Example Variables

Example Query

Example Response

Arguments

Fields

NftUserTokenConnection

NftToken (node)

Enums

Notes

`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