curl --request GET \
--url https://api-test.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\":\"tone@14.8.15\",\"collection_name\":\"CryptoMexa by Qian Qian\"}",
"cachedImage": "https://cdn.simplehash.com/assets/383ae90349efc3f992d7e23ac35c7d8f8e09362f14acb9750192e92fcbde323f.png",
"updateAuthorityAddress": "H6CMJqjhnm9ia7Cg2jBYF6fWSQsqXuwEJd3xbjt5NxKg",
"associatedTokenAddress": "FxWDVLKBbh2krxwXQsMsCpGDqRLQZxJJT5WwWvnHqPFw"
}
],
"cursor": "ALC_MHgyMzEyZjAwMTQ5ZDAxMDgwNmQ5ZWY2ZjNlYTMyMGViMWUxYTZiYzhlOjB4MDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDFhYTpmYWxzZQ=="
}Get the NFT balances of an address.
curl --request GET \
--url https://api-test.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\":\"tone@14.8.15\",\"collection_name\":\"CryptoMexa by Qian Qian\"}",
"cachedImage": "https://cdn.simplehash.com/assets/383ae90349efc3f992d7e23ac35c7d8f8e09362f14acb9750192e92fcbde323f.png",
"updateAuthorityAddress": "H6CMJqjhnm9ia7Cg2jBYF6fWSQsqXuwEJd3xbjt5NxKg",
"associatedTokenAddress": "FxWDVLKBbh2krxwXQsMsCpGDqRLQZxJJT5WwWvnHqPFw"
}
],
"cursor": "ALC_MHgyMzEyZjAwMTQ5ZDAxMDgwNmQ5ZWY2ZjNlYTMyMGViMWUxYTZiYzhlOjB4MDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDFhYTpmYWxzZQ=="
}API key to access the API (optional)
Unique identifier for a blockchain network.
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, 2201, 232, 2442, 25, 250, 252, 2522, 2741, 30, 300, 31, 321, 322, 324, 32769, 33101, 33111, 33139, 34443, 351243127, 360, 3636, 3637, 369, 37111, 397, 4002, 4157, 4158, 4202, 42161, 421614, 4217, 42170, 42220, 42261, 42262, 42431, 43113, 43114, 4326, 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, 6343, 666666666, 685685, 6900, 69000, 6985385, 7000, 7001, 7080969, 7332, 737373, 747, 747474, 763373, 7777777, 80002, 80069, 80094, 808813, 843843, 8453, 84532, 869, 88882, 88888, 919, 97, 9745, 9746, 988, 994873017, 998, 999, 999999999, aptos, bitcoin, bitcoin-testnet, bitcoin-testnet4, eth-holesky-beacon, eth-hoodi-beacon, eth-mainnet-beacon, eth-sepolia-beacon, polkadot, ripple, solana, solana-devnet, starknet, starknet-sepolia, stellar, stellar-testnet, sui, toncoin, tron, tron-testnet 1
The address of the wallet to query.
"0x8D97689C9818892B700e27F316cc3E41e17fBeb9"
Cursor from previous query to get next page of results.
Returns a link to the cached image. This option is not supported by all. providers.
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
null
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)
Alchemy, GoldRush, Moralis, Tatum, BlockDaemon, Shyft Was this page helpful?