Skip to main content
GET
Get Current Token Balances of an Address

Authorizations

X-API-KEY
string
header
required

Authorization method required to allow user to access the api endpoints.

Query Parameters

network
string
required

Network of Address

address
string
required

Address to search

network_type
string
required

network type: evm, solana, cosmos, etc.

token_contracts
string
required

Comma separated list of token contract addresses

workspace_id
string

Workspace id to filter this address's balances by that workspace's token whitelist. Omit for the unfiltered response.

show_all
boolean
default:false

Restores the unfiltered response, ignoring the workspace token whitelist. Only meaningful alongside workspace_id.

Response

200 - application/json

Token balances of the given address, plus lookup status.

balances
object
required

Always present — never null. An empty set (both arrays empty) when lookup_status is unavailable or unsupported, since there is no genuine answer to serve. Populated (fully, on ok, or partly, on partial) otherwise. See ADR-0013: the lookup outcome always travels on lookup_status/reason rather than by changing the shape of this field.

lookup_status
enum<string>
required

Outcome of this balance lookup. ok: fully resolved. partial: the native balance leg failed but token balances resolved and are included. unavailable: the lookup failed entirely — retry may succeed. unsupported: this chain has no readable balance source, evaluated before any lookup was attempted — retrying will not help. Always present, including on a fully successful lookup.

Available options:
ok,
unsupported,
unavailable,
partial
Example:

"ok"

reason
object | null
required

Why the lookup did not return ok. Always present as an explicit null on ok/unsupported; populated on partial/unavailable.

Last modified on September 9, 2026