跳到主要内容

获取充值和提现历史

API说明​

此接口允许用户检索指定交易品种的充值和提现记录摘要，包括金额、状态、链和转账方式。

注意：充值和提现历史数据只能通过 RESTful API 获取。

注意事项​

无

认证​

这是一个私有接口，需要认证。有关使用RESTful API的详细信息，请参考简介 > 认证和代码示例 > 现货 > RESTful私有接口。

请求方法​

POST

接口地址​

/api/v1/private?command=returnDepositsWithdrawals

频率限制​

该接口的调用频率限制为：每个用户 ID 每秒最多请求3次。
此外，该接口还受到全局频率限制的约束。
有关"全局速率限制"和"API限频策略"的详细信息，请参阅“频率限制”部分，跳转

请求参数​

参数必填类型描述
symbolTrueString币种。可同时输入多个币种，需使用逗号进行分隔。
示例："BTC,ETH"
注意：每次请求最多可输入 20 个币种
depositNumberFalseString充值记录的唯一ID

响应参数​

参数类型描述
amountString数量
chainString区块链名称
sideInteger1：充值，2：提现
depositNumberString充值记录的唯一ID
addressString充值和提现地址
txidString交易哈希
memoString备注地址
currencyString货币名称
timeLong充值和提现时间
confirmationsString确认数
statusString状态：
1：等待提现，3：提现成功，4：用户提现
destString提现方式：
on_chain：链上提现，
internal_transfer：内部转账
fromAddressString提现发起者的UID
toAddressString接收方信息。
如果"dest"是"on_chain"，这参数是一个链上地址。
如果"dest"是"internal_transfer"，这参数是一个UID、电子邮件地址或电话号码。

请求示例​

以下Python代码展示了如何获取充值和提现记录。

注意：完整代码示例请参考简介 > 认证和代码示例 > 现货 > RESTful私有接口。

api_url = "/api/v1/private?command=returnDepositsWithdrawals"
method = "post"
params = {"symbol":  "BTC,USDT",
         # "depositNumber" :  "" 
         }
SpotRestfulPrivate(host, api_url, method, api_key, params, secret_key)  # 函数SpotRestfulPrivate()在章节(简介 > 认证和代码示例 > 现货 > RESTful私有接口)中定义

注意：完整Java代码示例请参考简介 > 认证和代码示例 > 现货 > RESTful私有接口。

响应示例​

以下是上述Python请求返回的示例响应：

{
 "code":"200",
 "data":[
 {
      "amount": "5.00000000",
      "chain": "TRC20",
      "side": 2,
      "depositNumber": *******,
      "address": "**********************",
      "txid": null,
      "memo": "备注123",
      "currency": "USDT",
      "time": 1763308897000,
      "confirmations": 0,
      "status": 4
    },
    {
      "amount": "0.00100000",
      "chain": "",
      "side": 1,
      "depositNumber": *******,
      "address": "**********",
      "txid": "*****************",
      "memo": null,
      "currency": "BTC",
      "time": 1762166355000,
      "confirmations": 0,
      "status": 4
    },
 ],
 "msg":"SUCCESS"
 }