---
title: Ledger
---

`GET /wallets/{address}/ledger`

**Request**

```http
GET /wallets/01a1f8d3-ea7b-7a12-8b34-56789abcdef0/ledger
```

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

This example tracks a wallet’s synthetic funds and simulated holdings.

1. Mine 1.003285026636055158 synthetic USD.
2. Sell 0.0005 USD for 0.008795 ZAR.
3. Buy 0.001 AAPL for 0.24937 USD.
4. Sell 0.001 AAPL for 0.25143 USD.
5. Mint 0.0015 QUARTZ with 0.0015 USD.
6. Transfer 0.001 QUARTZ to another wallet.

```json
{
  "meta": {
    "network": "bubblegum",
    "at": "2026-11-20T15:25:30.123000000Z",
    "pagination": {
      "next": null
    }
  },
  "data": {
    "public": [
      {
        "transaction": "01a1f98e-aefb-7a12-8b34-56789abcdef0",
        "from": "01a1f8d3-ea7b-7a12-8b34-56789abcdef0",
        "to": "01a1f8d3-ea7b-7a12-8b34-56789abcdef1",
        "asset": {
          "id": "QUARTZ",
          "units": "-0.001"
        },
        "created_at": "2026-11-20T15:24:00.123000000Z"
      },
      {
        "transaction": "01a1f98c-da3b-7300-87a1-000000000002",
        "asset": {
          "id": "QUARTZ",
          "units": "0.0015"
        },
        "created_at": "2026-11-20T15:22:00.123000002Z"
      },
      {
        "transaction": "01a1f98c-da3b-7300-87a1-000000000001",
        "asset": {
          "id": "fiat-USD",
          "units": "-0.0015"
        },
        "created_at": "2026-11-20T15:22:00.123000000Z"
      },
      {
        "transaction": "01a1f98b-057b-7d45-be67-89abcdef0002",
        "asset": {
          "id": "fiat-USD",
          "units": "0.25143"
        },
        "created_at": "2026-11-20T15:20:00.123000001Z"
      },
      {
        "transaction": "01a1f98b-057b-7d45-be67-89abcdef0001",
        "asset": {
          "id": "XNGS-AAPL",
          "units": "-0.001"
        },
        "created_at": "2026-11-20T15:20:00.123000000Z"
      },
      {
        "transaction": "01a1f986-719b-7c34-ad56-789abcdef002",
        "asset": {
          "id": "XNGS-AAPL",
          "units": "0.001"
        },
        "created_at": "2026-11-20T15:15:00.123000001Z"
      },
      {
        "transaction": "01a1f986-719b-7c34-ad56-789abcdef001",
        "asset": {
          "id": "fiat-USD",
          "units": "-0.24937"
        },
        "created_at": "2026-11-20T15:15:00.123000000Z"
      },
      {
        "transaction": "01a1f981-ddbb-7b23-9c45-6789abcdef02",
        "asset": {
          "id": "fiat-ZAR",
          "units": "0.008795"
        },
        "created_at": "2026-11-20T15:10:00.123000001Z"
      },
      {
        "transaction": "01a1f981-ddbb-7b23-9c45-6789abcdef01",
        "asset": {
          "id": "fiat-USD",
          "units": "-0.0005"
        },
        "created_at": "2026-11-20T15:10:00.123000000Z"
      },
      {
        "transaction": "01a1f8d4-d4db-8a12-8b34-56789abcdef1",
        "asset": {
          "id": "fiat-USD",
          "units": "1.003285026636055158"
        },
        "created_at": "2026-11-20T12:05:00.123000000Z"
      }
    ]
  }
}
```

| Output | Meaning and format |
| --- | --- |
| `transaction` | Ledger entry reference. UUIDv7 or UUIDv8 (RFC 9562), lowercase, 36 characters. |
| `from` | Sending wallet address for transfers. UUIDv7 (RFC 9562), lowercase, 36 characters. |
| `to` | Receiving wallet address for transfers. UUIDv7 (RFC 9562), lowercase, 36 characters. |
| `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` | Change in asset units. Plain decimal string, up to 18 decimal places; no trailing fractional zeros. Positive adds units; negative removes units. Maximum absolute value `340282366920938463463.374607431768211455`. |
| `created_at` | Entry recording time. RFC 3339 (ISO 8601 profile), UTC (`Z`), exactly 9 fractional digits. |
| `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 entries remain. |