v1

latestOpenAPI 3.1.02026-07-243035381.4 MB

NFT API

Get NFT balance of a wallet address

/v4/data/nft/balances

50 credits per API call

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:

Ethereum - ethereum-mainnet / ethereum-sepolia
Solana - solana-mainnet / solana-devnet
Base - base-mainnet / base-sepolia
Arbitrum - arb-one-mainnet / arb-testnet
BNB (Binance) Smart Chain - bsc-mainnet / bsc-testnet
Polygon - polygon-mainnet / polygon-amoy
Optimism - optimism-mainnet / optimism-testnet
Berachain - berachain-mainnet
Unichain - unichain-mainnet / unichain-sepolia
Monad - monad-testnet
Celo - celo-mainnet / celo-testnet
Algorand - algorand-mainnet-algod / algorand-testnet-algod
Avalanche - avax-mainnet / avax-testnet
Gnosis - gno-mainnet / gno-testnet
zkSync - zksync-mainnet / zksync-testnet
Rootstock - rsk-mainnet / rsk-testnet
Ethereum Classic - ethereum-classic-mainnet / ethereum-classic-testnet
Lisk - lisk-mainnet / lisk-testnet

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/v4/data/nft/balances

Query parameters

Example:ethereum-mainnet

The blockchain to work with.

addressstring required

Example:0x2474a7227877f2b65185f09468af7c6577fa207c

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

Response

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.

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"
    ],
    "metadata": [
      {
        "tokenId": "123",
        "url": "ipfs://QmXFpaS3S7CkLZvihLFA9JbawKdqhjg8dJeDkPntmkD2Pc",
        "metadata": {
          "name": "Example NFT name",
          "description": "Example NFT description",
          "image": "ipfs://QmP4R7ACZ7JRQ6sLdmnPHqjWEXxzdnPvhAV2f6RnQ8uxJ6"
        }
      }
    ],
    "supply": 10,
    "decimals": 1
  }
]