List crypto withdrawals

GET

/v1/wallet/crypto/withdraw/history

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

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

Parameters

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"

currency

Only withdrawals in this currency, e.g. USDC. Leave out for all currencies.

Type

string

Example"USDC"

Responses

OK

Content-Type

application/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"

},

{

"currency": "BTC",

"address": "bc1q7m3k9x2v5n8c4z6w1q0p3r5t7y9u2i4o6a8s0d",

"amount": "0.25",

"feeAmount": "0.0001",

"transactionHash": "16297f4bc279b9085dff06661db1c251012bdb1f6044587d923d71958a13edb3",

"confirmations": 6,

"lastConfirmationAt": "2026-10-20T11:47:05.662190",

"uniqueId": "3f8a6d2c-1b9e-4c7a-8e5d-2a4b6c8d0e1f",

"createdAt": "2026-10-20T10:58:19.027Z",

"verified": true,

"status": "Complete",

"networkType": "Bitcoin"

}

]

Samples

Errors

HTTP	Error	When
400	-11INVALID_REQUEST	skip 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.