Wallets
Hold stablecoin and fiat balances for use across the Stablecoins API
Overview
A wallet holds a stablecoin or fiat balance and is the account every other stablecoin operation references — channels credit one, payouts debit one, and wallet transfers move funds between two.
A customer can hold at most 25 wallets.
Create the wallet
Requires an Idempotency-Key header.
| Field | Type | Required | Description |
|---|---|---|---|
name | String | Yes | Wallet label, 3–100 characters. |
currency | String | Yes | EUR, GBP, USD, USDC, EURC or USDT. The wallet's type (FIAT or CRYPTO) is derived from this automatically. |
{
"name": "My EUR wallet",
"currency": "EUR"
}{
"id": "6a4f0c9e-2d1b-4c8a-9f3e-b7d2a1c4e5f6",
"name": "My EUR wallet",
"type": "FIAT",
"status": "INACTIVE",
"currency": "EUR",
"balance": null,
"isTargetWallet": true,
"createdAt": "2026-06-09T14:05:12+00:00",
"updatedAt": null
}The first wallet you create automatically becomes your target wallet — the wallet incoming stablecoin payments are credited to by default. Later wallets never do; set one explicitly via Updating a wallet if you need to change it.
Track provisioning
A new wallet starts INACTIVE while Volt provisions its deposit details — a bank account for a FIAT wallet, an on-chain address for a CRYPTO wallet — then activates automatically once ready. Poll the wallet until its status becomes ACTIVE:
The response also includes beneficiary (for a FIAT wallet) or crypto (for a CRYPTO wallet), each null until provisioning completes.
Wallet statuses
| Status | Description |
|---|---|
ACTIVE | The wallet is usable. |
INACTIVE | Not yet usable, typically while being provisioned; activates automatically. |
TERMINATED | Permanently closed; cannot be reactivated. |
Updating a wallet
PATCH /wallets/{id} renames a wallet, reassigns the target-wallet designation, or both — fields are applied independently, and at least one must be provided. The current target wallet can't be unset directly; set a different wallet as the target instead.
Reference
Full wallets API reference can be found .
How is this guide?
Last updated on