Business API

Appearance

List crypto withdrawals for a currency​

GET
/v1/wallet/crypto/{currency}/withdraw/history

Requires WITHDRAWALS_READ, granted by TREASURY_READ or TREASURY_WRITE or WITHDRAWALS_WRITE or BANK_ACCOUNTS_WRITE (bundles)

Returns withdrawals of one currency from the account the request acts on (your primary account, or the sub-account selected with X-VALR-SUB-ACCOUNT-ID), newest first. Cancelled withdrawals are left out, so a page can hold fewer than limit items.

Parameters​

Path Parameters

currency*

Currency of the withdrawals, e.g. USDC.

Type
string
Required
Example"USDC"

Query Parameters

skip

Number of withdrawals to skip, for paging.

Type
integer
Example0
Default
0
limit

Maximum number of withdrawals to return, up to 100.

Type
integer
Example100
Default
100
startTime

Only withdrawals created at or after this time (ISO 8601, UTC).

Type
string
Example"2026-10-01T00:00:00Z"
Format
"date-time"
endTime

Only withdrawals created before this time (ISO 8601, UTC).

Type
string
Example"2026-11-01T00:00:00Z"
Format
"date-time"

Responses​

OK

application/json
JSON
[
{
"currency": "USDC",
"address": "0x2a7c4e9b1d3f5a6c8e0b2d4f6a8c0e2b4d6f8a1c",
"amount": "1200",
"feeAmount": "1.5",
"confirmations": 0,
"uniqueId": "e4b2a1c9-8d7f-4e3a-b6c5-0f9e8d7c6b5a",
"createdAt": "2026-10-23T09:02:37.106Z",
"verified": true,
"status": "Processing",
"networkType": "Ethereum"
},
{
"currency": "USDC",
"address": "0x8d3f2b6a91c04e7fa1b2c3d4e5f60718293a4b5c",
"amount": "250",
"feeAmount": "1.5",
"transactionHash": "0x5901a831de792a71a309438bd8ada659952c7662f1c130a74dd1852906971a84",
"confirmations": 12,
"lastConfirmationAt": "2026-10-23T08:21:47.318205",
"uniqueId": "7c1d9e42-5a3b-4f6e-9d8c-2b1a0f3e4d5c",
"createdAt": "2026-10-23T08:15:02.441Z",
"verified": true,
"status": "Complete",
"networkType": "Ethereum"
}
]

Samples​

Errors

HTTPErrorWhen
400-11INVALID_REQUESTskip or limit isn't a whole number, limit is more than 100, startTime or endTime isn't an ISO 8601 timestamp, or the currency isn't recognised.

Plus the errors common to all signed endpoints.