Legacy Queries & Mutations
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.
Balance Computation
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.
Try it nownftUsersTokens
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.
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