Skip to main content
GET
Returns the latest balance of each requested wallet, with one row per chain, wallet and asset. wallets takes 1 to 100 comma-separated addresses. chains limits results to specific chains; omit it to include every chain.

Response

balances lists one row per wallet and asset with at least one transaction, ordered by chain, wallet, then asset. A wallet and asset with no observed balance has no row, and a missing row does not mean a zero balance. balance is the amount after the most recent transaction that changed it, in the asset’s own units. trigger is the event type that changed it, such as trade or deposit. New trigger and asset values can be added, so keep unrecognized values rather than discarding them. blockNumber and txIndex give the row’s position in its chain. To merge this response with the wallet.balances stream, follow the rule on that page.

Errors

Authorizations

Authorization
string
header
required

Send an API key, or a session token a key minted, as Authorization: Bearer <credential>. A browser opening /v1/stream offers its session token in Sec-WebSocket-Protocol instead.

Query Parameters

wallets
string
required

Wallet addresses, CSV; one to 100.

chains
string

Chains to scope to, CSV of the chain slugs. Absent means every spot chain.

Response

The latest balance of each named wallet and asset. A pair with no observed balance has no row, which is not a zero.

The latest balance of each wallet and asset a read named.

balances
object[]
required

One row per observed wallet and asset, ordered by chain, wallet, then asset.