Retrieve detailed information about a specific NFT

Retrieves detailed information about a specific NFT instance, identified by its token contract address and token ID.

GET /v2/tokens/{address_hash_param}/instances/{token_id_param}

Retrieve detailed information about a specific NFT

cURL

curl --request GET \
  --url http://localhost/api/v2/tokens/{address_hash_param}/instances/{token_id_param}

200

{
  "animation_url": "https://example.com",
  "external_app_url": "https://example.com",
  "id": "<string>",
  "image_url": "https://example.com",
  "is_unique": true,
  "media_type": "image/png",
  "media_url": "https://example.com",
  "metadata": {
    "description": "Test",
    "image": "https://example.com/image.png",
    "name": "Test"
  },
  "owner": {
    "ens_domain_name": "<string>",
    "hash": "<string>",
    "implementations": [
      {
        "address_hash": "<string>",
        "name": "<string>"
      }
    ],
    "is_contract": true,
    "is_scam": true,
    "is_verified": true,
    "metadata": {
      "tags": [
        {
          "meta": {},
          "name": "<string>",
          "ordinal": 123,
          "slug": "<string>",
          "tagType": "<string>"
        }
      ]
    },
    "name": "<string>",
    "private_tags": [
      {
        "address_hash": "<string>",
        "display_name": "<string>",
        "label": "<string>"
      }
    ],
    "public_tags": [
      {
        "address_hash": "<string>",
        "display_name": "<string>",
        "label": "<string>"
      }
    ],
    "watchlist_names": [
      {
        "display_name": "<string>",
        "label": "<string>"
      }
    ]
  },
  "thumbnails": {
    "original": "<string>",
    "250x250": "<string>",
    "500x500": "<string>",
    "60x60": "<string>"
  },
  "token": {
    "address_hash": "<string>",
    "circulating_market_cap": "<string>",
    "decimals": "<string>",
    "exchange_rate": "<string>",
    "holders_count": "<string>",
    "icon_url": "https://example.com",
    "name": "<string>",
    "symbol": "<string>",
    "total_supply": "<string>",
    "volume_24h": "<string>",
    "foreign_address": "<string>",
    "origin_chain_id": "<string>"
  },
  "value": "<string>"
}

Path Parameters

address_hash_param · string · required

Address hash in the path

Pattern: ^0x([A-Fa-f0-9]{40})$

token_id_param · string | null · required

Token ID for ERC-721/1155/404 tokens

Pattern: ^-?([1-9][0-9]*|0)$

Query Parameters

apikey · string

API key for rate limiting or for sensitive endpoints

key · string

Secret key for getting access to restricted resources

Response

200

application/json

Detailed information about the specified NFT instance.

animation_url · string<uri> | null · required

Example:

"https://example.com"

external_app_url · string<uri> | null · required

Example:

"https://example.com"

id · string · required

Pattern: ^-?([1-9][0-9]*|0)$

image_url · string<uri> | null · required

Example:

"https://example.com"

is_unique · boolean | null · required

media_type · string | null · required

Mime type of the media in media_url

Example:

"image/png"

media_url · string<uri> | null · required

Example:

"https://example.com"

metadata · object · required

Example:

{
  "description": "Test",
  "image": "https://example.com/image.png",
  "name": "Test"
}

owner · Address · object · required

Address

Show child attributes

thumbnails · object · required

Show child attributes

token · Token · object · required

Token struct

Show child attributes

token_type · enum<string>

Available options: ERC-20, ERC-721, ERC-1155, ERC-404, ERC-7984

value · string | null

Pattern: ^-?([1-9][0-9]*|0)$