---
title: Balances
---

`GET /wallets/{address}/balances`

**Request**

```http
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`**

```json
{
  "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. |