访问限制基本信息
- 以下是
intervalLetter 作为头部值:
- SECOND => S
- MINUTE => M
- HOUR => H
- DAY => D
- 在
/api/v3/exchangeInfo接口中rateLimits数组里包含有REST接口(不限于本篇的REST接口)的访问限制。包括带权重的访问频次限制、下单速率限制。参考 枚举定义 中有关有限制类型的进一步说明。
- 当您超出请求速率限制时，请求会失败并返回 HTTP 状态代码 429。
IP 访问限制
- 每个请求将包含一个
X-MBX-USED-WEIGHT-(intervalNum)(intervalLetter)的头，其中包含当前IP所有请求的已使用权重。
- 每一个接口均有一个相应的权重(weight)，有的接口根据参数不同可能拥有不同的权重。越消耗资源的接口权重就会越大。
- 收到429时，您有责任停止发送请求，不得滥用API。
- 收到429后仍然继续违反访问限制，会被封禁IP，并收到418错误码
- 频繁违反限制，封禁时间会逐渐延长，从最短2分钟到最长3天.
Retry-After的头会与带有418或429的响应发送， 并且会给出以秒为单位的等待时长(如果是429)以防止禁令，或者如果是418，直到禁令结束。- 访问限制是基于IP的，而不是API Key
未成交订单计数
- 每个成功的订单响应都将包含一个
X-MBX-ORDER-COUNT-(intervalNum)(intervalLetter) 报文头，用于标识您在该时间间隔内下了多少订单。
如果您想要对此进行监控，请参阅 GET api/v3/rateLimit/order。
- 被拒绝/不成功的订单不保证在响应中有
X-MBX-ORDER-COUNT-** 报文头。
- 如果超过此值，您将收到一个 429 错误，而且不带
Retry-After 报文头。
- 请注意，如果您的订单一直顺利完成交易，您可以通过 API 持续下订单。更多信息，请参见现货未成交订单计数规则。
- 未成交订单数量是按照每个账户来统计的。