Get NFT balances by address
Get NFT balances for a given address
GET
/insights/v1/nfts/balance/{ownerAddress}
Get NFT balances for a given address
Path Parameters
ownerAddress
string
required
path
Example:
"vitalik.eth"Query Parameters
chain
number[]
optional
query
Use chain_id instead
Example:
[20,56,1]chain_id
number[]
optional
query
The chain ID(s) to request the data for. You can specify multiple chain IDs, up to a maximum of 55. Use repeated query parameters, e.g., `?chain_id=20&chain_id=56`. Optional, because a single chain can as well be specified as a subdomain
Example:
[20,56,1]limit
integer
optional
query
Example:
20page
integer | null
optional
query
Example:
0metadata
string
optional
query
Example:
"false"resolve_metadata_links
string
optional
query
Example:
"false"token_types
string[]
optional
query
Responses
200
Success
application/jsondata
object[]
REQUIRED
Array of:
chain_id
number
REQUIRED
The chain ID of a relevant entry
token_address
string
REQUIRED
token_id
string
REQUIRED
balance
string
REQUIRED
name
string
description
string
image_url
string
video_url
string
animation_url
string
background_color
string
external_url
string
status
string
metadata_url
string
owner_addresses
string[]
Array of:
extra_metadata
unknown
collection
object
name
string
description
string
image_url
string
banner_image_url
string
featured_image_url
string
external_link
string
contract
object
chain_id
number
REQUIRED
The chain ID of a relevant entry
address
string
REQUIRED
name
string
symbol
string
type
string
Enum:
erc721, erc1155
400
Bad request
500
Internal server error
curl -X GET 'https://data-api.b3.fun//insights/v1/nfts/balance/vitalik.eth'const response = await fetch('https://data-api.b3.fun//insights/v1/nfts/balance/vitalik.eth', { method: 'GET'});const data = await response.json();console.log(data);import requestsresponse = requests.get('https://data-api.b3.fun//insights/v1/nfts/balance/vitalik.eth')print(response.json())
200
Response
{ "data": [ { "chain_id": 1, "token_address": "vitalik.eth", "token_id": "<string>", "balance": "<string>", "name": "<string>", "description": "<string>", "image_url": "<string>", "video_url": "<string>", "animation_url": "<string>", "background_color": "<string>", "external_url": "<string>", "status": "<string>", "metadata_url": "<string>", "owner_addresses": [ "<string>" ], "extra_metadata": { "attributes": [ {} ], "properties": "<object>" }, "collection": { "name": "<string>", "description": "<string>", "image_url": "<string>", "banner_image_url": "<string>", "featured_image_url": "<string>", "external_link": "<string>" }, "contract": { "chain_id": 1, "address": "vitalik.eth", "name": "<string>", "symbol": "<string>", "type": "erc721" } } ]}API Playground
Try this endpoint
GET
/insights/v1/nfts/balance/{ownerAddress}