List crypto deposits

GET

/v1/wallet/crypto/deposit/history

Requires DEPOSITS_READ, granted by TREASURY_READ or TREASURY_WRITE (bundles)

Returns crypto deposits to the account the request acts on (your primary account, or the sub-account selected with X-VALR-SUB-ACCOUNT-ID), newest first, including deposits still waiting for confirmations. Filter by currency with currency.

Parameters

Query Parameters

skip

Number of deposits to skip, for paging.

Type

integer

Example0

Default

0

limit

Maximum number of deposits to return, up to 100.

Type

integer

Example100

Default

100

startTime

Only deposits detected at or after this time (ISO 8601, UTC).

Type

string

Example"2026-10-01T00:00:00Z"

Format

"date-time"

endTime

Only deposits detected before this time (ISO 8601, UTC).

Type

string

Example"2026-11-01T00:00:00Z"

Format

"date-time"

currency

Only deposits in this currency, e.g. USDT. Leave out for all currencies.

Type

string

Example"USDT"

Responses

OK

Content-Type

application/json

[

{

"currencyCode": "USDT",

"networkType": "Ethereum",

"receiveAddress": "0x5b3f9a1c2e7d48a6b0c4e9f1a2d3b4c5e6f70812",

"transactionHash": "0x5c5cd31c2f3ad5bf9ad71fa665e55033ae42f046d7c8124c25a234265190901e",

"amount": "250",

"createdAt": "2026-10-23T08:40:02Z",

"confirmations": 3,

"confirmed": false

},

{

"currencyCode": "USDT",

"networkType": "Ethereum",

"receiveAddress": "0x5b3f9a1c2e7d48a6b0c4e9f1a2d3b4c5e6f70812",

"transactionHash": "0x532c1d6c2d1aaae73bfbd818126c4853b0af2a081ad72ccbf716094a011e6bbc",

"amount": "1500",

"createdAt": "2026-10-22T14:03:19Z",

"confirmations": 12,

"confirmed": true,

"confirmedAt": "2026-10-22T14:06:41.205Z"

},

{

"currencyCode": "BTC",

"networkType": "Bitcoin",

"receiveAddress": "bc1q4u7h2kz9x8w3n5e6r0t2y7m8c9v3f5g6j8k2l0",

"transactionHash": "c61bd9c633f3dc91eaf6bec6c3812b5542bf83a243076954f10a743a48d5f48e",

"amount": "0.05",

"createdAt": "2026-10-21T09:12:44Z",

"confirmations": 6,

"confirmed": true,

"confirmedAt": "2026-10-21T10:08:13.917Z"

}

]

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.