Skip to main content

Wallets API

Wallets represent logical balance containers associated with an account.

List wallets​

GET /v1/wallets?account_id=acct_8mJ3

Wallet object​

{
  "id": "wlt_2Gk4...",
  "account_id": "acct_8mJ3...",
  "type": "operating",
  "currency": "EUR",
  "status": "active",
  "created_at": "2026-06-01T09:00:00Z"
}

Get balances​

GET /v1/wallets/{wallet_id}/balances
{
  "wallet_id": "wlt_2Gk4...",
  "balances": [
    {
      "currency": "EUR",
      "available": "98000.00",
      "pending": "2500.00",
      "reserved": "1000.00",
      "restricted": "0.00"
    }
  ]
}

Ledger entries​

GET /v1/wallets/{wallet_id}/ledger-entries

Ledger entries are the recommended source for reconciliation because they represent actual balance movements.

Create internal transfer​

POST /v1/wallet-transfers
{
  "from_wallet_id": "wlt_source...",
  "to_wallet_id": "wlt_target...",
  "amount": "1000.00",
  "currency": "EUR",
  "reference": "Treasury rebalance"
}

Internal transfers are available only where enabled and permissioned.