TAtatum
NFT (ERC-721 or compatible)

Get the NFTs from a specific smart contract that a blockchain address holds

/v3/nft/balance/{chain}/{contractAddress}/{address}

1 credit per API call

Get the NFTs minted on a specific smart contract (the contractAddress path parameter in the request endpoint URL) that a blockchain address holds.

NOTE: This API works only for the NFT smart contracts deployed using the Tatum smart contract API.

This API is supported for the following blockchains:

  • Algorand
  • BNB Smart Chain
  • Celo
  • Elrond
  • Ethereum
  • Harmony
  • Klaytn
  • KuCoin Community Chain
  • Polygon
  • Solana
  • TRON
  • Flare
  • CRO
get/v3/nft/balance/{chain}/{contractAddress}/{address}

Request

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

Path parameters

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

The blockchain to work with

addressstring required
Example:0x3223AEB8404C7525FcAA6C512f91e287AE9FfE7B

The blockchain address that you want to get the token balance of

contractAddressstring required
Example:0x94Ce79B9F001E25BBEbE7C01998A78F7B27D1326

The address of the NFT smart contract

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

Example response

{
  "data": [
    {
      "contractAddress": "116227380",
      "balances": [
        "1"
      ],
      "metadata": [
        {
          "url": "ipfs://QmXFpaS3S7CkLZvihLFA9JbawKdqhjg8dJeDkPntmkD2Pc"
        }
      ]
    }
  ]
}

Changes

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