---
title: "Get NFT balance of the wallet"
method: GET
path: "/v3/nft/address/balance/{chain}/{address}"
tags: ["NFT (ERC-721 or compatible)"]
deprecated: true
---

# Get NFT balance of the wallet

`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`

> **Deprecated.**

/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](https://docs.tatum.io/changelog/blockchain-data-api-faster-endpoints-update). 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](https://apidoc.tatum.io/tag/NFT-\(ERC-721-or-compatible\)/#operation/NftGetMetadataErc721).

## Path parameters

- `chain` 'ALGO' | 'BSC' | 'CELO' | 'ETH' | 'MATIC' | 'SOL', required
- `address` string, required

## Response `200`

OK

- NftTokenByAddressErc721[]
  - `contractAddress` string, 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.
  - `balances` string[], 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.
  - `blockNumber` number[]: (EVM-based blockchains only) An array of the numbers of the blocks in which the NFT was received by the address
  - `metadata` NftTokenByAddressErc721TokenMetadata[], required
    - `tokenId` string, uint256: (EVM-based blockchains only) The ID of the NFT owned by this address
    - `url` string: The URL pointing to the NFT metadata; the URL may not be present, and if it is not returned, you can get it by calling the NFT Contract.tokenURI() method
    - `metadata` NftTokenByAddressErc721Metadata: The metadata scheme obtained from the metadata URL; the scheme may not be present, and if it is not returned, you can get it using the <a href="#operation/NftGetMetadataErc721">NFT metadata API</a>
  - `supply` number: (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>
  - `decimals` number: (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>

## Other responses

- `400`: Bad Request
- `401`: Unauthorized. Not valid or inactive subscription key present in the HTTP Header.
- `403`: Forbidden. The request is authenticated, but it is not possible to perform the operation due to logical error or invalid permissions.
- `500`: Internal server error. There was an error on the server during the processing of the request.

---

[API](https://skmtc.dev/tatum/apis/smart-contracts.md) - [All operations](https://skmtc.dev/tatum/apis/smart-contracts/llms.txt) - [OpenAPI document](https://skmtc.dev/tatum/apis/smart-contracts/revisions/c0146043bb37?raw)