Sign in
nfts

Get NFT balances by address

Get NFT balances for a given address

get/v1/nfts/balance/{ownerAddress}

Request

  • Base URL: https://insight.thirdweb.com
  • URL: https://insight.thirdweb.com/v1/nfts/balance/{ownerAddress}
  • Auth: API key in header x-client-id

Path parameters

ownerAddressstring required
Example:vitalik.eth

Query parameters

chainnumber[]

Use chain_id instead

[
  20,
  56,
  1
]
chain_idnumber[]

The chain ID(s) to request the data for. You can specify multiple chain IDs, up to a maximum of 55. Use repeated query parameters, e.g., ?chain_id=20&chain_id=56. Optional, because a single chain can as well be specified as a subdomain

[
  20,
  56,
  1
]
limitinteger

The number of items to return

Example:20
pageinteger nullable

Page number (0-indexed)

metadata'true' | 'false'

Whether to include metadata for the tokens

Example:false
resolve_metadata_links'true' | 'false'

Whether to resolve metadata IPFS or Arweave links

Example:false
token_typesstring[]

The types of NFTs to include in the response

Response

Success

Example response

{
  "data": [
    {
      "chain_id": 1,
      "token_address": "vitalik.eth",
      "contract": {
        "chain_id": 1,
        "address": "vitalik.eth"
      }
    }
  ]
}

Changes

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