Skip to main content
GET
/
token
/
portfolio
cURL
curl --request GET \
  --url https://api.uniblock.dev/uni/v1/token/portfolio \
  --header 'X-API-KEY: <api-key>'
{
  "fungibles": [
    {
      "contractAddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "balance": "199999999999",
      "formattedBalance": "19.9999999999",
      "name": "Ethereum",
      "symbol": "ETH",
      "logo": "https://assets.coingecko.com/coins/images/279/large/ethereum.png",
      "decimals": "18",
      "associatedTokenAddress": "EkSPbKodUFbYmsX5LuvfnSoRAozZ3kxT9wy71pf6eL2d"
    }
  ],
  "native": {
    "contractAddress": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
    "balance": "199999999999",
    "formattedBalance": "19.9999999999",
    "name": "Ethereum",
    "symbol": "ETH",
    "logo": "https://assets.coingecko.com/coins/images/279/large/ethereum.png",
    "decimals": "18"
  },
  "nfts": [
    {
      "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,
11297108109,
1135,
1284,
1285,
130,
1301,
1315,
1328,
1329,
137,
143,
146,
14601,
1514,
168587773,
1868,
1946,
2020,
2021,
2030232745,
204,
232,
2442,
25,
250,
252,
2522,
2741,
30,
300,
31,
324,
33111,
33139,
34443,
351243127,
360,
3636,
3637,
369,
36900,
37111,
4002,
4157,
4158,
4202,
42161,
421614,
42170,
42220,
43113,
43114,
44787,
480,
4801,
5000,
5003,
510,
5115,
5330,
53302,
534351,
534352,
5371,
5373,
545,
56,
560048,
5611,
57054,
57073,
59141,
59144,
60808,
613419,
666666666,
685685,
6900,
69000,
6985385,
7000,
7001,
7080969,
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
Example:

1

walletAddress
string
default:0x8D97689C9818892B700e27F316cc3E41e17fBeb9
required

The address of the wallet to query.

Example:

"0x8D97689C9818892B700e27F316cc3E41e17fBeb9"

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,
Moralis,
Shyft,

Response

200 - application/json
fungibles
object[]
required
native
object
required
nfts
object[]
required
cursor
string
required
Example:

"ALC_MHgyMzEyZjAwMTQ5ZDAxMDgwNmQ5ZWY2ZjNlYTMyMGViMWUxYTZiYzhlOjB4MDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDAwMDFhYTpmYWxzZQ=="