List crypto deposits for a currency

GET

/v1/wallet/crypto/{currency}/deposit/history

Requires DEPOSITS_READ, granted by TREASURY_READ or TREASURY_WRITE (bundles)

Returns deposits of one currency 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.

Parameters

Path Parameters

currency*

Currency of the deposits, e.g. USDT.

Type

string

Required

Example"USDT"

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"

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"

}

]

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.