Stablecoins APIbetaWallets

Get wallet details

GET
/wallets/{id}

Fetch particular wallet details, including status, balance and deposit details.

Authorization

Bearer
AuthorizationBearer <token>

OAuth access token.

In: header

Path Parameters

id*string

Identifier of the wallet.

Formatuuid

Header Parameters

X-Volt-Api-Version*1

Version of the API used. Currently, version 1 is the only version.

Value in

  • 1

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/wallets/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "X-Volt-Api-Version: 1"

{  "id": "6a4f0c9e-2d1b-4c8a-9f3e-b7d2a1c4e5f6",  "name": "EUR settlement",  "type": "FIAT",  "status": "ACTIVE",  "currency": "EUR",  "balance": "48250.75",  "beneficiary": {    "name": "Acme Ltd",    "accountIdentifiers": {      "iban": "GB29NWBK60161331926819",      "swiftBic": "BARCGB22"    },    "bank": {      "name": "Barclays Bank UK PLC"    }  },  "isTargetWallet": true,  "createdAt": "2026-06-09T14:05:12+00:00",  "updatedAt": "2026-08-01T09:00:00+00:00"}

Create wallet POST

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`.

Update wallet PATCH

Update wallet: change its label and/or make it the target wallet.