GET /wallets/{address}/balances
Request
GET /wallets/01a1f8d3-ea7b-7a12-8b34-56789abcdef0/balances| Input | Meaning and format |
|---|---|
address |
Wallet address. UUIDv7 (RFC 9562), lowercase, 36 characters. |
cursor |
Optional query parameter. Use meta.pagination.next to continue. String. |
Up to 100 entries per page.
Response: 200 OK
{ "meta": { "network": "bubblegum", "at": "2026-11-20T15:26:00.123000000Z", "pagination": { "next": null } }, "data": { "public": [ { "asset": { "id": "fiat-USD", "units": "1.003345026636055158" } }, { "asset": { "id": "fiat-ZAR", "units": "0.008795" } }, { "asset": { "id": "XNGS-AAPL", "units": "0" } }, { "asset": { "id": "QUARTZ", "units": "0.0005" } } ] }}| Output | Meaning and format |
|---|---|
asset.id |
Asset ID: QUARTZ, fiat-{currency}, crypto-{symbol}, or {MIC}-{symbol}. Currency: uppercase ISO 4217; MIC: uppercase ISO 10383. Maximum 128 UTF-8 bytes. |
asset.units |
Units held in the simulated wallet. Plain decimal string, up to 18 decimal places; no trailing fractional zeros. Range: 0 to 340282366920938463463.374607431768211455. |
network |
Selected network. String. |
at |
Response time. RFC 3339 (ISO 8601 profile), UTC (Z), exactly 9 fractional digits. |
pagination.next |
Cursor for the next page. String, or null when no more balances remain. |