Skip to content

Balances

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.