关于API将对部分现有REST API私有接口实行新的限频策略的公告
Huobipro

03月31日 15:21

关注

尊敬的用户:

自本通知生效之日起,火币Global将对部分REST API私有数据接口实行新的限频策略。

 

生效日期:2020年4月13日(GMT+8)

具体变更细节及参数要求,请参考API文档:相关链接

火币全球站
2020年3月31日

 

以下为具体变更细节:

最大允许请求频率的限制 –

1)同一UID下各API Key同时对某单个节点请求的频率不能超出单位时间内该节点最大允许访问次数的限制;

2)单位时间内,不同节点所允许的最大访问次数可能会不同,如下表:

接口分类 接口名称 URL 限频
钱包(充币与提币)     APIv2 充币地址查询 /v2/account/deposit/address 20次/2s
APIv2 提币额度查询 /v2/account/withdraw/quota 20次/2s
数字资产提币 /v1/dw/withdraw/api/create 20次/2s
取消提币 /v1/dw/withdraw-virtual/{withdraw-id}/cancel 20次/2s
充提记录 /v1/query/deposit-withdraw 20次/2s
账户相关        账户信息 /v1/account/accounts 20次/2s
账户余额 /v1/account/accounts/{account-id}/balance 20次/2s
账户流水 /v1/account/history 1次/2s
币币现货账户与合约账户划转 /v1/futures/transfer 2次/2s
资产划转(母子用户之间) /v1/subuser/transfer 2次/2s
子用户余额(汇总) /v1/subuser/aggregate-balance 2次/2s
子用户余额 /v1/account/accounts/{sub-uid} 20次/2s
子用户冻结/解冻 /v2/sub-user/management 20次/2s
现货/杠杆交易              下单 /v1/order/orders/place 100次/2s
批量下单 /v1/order/batch-orders 5次/2s
撤销指定订单(基于order-id) /v1/order/orders/{order-id}/submitcancel 100次/2s
撤销指定订单(基于client-order-id) /v1/order/orders/submitCancelClientOrder 100次/2s
获取所有未成交订单 /v1/order/openOrders 20次/2s
批量撤销订单(open orders) /v1/order/orders/batchCancelOpenOrders 50次/2s
批量撤单 /v1/order/orders/batchcancel 50次/2s
获取订单信息(基于order-id) /v1/order/orders/{order-id} 20次/2s
查询订单详情(基于client order ID) /v1/order/orders/getClientOrder 20次/2s
获取成交明细 /v1/order/orders/{order-id}/matchresults 20次/2s
搜索历史订单 /v1/order/orders 20次/2s
搜索最近48小时内历史订单 /v1/order/history 20次/2s
当前和历史成交 /v1/order/matchresults 20次/2s
获取用户当前手续费率 /v1/fee/fee-rate/get 20次/2s
借币(逐仓杠杆)      资产划转 /v1/dw/transfer-in/margin/&&/v1/dw/transfer-out/margin 2次/2s
查询借币利率及额度 /v1/margin/loan-info 20次/2s
申请借币 /v1/margin/orders 2次/2s
归还借币 /v1/margin/orders/{order-id}/repay 2次/2s
查询借币订单 /v1/margin/loan-orders 20次/2s
借币账户详情 /v1/margin/accounts/balance 20次/2s

3)同一节点对不同等级用户的最大允许访问次数可能会不同;

4)上一有效期内未达到最大访问次数不影响下一有效期的限制次数。

5)在极端行情超出交易所系统容量的情况下,相应接口的限频值有可能会被进一步收紧。用户可通过以下http响应消息头获取实际限频值。

 

以上REST私有数据节点的返回消息中将新增以下Headers –

1)X-HB-RateLimit-Requests-Remain 当前有效期内剩余访问次数;

2)X-HB-RateLimit-Requests-Expire 当前剩余访问次数的有效期截止时间(unix time in millisecond)。

 

当访问频率超限导致访问受限时,系统返回的错误码分别为 –

 

From API v2 endpoints –

 

{

"code": 1006,

"message": "exceeded rate limit"

}

 

From API v1 endpoints –

 

{

"status": "error",

"err-code": "rate-too-many-requests",

"err-msg": "exceeded rate limit",

"data": null

}

 

其它REST API接口以及Websocket接口的限频策略变更将另行通知。

自本通知生效之日起,未来新增REST API私有数据接口也将被应用以上限频策略。

 

如果您对新限频有更多疑问,可以加入“现货API新限频讨论”QQ群:132853106,和API团队进行更多沟通。

阅读 316

8
分享

评论

暂无评论