WalletD developers
Ledger and reporting

Balance totals per owner type and purpose — the float equation view (admin)

Balances grouped by owner type, purpose and commodity, with the account count behind each row and the tenant's fee plan — the float view an operator reconciles against.

GET/v1/ledger/summary

Balances grouped by owner type, purpose and commodity, with the account count behind each row and the tenant's fee plan — the float view an operator reconciles against. Requires ledger:read and a machine or staff principal; a user token is refused forbidden (403).

Authorization

bearerAuth
AuthorizationBearer <token>

A tenant API key (sk_{env}_{id}_{secret}), a wallet user token, or an IdP access token. Which principal the credential resolves to decides the scopes it carries; see the authentication guide.

In: header

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

curl -X GET "https://example.com/v1/ledger/summary"
{  "currency": "string",  "rows": [    {      "owner_type": "string",      "purpose": "string",      "commodity": "string",      "balance": 0,      "accounts": 0    }  ],  "fee_plan": {    "fees": {      "payment": {        "bps": 0,        "flat": 0,        "min_fee": 0,        "max_fee": 0      },      "subscription": {        "bps": 0,        "flat": 0,        "min_fee": 0,        "max_fee": 0      },      "commission": {        "bps": 0,        "flat": 0,        "min_fee": 0,        "max_fee": 0      },      "p2p": {        "bps": 0,        "flat": 0,        "min_fee": 0,        "max_fee": 0      },      "topup": {        "bps": 0,        "flat": 0,        "min_fee": 0,        "max_fee": 0      },      "payout": {        "bps": 0,        "flat": 0,        "min_fee": 0,        "max_fee": 0      }    },    "commission_mode": "deduct"  }}