关于火币币本位交割与币本位永续合约API接入文档的说明

尊敬的用户：

欢迎有优秀 maker 策略交易量大的用户参与长期合约做市商项目。如果您的火币币本位交割合约账户中有折合大于 3 BTC 资产，或火币币本位永续合约账户中有折合大于 3 BTC 资产，请提供以下信息到 [email protected]（做市商项目不支持点卡抵扣、VIP、交易量相关活动以及任何形式的返佣活动）:

  • 提供火币UID（需不存在返佣关系的UID）
  • 提供其他交易平台证明maker交易量截图（比如30天内成交量，或者VIP等级等）

如果您是其他平台的VIP用户，您也可以通过我们的VIP共享计划申请费率优惠，申请细节，请点击>>>

成为火币合约做市商，您将享受如下权益:

Taker费率调整详情请查看：火币全平台Pro等级共享计划

示例：

某做市商3月份中某一天成功申请成为火币合约做市商，即日起，即可享受相对应的费率优惠、API限频提升，持仓限制提升，我司将从4月1日起再对其进行maker交易量考核。具体考核标准：

交割合约做市商考核标准>>>

永续合约做市商考核标准>>>

温馨提示：

  • 负费率指无需收取其交易手续费，且实时返还其该笔交易手续费
  • 如费率或费率适用时段有调整，请以最新官方公告为准

目前已搭建火币合约API交流群，欢迎用户进群交流，请添加官方微信号(dm59488，dm19985)，并备注“进API群”。

    92b509eee13c6bf3183bc6532a292ed.jpg1852896863_17560321903_1887493400_17127012787_IMG_1088.JPG

API用户，请关注如下链接：

【合约交易网站地址】

https://www.huobi.gr/zh-cn/；https://www.btcgateway.pro

【API访问地址】

https://api.hbdm.com

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

【火币合约API版本历史记录】https://www.huobi.com/support/zh-cn/detail/360000263201

【合约帮助中心】https://www.huobi.com/support/zh-cn/list/360000032161

 

币本位交割合约：

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

【Rust 异步库地址】https://github.com/hbdmapi/huobi_future_async

【Python DEMO地址】https://github.com/huobiapi/Futures-Python-demo

【Java DEMO地址】https://github.com/huobiapi/Futures-Java-demo

【NodeJS DEMO地址】https://github.com/huobiapi/Futures-Node.js-demo

【PHP DEMO地址】https://github.com/huobiapi/Futures-PHP-demo

【C# DEMO地址】https://github.com/huobiapi/Futures-CSharp-demo

【GO DEMO地址】https://github.com/huobiapi/Futures-Go-demo

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

 

币本位永续合约：

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

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

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

【Rust DEMO地址】https://github.com/hbdmapi/hbdm_swap_Rust

【C++ DEMO地址】 https://github.com/hbdmapi/huobi_swap_Cpp

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

备注：永续代码使用方式与交割合约类似，其他语言demo可以参考交割合约。

 

完整API示例：

币本位交割合约访问次数限制：

  • 币本位交割合约、币本位永续合约、期权合约和USDT本位永续合约都分开限频

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

  • 普通用户，需要密钥的私有接口，每个UID 3秒最多72次请求(交易接口3秒最多36次请求，查询接口3秒最多36次请求) (该UID的所有币种和不同到期日的合约的所有私有接口共享该限制) 查看API接口类型列表(其中读取即查询,交易即交易)

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

  • 行情类的公开接口，比如：获取K线数据、获取聚合行情、市场行情、获取行情深度数据、获取指数k线、获取基差数、获取市场最近成交记录：
    （1） restful接口：同一个IP, 1秒最多800个请求
    （2） websocket：req请求，同一时刻最多请求50次；sub请求，无限制，服务器主动推送数据
  • WebSocket私有订单成交推送接口(需要API KEY验签)
    一个UID最多同时建立30个私有订单成交推送WS链接。该用户在一个品种(包含该品种的所有周期的合约)上，仅需要维持一个订单推送WS链接即可。
    注意: 订单推送WS的限频，跟用户RESTFUL私有接口的限频是分开的，相互不影响。
  • 查询与交易API接口返回的header中会有限频信息。比如：查询订单信息接口(/api/v1/contract_order_info)，返回的header中的ratelimit-limit即查询接口的总限制频率次数，ratelimit-remaining即查询接口的剩余总限制频率次数。下单接口(/api/v1/contract_order)，返回的header中的ratelimit-limit即交易接口的总限制频率次数，ratelimit-remaining即交易接口的剩余总限制频率次数。查看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次。

币本位永续合约访问次数限制：

  • 交割合约、币本位永续合约、期权合约和USDT本位永续合约都分开限频
  • 公开行情接口和用户私有接口都有访问次数限制
  • 普通用户，需要密钥的私有接口，每个UID 3秒最多 72 次请求(交易接口3秒最多 36 次请求，查询接口3秒最多 36 次请求) (该UID的所有币种和不同到期日的合约的所有私有接口共享该限制)。 查看API接口类型列表(其中读取即查询,交易即交易)
  • 其他非行情类的公开接口，比如获取指数信息，限价信息，交割结算、平台持仓信息等，所有用户都是每个IP3秒最多120次请求（所有该IP的非行情类的公开接口请求共享3秒120次的额度）
  • 行情类的公开接口，比如：获取K线数据、获取聚合行情、市场行情、获取行情深度数据、获取溢价指数K线、获取实时预测资金费率k线，获取基差数据、获取市场最近成交记录：
    （1） restful接口：同一个IP, 所有业务（交割合约、币本位永续合约、期权合约和USDT本位永续合约）总共1秒最多800个请求
    （2） websocket：req请求，同一时刻最多请求50次；sub请求，无限制，服务器主动推送数据
  • WebSocket私有订单成交推送接口(需要API KEY验签)一个UID最多同时建立30个私有订单成交推送WS链接。该用户在一个品种(包含该品种的所有周期的合约)上，仅需要维持一个订单推送WS链接即可。
    注意: 订单推送WS的限频，跟用户RESTFUL私有接口的限频是分开的，相互不影响。
  • 查询与交易API接口返回的header中会有限频信息。比如：查询订单信息接口(/swap-api/v1/swap_account_info)，返回的header中的ratelimit-limit即查询接口的总限制频率次数，ratelimit-remaining即查询接口的剩余总限制频率次数。下单接口(/swap-api/v1/swap_order)，返回的header中的ratelimit-limit即交易接口的总限制频率次数，ratelimit-remaining即交易接口的剩余总限制频率次数。查看API接口类型列表(其中读取即查询,交易即交易)
  • 所有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次。

 

官方网址

验证通道

交易机器人

客户端下载

客服邮箱 [email protected]