Skip to main content
GET
/
nft
/
balance
cURL
curl --request GET \
  --url https://api.uniblock.dev/uni/v1/nft/balance \
  --header 'X-API-KEY: <api-key>'
{
  "balances": [
    {
      "contractAddress": "0xbdde08bd57e5c9fd563ee7ac61618cb2ecdc0ce0",
      "name": "CryptoCitizens",
      "symbol": "CITIZEN",
      "ercType": "ERC721",
      "tokenId": "5000372",
      "tokenURI": "http://token.artblocks.io/0xbdde08bd57e5c9fd563ee7ac61618cb2ecdc0ce0/5000372",
      "amount": "1",
      "metadata": [
        {
          "name": "CyrptoMexa #372",
          "description": "CryptoMexas are the sixth edition in the CryptoCitizens collection, an ongoing generative portrait series based on real people from communities around the world. Holders of CryptoCitizens are members of the Bright Moments DAO.",
          "image": "https://media-proxy.artblocks.io/0xbdde08bd57e5c9fd563ee7ac61618cb2ecdc0ce0/5000372.png",
          "traits": "[\n          {\n            \"value\": \"All CryptoMexas\",\n            \"trait_type\": \"CryptoMexa\"\n          },\n          {\n            \"value\": \"Body: Dark\",\n            \"trait_type\": \"CryptoMexa\"\n          },\n          {\n            \"value\": \"City: CDMX\",\n            \"trait_type\": \"CryptoMexa\"\n          },\n          {\n            \"value\": \"Gear: Vihuela\",\n            \"trait_type\": \"CryptoMexa\"\n          },\n          {\n            \"value\": \"Bodywear: Charro Suit\",\n            \"trait_type\": \"CryptoMexa\"\n          },\n          {\n            \"value\": \"Facewear: Red Shades\",\n            \"trait_type\": \"CryptoMexa\"\n          },\n          {\n            \"value\": \"Footwear: Black Shoes\",\n            \"trait_type\": \"CryptoMexa\"\n          },\n          {\n            \"value\": \"Headwear: White Cap\",\n            \"trait_type\": \"CryptoMexa\"\n          },\n          {\n            \"value\": \"Background: Avenida Álvaro Obregón\",\n            \"trait_type\": \"CryptoMexa\"\n          }\n        ]"
        }
      ],
      "rawMetadata": "{\"aspect_ratio\":1,\"traits\":[{\"value\":\"All CryptoMexas\",\"trait_type\":\"CryptoMexa\"},{\"value\":\"Body: Dark\",\"trait_type\":\"CryptoMexa\"},{\"value\":\"City: CDMX\",\"trait_type\":\"CryptoMexa\"},{\"value\":\"Gear: Vihuela\",\"trait_type\":\"CryptoMexa\"},{\"value\":\"Bodywear: Charro Suit\",\"trait_type\":\"CryptoMexa\"},{\"value\":\"Facewear: Red Shades\",\"trait_type\":\"CryptoMexa\"},{\"value\":\"Footwear: Black Shoes\",\"trait_type\":\"CryptoMexa\"},{\"value\":\"Headwear: White Cap\",\"trait_type\":\"CryptoMexa\"},{\"value\":\"Background: Avenida Álvaro Obregón\",\"trait_type\":\"CryptoMexa\"}],\"tokenID\":\"5000372\",\"generator_url\":\"https://generator.artblocks.io/0xbdde08bd57e5c9fd563ee7ac61618cb2ecdc0ce0/5000372\",\"artist\":\"Qian Qian\",\"description\":\"CryptoMexas are the sixth edition in the CryptoCitizens collection, an ongoing generative portrait series based on real people from communities around the world. Holders of CryptoCitizens are members of the Bright Moments DAO.\",\"preview_asset_url\":\"https://media-proxy.artblocks.io/0xbdde08bd57e5c9fd563ee7ac61618cb2ecdc0ce0/5000372.png\",\"platform\":\"CryptoCitizens\",\"features\":{\"Background\":\"Avenida Álvaro Obregón\",\"Bodywear\":\"Charro Suit\",\"Footwear\":\"Black Shoes\",\"Headwear\":\"White Cap\",\"Facewear\":\"Red Shades\",\"City\":\"CDMX\",\"Body\":\"Dark\",\"Gear\":\"Vihuela\"},\"external_url\":\"\",\"payout_address\":\"0xe79e97c3e7990672c3d45c46714ef748dd0ea7df\",\"token_hash\":\"0xc290d582815ba978115cc3bfdd547bf39e11f548f6e72a8461166c29eaeed7e3\",\"project_id\":\"5\",\"is_static\":false,\"primary_asset_url\":\"https://generator.artblocks.io/0xbdde08bd57e5c9fd563ee7ac61618cb2ecdc0ce0/5000372\",\"image\":\"https://media-proxy.artblocks.io/0xbdde08bd57e5c9fd563ee7ac61618cb2ecdc0ce0/5000372.png\",\"animation_url\":\"https://generator.artblocks.io/0xbdde08bd57e5c9fd563ee7ac61618cb2ecdc0ce0/5000372\",\"website\":\"https://brightmoments.io\",\"royaltyInfo\":{\"additionalPayeePercentage\":50,\"artistAddress\":\"0xb96e81f80b3aeef65cb6d0e280b15fd5dbe71937\",\"additionalPayee\":\"0x8fcc2dc884ed69b12d31c11363f2ff532bfec350\",\"royaltyFeeByID\":5},\"license\":\"NIFTY\",\"engine_type\":\"fullyonchain\",\"series\":\"N/A\",\"name\":\"CryptoMexa #372\",\"minted\":true,\"script_type\":\"[email protected]\",\"collection_name\":\"CryptoMexa by Qian Qian\"}",
      "cachedImage": "https://cdn.simplehash.com/assets/383ae90349efc3f992d7e23ac35c7d8f8e09362f14acb9750192e92fcbde323f.png",
      "updateAuthorityAddress": "H6CMJqjhnm9ia7Cg2jBYF6fWSQsqXuwEJd3xbjt5NxKg",
      "associatedTokenAddress": "FxWDVLKBbh2krxwXQsMsCpGDqRLQZxJJT5WwWvnHqPFw"
    }
  ],
  "cursor": "ALC_MHgyMzEyZjAwMTQ5ZDAxMDgwNmQ5ZWY2ZjNlYTMyMGViMWUxYTZiYzhlOjB4MDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDFhYTpmYWxzZQ=="
}

