提币历史

类型: GET 描述: /v4/withdraw/history

参数

名称	类型	是否必填	默认值	描述	取值范围
currency	string	是	N/A	币种名称，来自获取充提币支持币种接口
chain	string	是	N/A	转账网络，来自获取充提币支持币种接口
status	string	否	N/A	提币状态（参见depositWithdrawStatus）	SUBMIT, REVIEW, AUDITED, AUDITED_AGAIN, PENDING, SUCCESS, FAIL, CANCEL
fromId	long	否	N/A	上次分页ID，即记录的主键ID
direction	string	否	NEXT	分页方向	NEXT = 下一页，PREV = 上一页
limit	int	否	10	每页记录数（最大200）	1 ≤ limit ≤ 200
startTime	long	否	N/A	查询范围起始边界（毫秒时间戳）
endTime	long	否	N/A	查询范围结束边界（毫秒时间戳）

注意事项

• 支持使用 fromId + direction 进行分页。
• 每页限制数量可通过 limit 配置（默认10，最大200）。
• 支持使用 startTime 和 endTime 进行时间范围筛选。
• 状态值与充提币记录状态定义一致。

响应示例

响应

{
  "rc": 0,
  "mc": "string",
  "ma": [{}],
  "result": {
    "hasPrev": true, // 是否有上一页
    "hasNext": true, // 是否有下一页
    "items": [
      {
        "id": 763111, // 提币记录ID
        "clientOrderId": 10, // 客户端ID
        "type": 0, // 类型：CHAIN_TRANSFER - 区块链提币，INTERNAL_TRANSFER - 内部提币
        "currency": "usdt", // 币种
        "chain": "Ethereum", // 提币网络
        "address": "0xfa3abf", // 提币目标地址
        "memo": "",
        "status": "REVIEW", // 提币状态
        "amount": "30", // 提币数量
        "fee": "0", // 提币手续费
        "confirmations": 0, // 区块确认数
        "transactionId": "", // 交易哈希
        "createdTime": 1667763470000 // 提币申请时间（毫秒）
      },
      {
        "id": 763107,
        "clientOrderId": 10,
        "type": 0,
        "currency": "usdt",
        "chain": "Tron",
        "address": "TYnJJw",
        "memo": "",
        "status": "REVIEW",
        "amount": "50",
        "fee": "1",
        "confirmations": 0,
        "transactionId": "",
        "createdTime": 1667428286000
      }
    ]
  }
}