> ## 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.

# 获取加密货币充值记录

> 列出转入您 VelaFi 商户钱包的链上加密货币充值记录，按时间倒序排列，可按代币、交易哈希、商户和时间范围筛选。

使用此接口列出您的商户钱包收到的加密货币充值记录。结果按时间倒序排列，单次调用最多返回 `pageSize` 条记录。如需查询更早的记录，请使用 `startTime` 和 `endTime` 缩小时间窗口。

> [!NOTE]
>
> 所有请求都必须在 `X-BH-TOKEN` 请求头中携带通过 `GET /v2/token/generate` 获取的业务令牌。

## 接口地址

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

## 查询参数

**merchantId** `number`

按商户 ID 筛选。

**crypto** `string`

按代币符号筛选，例如 `USDT`。

**txId** `string`

按链上交易哈希筛选。

**startTime** `number`

仅返回在此时间或之后创建的充值记录（Unix 毫秒时间戳）。

**endTime** `number`

仅返回在此时间或之前创建的充值记录（Unix 毫秒时间戳）。

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

返回的最大记录数，取值范围 `1` 到 `1000`。默认为 `10`。

## 响应字段

**code** `number`

`200` 表示成功。

**msg** `string`

成功时为 `SUCCESS`。

**data** `array`

**data 元素字段**

**orderId** `number`

充值记录 ID。

**merchantId** `number`

收到该笔充值的商户。

**time** `number`

充值记录的创建时间（Unix 毫秒时间戳）。

**crypto** `string`

代币符号。

**cryptoName** `string`

代币名称。目前与 `crypto` 相同。

**cryptoAmount** `string`

充值金额。

**address** `string`

目前返回与 `fromAddress`（发送地址）相同的值，而不是您的 VelaFi 充值地址。

**addressTag** `string`

目前始终为空字符串。

**fromAddress** `string`

发送地址。

**fromAddressTag** `string`

目前始终为空字符串。

**status** `number`

充值状态：

* `1` — 处理中
* `2` — 成功
* `3` — 失败或已取消
* `4` — 其他任何状态

**txId** `string`

链上交易哈希。

**txIdUrl** `string`

该交易的区块浏览器链接。

## 示例

```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

- [获取加密货币充值地址](https://docs.velafi.com/cn/api-reference/merchant/get-crypto-deposit-address.md)
- [获取加密货币提现记录](https://docs.velafi.com/cn/api-reference/crypto-wallet/get-crypto-withdrawal-history.md)
- [获取加密货币划转记录](https://docs.velafi.com/cn/api-reference/merchant/query-crypto-transfers.md)
- [获取加密货币列表](https://docs.velafi.com/cn/api-reference/basic-configuration/get-list-of-crypto-currencies.md)
- [获取加密货币/法币报价](https://docs.velafi.com/cn/api-reference/quote/get-user-quote-for-crypto-fiat.md)


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