Create wallet
Create new wallet for the given currency.
Whether the wallet is FIAT or CRYPTO is derived from the currency automatically. The first wallet a customer creates becomes the target wallet; later wallets never do.
A customer can hold at most 25 wallets.
BearerAuthorizationBearer <JWT>OAuth access token.
Idempotency-Key*stringIt helps prevent duplicates in your POST requests.
We recommend using a UUID for the key, however you may use any other unique identifier you choose.
1 <= length <= 64X-Volt-Api-Version*1Version of the API used. Currently, version 1 is the only version.
1application/json- body
name*stringWallet label, 3 to 100 characters, not blank.
3 <= length <= 100currency*stringCurrency of the wallet: an ISO 4217 code for FIAT or a token symbol for CRYPTO. The wallet type is derived automatically.
"EUR""GBP""USD""USDC""EURC""USDT"Created - The wallet was created, returning wallet details.
application/json- response
id*stringIdentifier of the wallet.
uuidname*stringWallet label, either supplied at creation or generated ("<currency> wallet", e.g. "USDC wallet").
type*"FIAT"Wallet type.
"FIAT"status*WalletStatusEnumWallet status.
"ACTIVE""INACTIVE""TERMINATED"currency*stringCurrency of the wallet: an ISO 4217 code for FIAT or a token symbol for CRYPTO.
"EUR""GBP""USD""USDC""EURC""USDT"balance*|Current balance as an exact decimal string in major units: 2 decimal places for FIAT wallets, up to 6 for CRYPTO wallets. This field is null when the balance is temporarily unavailable.
beneficiary*|Information about the target account (beneficiary) for bank transfers into this wallet. This field is null until the details exist, for example while the wallet is INACTIVE and its bank details are still being provisioned.
isTargetWallet*booleanWhether this is the target wallet, which incoming stablecoin payments are credited to by default. Only one wallet per customer is the target wallet at a time.
createdAt*stringDate of wallet creation.
date-timeupdatedAt*|Date of wallet's last update.
date-timecurl -X POST 'https://stablecoins.sandbox.volt.io/wallets' \ -H 'Idempotency-Key: 85136c79cbf9fe36bb9d05d0639c70c265c18d37' \ -H 'X-Volt-Api-Version: 1' \ -H 'Content-Type: application/json' \ -d '{ "name": "My EUR wallet", "currency": "EUR"}'{ "id": "3f9c1a7e-5b2d-4e8f-a1c6-d4b7e2f9a0c3", "name": "My EUR wallet", "type": "FIAT", "status": "INACTIVE", "currency": "EUR", "balance": "0.00", "beneficiary": null, "isTargetWallet": true, "createdAt": "2026-08-24T09:15:42+00:00", "updatedAt": "2026-08-24T09:15:42+00:00"}