关于API将在充提记录接口增加“error-code”和“error-message”并增加“state”取值范围的通知

火币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用户需自行评估此以上接口改动对用户自身业务的适配，并更新相关应用。

所有变更将自本通知生效之日起更新至 Huobi API Docs。