TAtatum
NFT (ERC-721 or compatible)

Get NFT balance of the wallet

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

50 credit per API call + 5 credits for each owned NFT

This endpoint is deprecated.

> 📘 **Note:** > > We've introduced a new, faster, and more reliable endpoint: GET /v4/data/nft/balances. As a result, the older endpoint - GET /v3/nft/address/balance/{chain}/{address} - has been deprecated. These endpoints will reach End of Life on June 30, 2025, as announced in our changelog. We recommend migrating to the new endpoint as soon as possible.

Get all NFTs that a blockchain address holds. The NFTs are returned grouped by the smart contracts they were minted on.

This API is supported for the following blockchains:

  • Algorand
  • BNB Smart Chain - mainnet only
  • Celo
  • Ethereum
  • Polygon
  • Solana

On Solana and Algorand, if a blockchain address holds fewer than 50 NFTs, the API also returns each NFT's metadata. If the metadata is not returned, you can obtain it using the API for getting NFT metadata.

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

Request

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

Path parameters

chain'ALGO' | 'BSC' | 'CELO' | 'ETH' | 'MATIC' | 'SOL' required
Example:SOL

The blockchain to work with

addressstring required
Example:FykfMwA9WNShzPJbbb9DNXsfgDgS3XZzWiFgrVXfWoPJ

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

Response

OK

contractAddressstring required

On Algorand, this is the asset ID (the ID of the NFT); on the other blockchains, this is the address of the NFT smart contract.

balancesstring[] required

On Algorand, this is either an array of "1" to indicate that the NFTs with the specified IDs exist, or an array with the number of NFT fractions if the NFTs are <a href="https://developer.algorand.org/docs/get-started/tokenization/nft/#fractional-nfts" target="_blank">fractional</a>; on the other blockchains, this is an array of the IDs of the NFTs.

blockNumbernumber[]

(EVM-based blockchains only) An array of the numbers of the blocks in which the NFT was received by the address

supplynumber

(Algorand only) The number of fractions in the NFT if the NFT is <a href="https://developer.algorand.org/docs/get-started/tokenization/nft/#fractional-nfts" target="_blank">fractional</a>

decimalsnumber

(Algorand only) The number of decimal places in an NFT fraction if the NFT is <a href="https://developer.algorand.org/docs/get-started/tokenization/nft/#fractional-nfts" target="_blank">fractional</a>

Example response

[
  {
    "contractAddress": "43821281",
    "balances": [
      "123"
    ],
    "blockNumber": [
      13816552
    ],
    "metadata": [
      {
        "tokenId": "123",
        "url": "ipfs://QmXFpaS3S7CkLZvihLFA9JbawKdqhjg8dJeDkPntmkD2Pc",
        "metadata": {
          "name": "Example NFT name",
          "description": "Example NFT description",
          "image": "ipfs://QmP4R7ACZ7JRQ6sLdmnPHqjWEXxzdnPvhAV2f6RnQ8uxJ6"
        }
      }
    ],
    "supply": 10,
    "decimals": 1
  }
]

Changes

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