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
AuthorizationBearer <token>

OAuth access token.

In: header

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 in

  • 1

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/wallet-transfers/497f6eca-6276-4993-bfeb-53cbbbba6f08" \  -H "X-Volt-Api-Version: 1"
{  "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. Execution is asynchronous: `201` returns the transfer in `PENDING` and funds have not moved yet. Poll the transfer until it reaches `COMPLETED` or `FAILED`. Insufficient balance is discovered during execution and surfaces as `FAILED`.

Channel payment status change notification Webhook

Sent to the notification URL when it was provided at related channel creation; otherwise to the webhook URL configured in Fuzebox. | Type | Description | |-------|-------------| | `channel_payment_detected` | Deposit seen on-chain, awaiting confirmation and crediting (`status` `PROCESSING`) | | `channel_payment_completed` | Deposit credited to the wallet (`status` `COMPLETED`) | | `channel_payment_cancelled` | Deposit cancelled or rejected (`status` `CANCELLED`) | `channel_payment_detected` is **not guaranteed**: when a deposit reaches its final state before the detection could be announced (for example, the confirmation arrived first), only the terminal webhook is sent. Treat `channel_payment_completed` and `channel_payment_cancelled` as the source of truth, and do not rely on receiving `channel_payment_detected` beforehand.