访问限制

访问限制基本信息

• 以下是 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 持续下订单。更多信息，请参见现货未成交订单计数规则。
• 未成交订单数量是按照每个账户来统计的。