Ledger

The ledger is an append-only record of every movement across your wallets: credit (funds in from a paid order), debit (funds out), fee (platform fee), and settlement (on-chain sweep accounting). Each entry snapshots the wallet balance immediately after it was applied.

For non-custodial on-chain direct settlement — the model for external merchants — funds settle on-chain straight to your own wallet. Each paid order records the credit and fee, then a negative settlement entry that nets the on-chain currency's platform balance back to ~0, because the net never sits on the platform: there is no withdrawable credit balance for those currencies. The credit / debit / fee entries that accrue into a withdrawable balance apply only to operator-internal custodial flows.

The ledger entry model

Name
id
Type
string
Description
The entry id, prefixed led_.
Name
wallet_id
Type
string
Description
The wallet this entry affected.
Name
order_id
Type
string
Description
The related order, when the entry came from one.
Name
type
Type
string
Description
credit (funds in from a paid order), debit (funds out — payout/refund), fee (platform fee), or settlement (on-chain sweep accounting).
Name
amount
Type
string
Description
The signed movement amount, as a decimal string.
Name
balance_after
Type
string
Description
Wallet balance immediately after this entry.
Name
currency
Type
string
Description
The entry's currency / asset.
Name
reference
Type
string
Description
Free-text reference (e.g. a tx hash or refund note).
Name
created_at
Type
timestamp
Description
When the entry was recorded.

GET/api/v1/ledger

List ledger entries

API keyAPI secret

Signed locally — your secret stays in this browser and is never sent or stored.

No keys yet? Create an API key pair in the merchant portal — the secret is shown only once. Open the merchant portal →

Query string

Return a paginated list of your ledger entries, newest first.

Optional attributes

Name
limit
Type
integer
Description
Page size. Default 20, max 200.
Name
offset
Type
integer
Description
Records to skip. Default 0.

Request

GET

/api/v1/ledger

curl -G "$BASE/api/v1/ledger" \
  -d limit=20 \
  -H "X-Api-Key: $KEY_ID" \
  -H "X-Timestamp: $TS" \
  -H "X-Signature: $SIG"

Response

{
  "data": [
    {
      "id": "led_8a",
      "wallet_id": "wlt_1",
      "order_id": "ord_2Zx9Qw8sUaM2",
      "type": "credit",
      "amount": "48.40",
      "balance_after": "48.40",
      "currency": "USDT",
      "reference": "order order-1001",
      "created_at": "2026-06-11T08:30:00Z"
    },
    {
      "id": "led_8b",
      "wallet_id": "wlt_1",
      "order_id": "ord_2Zx9Qw8sUaM2",
      "type": "fee",
      "amount": "-1.50",
      "balance_after": "46.90",
      "currency": "USDT",
      "created_at": "2026-06-11T08:30:00Z"
    },
    {
      "id": "led_8c",
      "wallet_id": "wlt_1",
      "order_id": "ord_2Zx9Qw8sUaM2",
      "type": "settlement",
      "amount": "-46.90",
      "balance_after": "0.00",
      "currency": "USDT",
      "reference": "swept on-chain to merchant wallet",
      "created_at": "2026-06-11T08:30:00Z"
    }
  ],
  "total": 412,
  "limit": 20,
  "offset": 0
}