Skip to main content
GET
Get wallet balance

Response headers

Operational notes

Reading the numbers

Compute from balance, never from formatted. balance is the raw on-chain amount in the smallest unit, sent as a string precisely so it does not lose precision. formatted is for display only."balance": "100000000" with "decimals": 6 is 100 USDC.
A missing contractAddress means the asset is the network’s native gas tokenETH, POL — rather than an ERC-20. Those are the assets that usually appear in unpricedAssets with usd: null, and they contribute nothing to totalUsd.

Authorizations

API-KEY
string
header
required

Your partner API key.

Headers

Api-Version
string
default:2026-09.1
required

The API version this request targets. Required on every /api/v0/* call. Format YYYY-MM.<release>; 2026-09.1 is the latest. The version that served the request is echoed back on the response. Missing, malformed or unsupported values are rejected with 400.

Pattern: ^\d{4}-\d{2}\.\d+$

Path Parameters

userId
string
required

Customer reference id, format cus_<20 chars> — never an internal UUID. Must belong to the authenticated partner.

walletId
string
required

Wallet reference id, format wlt_<20 chars>. Must belong to the customer named in the path.

Response

The balance object. Unwrapped — the partner surface returns bare payloads, with no data/status envelope.

walletId
string

The wallet reference id that was requested.

address
string

The wallet's on-chain address. The same address is used across all EVM networks.

chain
string

Scope of the query — all for the aggregated multi-network balance, or a single network name for TRON wallets.

tokens
object[]

One entry per tracked asset per network, including assets with a zero balance.

totalUsd
number

Sum of the USD value of all priced assets. Anything in unpricedAssets contributes nothing.

unpricedAssets
string[]

Chain:SYMBOL identifiers for assets with no USD price at read time, typically native gas tokens. Their usd is null.

source
string

Where the figures came from. rpc means read live from the chain node at request time.