Skip to content

Ledger

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.

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