Sign in

v1

latestOpenAPI 3.0.02026-07-26268286602.5 KB
tokens

List individual NFT instances for a token contract

Retrieves instances of NFTs for a specific token contract. This endpoint is primarily for ERC-721 and ERC-1155 tokens.

get/{chain_id}/api/v2/tokens/{address_hash_param}/instances

Path parameters

address_hash_paramstring required

Address hash in the path

chain_idstring required

The ID of the blockchain

Query parameters

holder_address_hashstring

Token holder address hash in the query

items_countinteger

Number of items per page

unique_tokenstring nullable

Token ID for paging

Response

NFT instances for the specified token contract, with pagination.

next_page_paramsobject nullable required

Example response

{
  "items": [
    {
      "animation_url": "https://example.com",
      "external_app_url": "https://example.com",
      "image_url": "https://example.com",
      "media_type": "image/png",
      "media_url": "https://example.com",
      "metadata": {
        "description": "Test",
        "image": "https://example.com/image.png",
        "name": "Test"
      }
    }
  ],
  "next_page_params": {
    "unique_token": 782098
  }
}