关于API将在充提记录接口增加“error-code”和“error-message”并增加“state”取值范围的通知
2020/06/11 13:15
- API 公告
火币Global将调整现有REST API节点“GET /v1/query/deposit-withdraw”，详细如下：
1、在现有返回字段的基础上，新增“error-code”和“error-message”，以支持用户可查提币失败的原因。
2、返回字段“state” ,取值范围新增“verifying”和“failed”，以对风控校验的进度进行说明。
生效日期：2020年6月11日（GMT+8）
具体变更细节及参数要求，请参考API文档：https://huobiapi.github.io/docs/spot/v1/cn/
火币全球站
2020年6月11日
充提记录查询接口
GET /v1/query/deposit-withdraw
请求参数：
无变化
响应参数：
| 参数名称 | 是否必须 | 数据类型 | 描述 | 取值范围 |
| status | true | string | "ok" or "error" | |
| err-code | false | string | 错误码（如有） | |
| err-msg | false | string | 错误描述（如有） | |
| date | true | list | ||
| { id | true | long | 充币订单id | |
| type | true | string | 类型 | 'deposit', 'withdraw', 子用户仅有deposit |
| currency | true | string | 币种 | |
| tx-hash | true | string | 交易哈希 | |
| chain | true | string | 链名称 | |
| amount | true | float | 个数 | |
| address | true | string | 地址 | |
| address-tag | true | string | 地址标签 | |
| fee | true | float | 手续费 | |
| state | true | string | 状态 | 状态参见下表 |
| error-code | false | string | 提币失败错误码，仅type为”withdraw“，且state为”reject“、”wallet-reject“和”failed“时有 | |
| error-msg | false | string | 提币失败错误描述，仅type为”withdraw“，且state为”reject“、”wallet-reject“和”failed“时有 | |
| created-at | true | long | 发起时间 | |
| updated-at } | true | long | 最后更新时间 |
虚拟币充值状态定义：
无变化
虚拟币提币状态定义：
| 状态 | 描述 |
| verifying | 待验证 |
| failed | 验证失败 |
| submitted | 已提交 |
| reexamine | 审核中 |
| canceled | 已撤销 |
| pass | 审批通过 |
| reject | 审批拒绝 |
| pre-transfer | 处理中 |
| wallet-transfer | 已汇出 |
| wallet-reject | 钱包拒绝 |
| confirmed | 区块已确认 |
| confirm-error | 区块确认错误 |
| repealed | 已撤销 |
API用户需自行评估此以上接口改动对用户自身业务的适配，并更新相关应用。
所有变更将自本通知生效之日起更新至 HTX API Docs。
客服邮箱 [email protected]
