Wallets

A wallet holds your balance for a single currency. As a merchant you settle non-custodially: on-chain channels send the net straight to your own wallet address, so your platform balance stays at ~0 — there is nothing to hold or pay out. Custodial withdrawable balances apply only to operator-internal custodial channels, not to merchant settlement.

The wallet model

Name
id
Type
string
Description
The wallet id, prefixed wlt_.
Name
currency
Type
string
Description
The wallet's currency / asset, e.g. USDT.
Name
balance
Type
string
Description
Available balance, as a decimal string.
Name
pending_balance
Type
string
Description
Balance awaiting confirmation or settlement.
Name
updated_at
Type
timestamp
Description
When the wallet last changed.

GET/api/v1/wallets

List wallets

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 your per-currency wallet balances as a plain data array.

Request

GET

/api/v1/wallets

curl "$BASE/api/v1/wallets" \
  -H "X-Api-Key: $KEY_ID" \
  -H "X-Timestamp: $TS" \
  -H "X-Signature: $SIG"

Response

{
  "data": [
    {
      "id": "wlt_1",
      "currency": "USDT",
      "balance": "0",
      "pending_balance": "0",
      "updated_at": "2026-06-11T08:30:00Z"
    }
  ]
}