nft

Get Balance

Retrieves the quantity of NFTs held by a specific wallet address for a given collection across multiple blockchain networks. This endpoint allows users and developers to quickly determine the number of NFTs an address owns within a particular collection, facilitating portfolio tracking, auditing of NFT holdings, and interactions with NFT marketplaces or decentralized applications.

💡 Compute Unit Value: 95 (Fixed)

get/defi/v1/nft/getbalance

Request

Base URL
https://svc.blockdaemon.com
URL
https://svc.blockdaemon.com/defi/v1/nft/getbalance
Auth
API key in header X-API-Key

Query parameters

chainId'1' | '56' | '43114' | '137' | '250' | '10' | '11155420' | '42161' | '421614' | '25' | '338' | '84532' | '8453' | '43113' | '97' | '80002' | '300' | '324' | '5000' | '5003' | '900' | '901'

The unique ID to direct queries or transactions to the correct blockchain. Find more here.

Example:1

chainSymbolstring

The abbreviated chain name for queries or transactions.

Example:ETH

nftCollectionstring required

The smart contract address of the NFT collection whose balance is to be retrieved.

Example:0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D

addressstring required

The user's blockchain address for which the NFT balance will be queried.

Example:0xdAe2F6EdDdA6fb4fb60cc02633DE27e2b431B402

nftProtocolIdstring

Specifies the NFT standard to use for the query. Acceptable values are 721 for ERC-721 tokens and 1155 for ERC-1155 tokens. If not provided, the default value is 721

Example:721

tokenIdstring

The unique token ID within the NFT collection. Required for ERC-1155 (nftProtocolId=1155) since multiple token types share one contract. For ERC-721, if only querying total owned, this can be omitted.

Example:3238

Response

Successful response

statusinteger

msgstring

dataobject

Example response

{
  "status": 200,
  "msg": "success",
  "data": {
    "balance": "2"
  }
}

Changes

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