GET /wallets/{address}/ledger
Request
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.
- Mine 1.003285026636055158 synthetic USD.
- Sell 0.0005 USD for 0.008795 ZAR.
- Buy 0.001 AAPL for 0.24937 USD.
- Sell 0.001 AAPL for 0.25143 USD.
- Mint 0.0015 QUARTZ with 0.0015 USD.
- Transfer 0.001 QUARTZ to another wallet.
{ "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. |