Skip to main content
GET
/
scan
/
token-balance
Get Address ERC-20 Balance
curl --request GET \
  --url https://api-test.uniblock.dev/uni/v1/scan/token-balance \
  --header 'X-API-KEY: <api-key>'
{
  "balance": "123.4567"
}

Authorizations

​
X-API-KEY
string
header
required

API key to access the API (optional)

Query Parameters

​
chainId
enum<number>
default:1
required

Unique identifier for a blockchain network.

Available options:
1,
10,
100,
10143,
1028,
1101,
1111,
1112,
11124,
11155111,
11155420,
1284,
1285,
1287,
130,
1301,
137,
143,
146,
167000,
167009,
168587773,
1923,
1924,
199,
2442,
25,
252,
2522,
2741,
300,
324,
33111,
33139,
37714555429,
42161,
421614,
42170,
42220,
43113,
43114,
4352,
43521,
44787,
480,
4801,
50,
5000,
5003,
50104,
51,
531050104,
534351,
534352,
56,
57054,
59141,
59144,
660279,
80002,
80069,
80094,
81457,
8453,
84532,
97
Example:

1

​
address
string
default:0x21a31Ee1afC51d94C2eFcCAa2092aD1028285549
required

The address to query.

Example:

"0x21a31Ee1afC51d94C2eFcCAa2092aD1028285549"

​
contractAddress
string
default:0xdAC17F958D2ee523a2206206994597C13D831ec7
required

The address of the ERC20 contract to query.

Example:

"0xdAC17F958D2ee523a2206206994597C13D831ec7"

​
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:
EtherScan

Response

200 - application/json
​
balance
string
required

Represents smallest decimal representation of token.

Example:

"123.4567"