Stablecoins APIbetaWallet transfers

Get wallet transfer details

GET
/wallet-transfers/{id}

Fetch particular wallet transfer details, including its current status and, once executed, the settled target amount and rate.

Authorization

Bearer
headerAuthorizationBearer <JWT>

OAuth access token.

Path Parameters

id*string

Identifier of the wallet transfer.

Formatuuid

Header Parameters

X-Volt-Api-Version*1

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

Value in1

Response Body

OK - Successful request, returning given wallet transfer's details.

application/json
  1. response

A movement of funds between two of your wallets. Execution is asynchronous: settlement-dependent fields are null until the transfer completes; rate stays null for INTERNAL transfers.

id*string

Identifier of the wallet transfer.

Formatuuid
status*WalletTransferStatusEnum

Transfer status.

Value in"PENDING""PROCESSING""COMPLETED""FAILED"
type*WalletTransferTypeEnum

Transfer type, derived from the two wallets' currencies.

Value in"INTERNAL""CONVERSION"
internalReference*|

Identifier of the transfer in the partner's system, as supplied at creation.

source*

The debited side. amount is the requested amount and is always present.

target*

The credited side. amount is null until the transfer completes, then carries the settled credited amount.

rate*|

Settled conversion rate as an exact decimal string: 1 unit of the source currency equals rate units of the target currency. This field is null for INTERNAL transfers and until a CONVERSION executes.

failureReason*|

Why the transfer failed. This field is null unless status is FAILED.

Value in"REJECTED_BY_PROVIDER""INSUFFICIENT_FUNDS""WALLET_NOT_FOUND""WALLET_MERCHANT_MISMATCH""INTERNAL_ERROR"
createdAt*string

Date of transfer creation.

Formatdate-time
updatedAt*|

Date of transfer's last update.

Formatdate-time
Example Request
curl -X GET 'https://stablecoins.sandbox.volt.io/wallet-transfers/497f6eca-6276-4993-bfeb-53cbbbba6f08' \  -H 'X-Volt-Api-Version: 1'
Example Response
{  "id": "4d7e1a9c-3b5f-4e8d-a2c6-f0b4d8e2a6c0",  "status": "COMPLETED",  "type": "CONVERSION",  "internalReference": "inv-2214",  "source": {    "walletId": "0b8d3f21-7c4e-4a6d-8e2f-a9c1b3d5e7f0",    "currency": "USDC",    "amount": "100.500000"  },  "target": {    "walletId": "6a4f0c9e-2d1b-4c8a-9f3e-b7d2a1c4e5f6",    "currency": "EUR",    "amount": "91.83"  },  "rate": "0.918270",  "failureReason": null,  "createdAt": "2026-08-25T10:12:03+00:00",  "updatedAt": "2026-08-25T10:12:41+00:00"}

Create wallet transfer POST

Create new wallet transfer, moving funds from one of your wallets to another. The same currency on both sides executes as an `INTERNAL` book move; different currencies execute as a `CONVERSION` at the live rate. The type is derived, never supplied.

Get list of reports GET

Get list of your reports, oldest first. Pass `walletId` to filter by wallet.