Skip to main content
GET
Wallet balances

Query Parameters

address
string
required

Wallet address (EVM / Solana / BTC / Sui / TON / Tron / NEAR).

chainIds
string

Comma-separated chainIds to scope the lookup. Omit for all supported chains.

Response

200 - application/json
address
string
required

The wallet these balances belong to — echoes the address you queried.

totalBalanceUSD
string
required

Sum of priced holdings, "1234.56".

balances
object
required

Balances keyed by chainId (string).

chainMeta
object

Per-chain fetch status keyed by chainId.

cachedAt
string

When this balance snapshot was taken (ISO 8601). Balances are cached briefly.

cacheHit
boolean

True if served from cache rather than freshly read from chain.

priceObservedAt
string

When the token-price catalogue used for priceUSD was observed (ISO 8601).

priceValidUntil
string

After this instant clients must stop displaying USD conversions from priceUSD (ISO 8601).