USDT本位永续合约API接入文档说明

2020-10-21 17:01:03

API用户,请关注如下链接:

【合约交易网站地址】

https://futures.huobi.fmhttps://www.btcgateway.pro

【API访问地址】

https://api.hbdm.com

中国大陆推荐使用:https://api.btcgateway.pro

【合约帮助中心https://support.hbfile.net/hc/zh-cn/categories/360000032161

【API文档地址】https://docs.huobigroup.com/docs/usdt_swap/v1/cn/#api

【Java DEMO地址】https://github.com/hbdmapi/huobi_usdt_swap_Java

【Python DEMO地址】https://github.com/hbdmapi/hbdm_Python

【Postman DEMO地址】https://github.com/hbdmapi/huobi_futures_Postman

备注:USDT本位永续合约代码使用方式与币本位永续和交割合约类似,其他语言demo可以参考交割合约。

 

完整API示例:

获取USDT本位永续合约市场最近成交记录:https://api.hbdm.com/linear-swap-ex/market/trade?contract_code=BTC-USDT
获取USDT本位永续合约行情深度数据:https://api.hbdm.com/linear-swap-ex/market/depth?contract_code=BTC-USDT&type=step0

 

访问次数限制

  • 币本位永续合约和交割合约分开限频

  • 公开行情接口和用户私有接口都有访问次数限制

  • 普通用户,需要密钥的私有接口,每个UID 3秒最多30次请求(该UID的所有币种的合约的所有私有接口共享3秒30次的额度)

  • 其他非行情类的公开接口,比如获取指数信息,限价信息,交割结算、平台持仓信息等,所有用户都是每个IP3秒最多120次请求(所有该IP的非行情类的公开接口请求共享3秒120次的额度)

  • 行情类的公开接口,比如:获取K线数据、获取聚合行情、市场行情、获取行情深度数据、获取溢价指数K线、获取实时预测资金费率k线,获取基差数据、获取市场最近成交记录:
    1. restful接口:同一个IP, 1秒最多800个请求
    2. websocket:req请求,同一时刻最多请求50次;sub请求,无限制,服务器主动推送数据
  • WebSocket私有订单成交推送接口(需要API KEY验签)

    一个UID最多同时建立30个私有订单成交推送WS链接。该用户在一个品种(包含该品种的所有周期的合约)上,仅需要维持一个订单推送WS链接即可。
    注意: 订单推送WS的限频,跟用户RESTFUL私有接口的限频是分开的,相互不影响。
  • 所有API接口返回数据中增加限频信息

    将在api接口response中的header返回以下字段:

    ratelimit-limit: 单轮请求数上限,单位:次数

    ratelimit-interval:请求数重置的时间间隔,单位:毫秒

    ratelimit-remaining:本轮剩余可用请求数,单位:次数

    ratelimit-reset:请求数上限重置时间,单位:毫秒

    如果触发了撤单率限制,您的api接口response返回header中会包括字段:

    recovery-time:禁用的恢复时间戳,单位为毫秒,表示禁用结束时间,可恢复访问的时间戳;

    如果不在禁用期间,header不返回recovery-time字段;

  • 一个uid对应计划委托下单接口请求1秒5次、一个uid对应计划委托撤单接口请求1秒5次、一个uid对应计划委托全部撤单接口请求1秒5次。

 

加入火币合约社群请点击>>>

火币合约官方推特请点击>>>

火币合约官方验证通道请点击>>>

下载iPhone版火币APP请点击>>>

下载Android版火币APP请点击>>>

免责声明:

1.资讯内容不构成投资建议,投资者应独立决策并自行承担风险

2.本文版权归属原作所有,仅代表作者本人观点,不代币币情的观点或立场