TAtatum
NFT (ERC-721 or compatible)

Get NFT metadata

/v3/nft/metadata/{chain}/{contractAddress}/{tokenId}

1 credit per API call

Get metadata of an NFT.

This API is supported for the following blockchains:

  • Algorand
  • BNB Smart Chain
  • Celo
  • Ethereum
  • Harmony
  • Klaytn
  • KuCoin Community Chain
  • Polygon
  • Solana
  • TRON
  • Flare
  • Cronos
  • Base
  • Avalanche
  • Fantom
  • Optimism
get/v3/nft/metadata/{chain}/{contractAddress}/{tokenId}

Request

  • Base URL
    https://api.tatum.io
  • URL
    https://api.tatum.io/v3/nft/metadata/{chain}/{contractAddress}/{tokenId}
  • Auth
    API key in header x-api-key

Path parameters

chain'BSC' | 'CELO' | 'ETH' | 'KCS' | 'KLAY' | 'MATIC' | 'ONE' | 'SOL' | 'TRON' | 'ALGO' | 'FLR' | 'CRO' | 'BASE' | 'AVAX' | 'FTM' | 'OPTIMISM' required

The blockchain to work with

contractAddressstring required
Example:0x94Ce79B9F001E25BBEbE7C01998A78F7B27D1326

The blockchain address of the NFT to get metadata for

tokenIdstring uint256 required
Example:123

The ID of the NFT to get metadata for<br/>For Solana and ALGO put 0 since this parameter is irrelevant for those chains.

Query parameters

testnetType'ethereum-sepolia' | 'flare-coston' | 'flare-coston2' | 'flare-songbird'

Specifies the testnet type. The default is ethereum-sepolia for Ethereum (ETH) currency and flare-coston for Flare (FLR) currency. Valid testnet types depend on the specified currency.

Type of testnet in query. The default type is based on the currency: ethereum-sepolia for ETH, and flare-coston for FLR. This parameter is valid only for ETH or FLR invocations with a testnet API Key. For mainnet API Key, this value is ignored. The currency/chain must be specified to determine the applicable set of testnet types.

Headers

x-testnet-typeSchema (unresolved $ref)

Type of testnet in header. The default type is based on the currency: ethereum-sepolia for ETH, and flare-coston for FLR. This parameter is valid only for ETH or FLR invocations with a testnet API Key. For mainnet API Key, this value is ignored. The currency/chain must be specified to determine the applicable set of testnet types.

Response

OK

OR
OR

Example response

{
  "data": "https://my_token_data.com"
}

Changes

No recorded changes to this operation across all 1 revision of this API.