API用户,请关注如下链接:
【合约交易网站地址】
https://futures.huobi.fm;https://www.btcgateway.pro
【API访问地址】
中国大陆推荐使用: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次。