nft_tokens_by_address
Retrieve NFT tokens owned by a specific address, grouped by collection, with details on token IDs, metadata, and collection information. Supports pagination for large datasets.
Instructions
Retrieve NFT tokens (ERC-721, ERC-404, ERC-1155) owned by an address, grouped by collection.
Provides collection details (type, address, name, symbol, total supply, holder count) and individual token instance data (ID, name, description, external URL, metadata attributes).
Essential for a detailed overview of an address's digital collectibles and their associated collection data.
**SUPPORTS PAGINATION**: If response includes 'pagination' field, use the provided next_call to get additional pages.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| address | Yes | NFT owner address | |
| chain_id | Yes | The ID of the blockchain | |
| cursor | No | The pagination cursor from a previous response to get the next page of results. |
Input Schema (JSON Schema)
{
"properties": {
"address": {
"description": "NFT owner address",
"title": "Address",
"type": "string"
},
"chain_id": {
"description": "The ID of the blockchain",
"title": "Chain Id",
"type": "string"
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "The pagination cursor from a previous response to get the next page of results.",
"title": "Cursor"
}
},
"required": [
"chain_id",
"address"
],
"title": "nft_tokens_by_addressArguments",
"type": "object"
}