关于API上线新版稳定币兑换接口的通知

尊敬的用户:

因为系统升级了原有的稳定币兑换策略,所以API 接口也需要随着进行变更,将新增两条稳定币兑换相关接口,并停用之前原有的稳定币兑换相关接口。

生效日期:2019年9月13日(GMT+8)
具体变更细节及参数要求,请参考【API文档】

火币全球站
2019年9月12日

以下为变更细则:
1、GET v1/stable-coin/quote
稳定币兑换价格查询
API权限:读取

请求参数

参数数据类型是否必填描述备注
currencystring与HUSD兑换的稳定币币种USDT/PAX/USDC/TUSD
amountstring与HUSD兑换的稳定币币种数量amount必须为整数
typestring兑换方向buy兑入/sell兑出

响应参数

返回参数数据类型描述备注
currencystring与HUSD兑换的稳定币币种USDT/PAX/USDC/TUSD
amountstring可与HUSD兑换的稳定币币种数量因兑换账户额度等因素影响,返回的amount可能会比请求的amount小
typestring兑换方向buy兑入/sell兑出
exchange-amountstring匹配的HUSD数量type=buy时,exchangeAmount为用户所需支付的husd数量;type=sell时,exchangeAmount为用户可获得的husd数量
quote-idstring该次稳定币报价唯一ID 
expirationstring确认兑换有效期时间(一般为接口请求时间向后延伸10秒)

错误码

响应码说明
invalid-currency币种无效
invalid-amount币种数量小于最低值(10万)或大于当前可兑换额度
invalid-typetype不为sell或buy
quote-failure后端其他错误引起的后端其他错误引起的价格查询失败

2、POST v1/stable-coin/exchange
兑换稳定币
API权限:交易

请求参数

参数数据类型是否必填描述备注
quote-idstring该次稳定币报价唯一ID 

响应参数

返回参数数据类型描述备注
transact-idlong兑换记录ID 
currencystring与HUSD兑换的稳定币币种USDT/PAX/USDC/TUSD
amountstring与HUSD兑换的稳定币币种数量 
typestring兑换方向buy兑入/sell兑出
exchange-amountstring匹配的HUSD数量type=buy时,exchangeAmount为用户支付的husd数量;type=sell时,exchangeAmount为用户获得的husd数量
timelong时间戳 

错误码

响应码说明
invalid-quote-id无效的quote-id
insufficient-balance可用余额不足
insufficient-quota稳定币限额不足/超出稳定币限额
exchange-failure后端其他错误引起的兑换失败
Base-user-request-exceed-limit您的操作太频繁,请稍后再试