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; once the limit is reached the request fails with 422.
Authorization
Bearer OAuth access token.
In: header
Header Parameters
It 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 <= 64Version of the API used. Currently, version 1 is the only version.
Value in
- 1
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/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"}