> ## Documentation Index
> Fetch the complete documentation index at: https://docs.velafi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Crypto Deposits

> List on-chain crypto deposits into your VelaFi merchant wallets, newest first, filtered by token, transaction hash, merchant, and time range.

Use this endpoint to list crypto deposits received by your merchant wallets. Results are sorted newest first, and a single call returns up to `pageSize` records. To look further back, narrow the window with `startTime` and `endTime`.

> [!NOTE]
>
> All requests must include the `X-BH-TOKEN` header with a business token from `GET /v2/token/generate`.

## Endpoint

`GET https://api.velafi.com/v2/assets/depositOrders`

## Query Parameters

**merchantId** `number`

Filter by merchant ID.

**crypto** `string`

Filter by token symbol, for example `USDT`.

**txId** `string`

Filter by on-chain transaction hash.

**startTime** `number`

Only return deposits created at or after this time (Unix timestamp in milliseconds).

**endTime** `number`

Only return deposits created at or before this time (Unix timestamp in milliseconds).

**pageSize** `number` (default: 10)

Maximum number of records to return, from `1` to `1000`. Defaults to `10`.

## Response Fields

**code** `number`

`200` indicates success.

**msg** `string`

`SUCCESS` on success.

**data** `array`

**data item fields**

**orderId** `number`

Deposit record ID.

**merchantId** `number`

Merchant that received the deposit.

**time** `number`

Time the deposit record was created (Unix timestamp in milliseconds).

**crypto** `string`

Token symbol.

**cryptoName** `string`

Token name. Currently the same as `crypto`.

**cryptoAmount** `string`

Deposited amount.

**address** `string`

Currently returns the same value as `fromAddress` (the sending address), not your VelaFi deposit address.

**addressTag** `string`

Currently always an empty string.

**fromAddress** `string`

Sending address.

**fromAddressTag** `string`

Currently always an empty string.

**status** `number`

Deposit status:

* `1` — in progress
* `2` — successful
* `3` — failed or cancelled
* `4` — any other state

**txId** `string`

On-chain transaction hash.

**txIdUrl** `string`

Block-explorer link for the transaction.

## Example

```bash cURL theme={null}
curl -G https://api.velafi.com/v2/assets/depositOrders \
  -H "X-BH-TOKEN: YOUR_TOKEN" \
  --data-urlencode "merchantId=151209" \
  --data-urlencode "crypto=USDT" \
  --data-urlencode "pageSize=50"
```


## Related topics

- [Get Crypto Deposit Address](https://docs.velafi.com/api-reference/merchant/get-crypto-deposit-address.md)
- [List Crypto Withdrawals](https://docs.velafi.com/api-reference/crypto-wallet/get-crypto-withdrawal-history.md)
- [List Crypto Transfers](https://docs.velafi.com/api-reference/merchant/query-crypto-transfers.md)
- [List Fiat→Crypto Pairs](https://docs.velafi.com/api-reference/basic-configuration/get-fiat-crypto-pairs.md)
- [List Crypto→Fiat Pairs](https://docs.velafi.com/api-reference/basic-configuration/get-crypto-fiat-pairs.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.