List ERC-721 balances
Lists ERC-721 token balances of a wallet address.
Balance for a specific contract can be retrieved with the contractAddress parameter.
Api keys provide higher access to rate limits. To obtain an api key, sign up for an account at https://build.avax.network/console/utilities/data-api-keys.
In: header
Path Parameters
A supported evm chain id or blockchain id. Use the /chains endpoint to get a list of supported chain ids.
A wallet address.
Query Parameters
A page token, received from a previous list call. Provide this to retrieve the subsequent page.
The maximum number of items to return. The minimum page size is 1. The maximum pageSize is 500.
101 <= value <= 500A contract addresses to filter by.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://data-api.avax.network/v1/chains/43114/addresses/0x71C7656EC7ab88b098defB751B7401B5f6d8976F/balances:listErc721?pageSize=10&contractAddress=0xB31f66AA3C1e785363F0875A1B74E27b85FD66c7"{
"nextPageToken": "string",
"nativeTokenBalance": {
"name": "Wrapped AVAX",
"symbol": "WAVAX",
"decimals": 18,
"logoUri": "https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg",
"chainId": "43114",
"price": {
"currencyCode": "usd",
"value": "42.42"
},
"balance": "2000000000000000000",
"balanceValue": {
"currencyCode": "usd",
"value": "42.42"
}
},
"erc721TokenBalances": [
{
"address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
"name": "Wrapped AVAX",
"symbol": "WAVAX",
"ercType": "ERC-721",
"tokenId": "string",
"tokenUri": "string",
"metadata": {
"indexStatus": "indexed",
"metadataLastUpdatedTimestamp": 0,
"name": "string",
"symbol": "string",
"imageUri": "string",
"description": "string",
"animationUri": "string",
"externalUrl": "string",
"background": "string",
"attributes": "string"
},
"ownerAddress": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
"chainId": "43114"
}
]
}{
"message": "string",
"statusCode": 400,
"error": "Bad Request"
}{
"message": "string",
"statusCode": 401,
"error": "Unauthorized"
}{
"message": "string",
"statusCode": 403,
"error": "Forbidden"
}{
"message": "string",
"statusCode": 404,
"error": "Not Found"
}{
"message": "string",
"statusCode": 429,
"error": "Too Many Requests"
}{
"message": "string",
"statusCode": 500,
"error": "Internal Server Error"
}{
"message": "string",
"statusCode": 502,
"error": "Bad Gateway"
}{
"message": "string",
"statusCode": 503,
"error": "Service Unavailable"
}Is this guide helpful?