Authorizations

X-API-KEY
string
header
required

API key to access the API (Optional)

Query Parameters

chainId
enum<string>
default:1
required

Unique identifier for a blockchain network.

Available options:
1,
10,
100,
10143,
10200,
10218,
11011,
11124,
11142220,
11155111,
11155420,
11155931,
11235,
11297108099,
11297108109,
1135,
1284,
1285,
130,
1301,
1313161554,
1315,
1328,
1329,
137,
14,
143,
146,
14601,
1514,
167000,
167009,
168587773,
1868,
1946,
2020,
2021,
2030232745,
204,
232,
2442,
25,
250,
252,
2522,
2741,
30,
300,
31,
321,
322,
324,
32769,
33101,
33111,
33139,
34443,
351243127,
360,
3636,
3637,
369,
36900,
37111,
4002,
4157,
4158,
4202,
42161,
421614,
42170,
42220,
42261,
42262,
43113,
43114,
44787,
480,
4801,
50,
5000,
5003,
51,
510,
5115,
5330,
53302,
534351,
534352,
5371,
5373,
54211,
545,
56,
560048,
5611,
57054,
57073,
59141,
59144,
60808,
61,
613419,
666666666,
685685,
6900,
69000,
6985385,
7000,
7001,
7080969,
7332,
747,
763373,
7777777,
80002,
80069,
80094,
808813,
843843,
8453,
84532,
869,
88882,
88888,
919,
97,
9745,
9746,
994873017,
998,
999,
999999999,
aptos,
bitcoin,
bitcoin-testnet,
eth-holesky-beacon,
eth-hoodi-beacon,
eth-mainnet-beacon,
eth-sepolia-beacon,
solana,
solana-devnet,
starknet,
starknet-sepolia,
sui,
toncoin
Example:

1

walletAddress
string
default:0x8D97689C9818892B700e27F316cc3E41e17fBeb9
required

The address of the wallet to query.

Example:

"0x8D97689C9818892B700e27F316cc3E41e17fBeb9"

cursor
string

Cursor from previous query to get next page of results.

includeCachedImage
boolean

Returns a link to the cached image. This option is not supported by all. providers.

includeRaw
boolean

Returns the raw data given by the provider. WARNING: removes backup feature, and raw data returned is not normalized which might make switching providers difficult

Example:

null

provider
enum<string>

Specify which provider to use. The project's provider priority list is used by default if no providers are selected. (Priority list can be managed on Uniblock's dashboard)

Available options:
Alchemy,
GoldRush,
Moralis,
Tatum,
Shyft,
,
Covalent

Response

200 - application/json
balances
object[]
required
cursor
string
required
Example:

"ALC_MHgyMzEyZjAwMTQ5ZDAxMDgwNmQ5ZWY2ZjNlYTMyMGViMWUxYTZiYzhlOjB4MDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDFhYTpmYWxzZQ=="