Wallets

Wallets are currency-denominated accounts that hold funds. Each wallet has a single currency and tracks balances including pending holds.

Create a wallet

POST /api/v1/wallet

{
  "name": "Operating Account",
  "currency_id": "USD",
  "description": "Main USD operating wallet"
}

Get wallet details

GET /api/v1/wallet/{wallet_id}

Response

{
  "id": "wal_abc123",
  "name": "Operating Account",
  "company_id": "comp_xyz",
  "currency": {
    "code": "USD",
    "name": "US Dollar",
    "currency_type": "fiat",
    "symbol": "$"
  },
  "status": "active",
  "created_at": "2026-06-01T10:00:00Z"
}

Check balance

GET /api/v1/wallet/{wallet_id}/balance

{
  "wallet_id": "wal_abc123",
  "balance": 5000000,
  "pending_holds": 0,
  "pending_in": 100000,
  "pending_out": 50000,
  "available_balance": 4950000,
  "currency_code": "USD"
}

Field	Description
balance	Total balance in minor units.
pending_holds	Funds held for pending operations.
pending_in	Incoming funds not yet settled.
pending_out	Outgoing funds not yet completed.
available_balance	Funds available for withdrawal or transfer.

List all wallets

GET /api/v1/wallets

Returns all wallets for your company.

List all balances

GET /api/v1/wallets/balances

Returns balance summaries for all wallets in a single call.