SDK Explorer

Fetches the info for all NFTs stored in a single developer-controlled wallet, using the wallets unique identifier.

Parameters
input
object
Required

Represents the input for retrieving the nft balance of a wallet.

id
string
Required

The ID of the wallet to retrieve the nfts for.

includeAll
boolean

Specifies whether to include all token.

name
string

The name of the token to filter for.

standard
string

Token standard.

Allowed valuesERC1155ERC20ERC721FungibleFungibleAssetNonFungibleNonFungibleEditionProgrammableNonFungibleProgrammableNonFungibleEdition
tokenAddresses
array of strings

An array of token addresses.

pageAfter
string

Used to return items after the specified item exclusively. SHOULD NOT be used in conjunction with pageBefore.

pageBefore
string

Used to return items before the specified item exclusively. SHOULD NOT be used in conjunction with pageAfter.

pageSize
number

The number of items to return.

Responses
Example
1const response = await client.getWalletNFTBalance({
2  id: 'b21c473f-8c93-4826-90f5-cad3cfeef4c1',
3})
4console.log(response.data?.nfts)
ResponseChoose an example
1{
2  "data": {
3    "nfts": [
4      {
5        "amount": "1",
6        "metadata": "ipfs://QmZcH4YvBVVRJtdn4RdbaqgspFU8gH6P9vomDpBVpAL3u4/1",
7        "nftTokenId": "2",
8        "token": {
9          "id": "c4d1da72-111e-4d52-bdbf-2e74a2d803d5",
10          "name": "",
11          "standard": "ERC20",
12          "blockchain": "MATIC-AMOY",
13          "decimals": 0,
14          "isNative": false,
15          "symbol": "",
16          "tokenAddress": "0xca9142d0b9804ef5e239d3bc1c7aa0d1c74e7350",
17          "updateDate": "2023-01-01T12:04:05Z",
18          "createDate": "2023-01-01T12:04:05Z"
19        },
20        "updateDate": "2023-01-01T12:04:05Z"
21      }
22    ]
23  }
24}
Did this page help you?
© 2023-2025 Circle Technology Services, LLC. All rights reserved.