全球区块链监管查询平台

简体中文
下载WikiBit

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

火币

相关类型: 其它

2021-03-16 15:30

尊敬的用户: 欢迎有优秀 maker 策略交易量大的用户参与长期合约做市商项目。如果您的火币币本位交割合约账户中有折合大于 3 BTC 资产,或火币币本位永续合约账户中有折合大于 3 BTC 资产,请提供以下信息到 dm_mm@huobi.com(做市商项目不支持点卡抵扣、VIP、交易量相关活动以及任何形式的返佣活动): - 提供火币UID(需不存在返佣关系的UID) - 提供其他交易平台证明maker交易量截图(比如30天内成交量,或者VIP等级等) 如果您是其他平台的VIP用户,您也可以通过我们的VIP共享计划申请费率优惠,申请细节,请点击>>> 成为火币合约做市商,您将享受如下权益: - 费率优惠,maker负费率 - API限频提升 - 持仓限制提升 - 新加入做市商首个自然月免考核 - 自动开通合约子账号功能(查看更多关于合约子账号信息>>>) - Colocation服务 示例: 某做市商3月份中某一天成功申请成为火币合约做市商,即日起,即可享受相对应的费率优惠、API限频提升,持仓限制提升,我司将从4月1日起再对其进行maker交易量考核。具体考核标准: 交割合约做市商考核标准>>> 永续合约做市商考核标准>>> 温馨提示: - 负费率指无需收取其交易手续费,且实时返还其该笔交易手续费 - 如费率或费率适用时段有调整,请以最新官方公告为准 目前已搭建火币合约API交流群,欢迎用户进群交流,请添加官方微信号(dm59488,dm19985),并备注“进API群”。      API用户,请关注如下链接: 【合约交易网站地址】 https://futures.huobi.be;https://www.btcgateway.pro 【API访问地址】 https://api.hbdm.com 中国大陆推荐使用:https://api.btcgateway.pro 【火币合约API版本历史记录】https://support.hbfile.nethttps://huobiglobal.zendesk.com/hc/zh-cn/articles/360000263201 【合约帮助中心】https://support.hbfile.nethttps://huobiglobal.zendesk.com/hc/zh-cn/categories/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示例: - 获取火币币本位交割合约信息:https://api.hbdm.com/api/v1/contract_contract_info - 获取火币币本位交割合约最高限价和最低限价:https://api.hbdm.com/api/v1/contract_price_limit?symbol=BTC&contract_type=this_week - 获取火币币本位永续合约的历史资金费率:https://api.hbdm.com/swap-api/v1/swap_historical_funding_rate?contract_code=btc-usd&page_index=1&page_size=50 - 获取火币币本位永续合约的K线数据:https://api.hbdm.com/swap-ex/market/history/kline?contract_code=BTC-USD&period=1day&size=50 - 以上仅供示例用途   币本位交割合约访问次数限制: - 币本位交割合约、币本位永续合约、期权合约和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次。     【加入火币合约社群请点击>>>】 【火币合约官方推特请点击>>>】 【火币合约官方验证通道请点击>>>】 【下载iPhone版火币APP请点击>>>】 【下载Android版火币APP请点击>>>】