Skip to main content
GET
/
token
/
balance
cURL
curl --request GET \
  --url https://api.uniblock.dev/uni/v1/token/balance \
  --header 'X-API-KEY: <api-key>'
{
  "balances": [
    {
      "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"
    }
  ],
  "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,
1088,
1101,
11011,
11124,
11142220,
11155111,
11155420,
11155931,
11235,
11297108099,
11297108109,
1135,
1284,
1285,
130,
1301,
1313161554,
1315,
1328,
1329,
137,
14,
143,
146,
14601,
1514,
1666600000,
167000,
167009,
168587773,
1868,
1946,
2020,
2021,
2030232745,
204,
232,
2442,
248,
25,
250,
252,
2522,
2741,
288,
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,
81457,
843843,
8453,
84532,
869,
88882,
88888,
9001,
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.

​
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=="