币安API速率限制中RAW_REQUESTS是什么？rateLimits[3]如何适配实现？

1. RAW_REQUESTS的定义 #

RAW_REQUESTS是币安API独立于权重计数、订单计数之外的原始请求次数限流维度，统计逻辑为每发起一次HTTP请求即计数1次，和接口的权重值、接口类型无关，只统计请求的实际发起次数。

2. rateLimits[3]对应的规则 #

你在/api/v3/exchangeInfo接口返回的rateLimits[3]对应的就是RAW_REQUESTS类型的限流规则，当前公开默认规则为IP维度每分钟最多6000次原始请求，所有/api/*路径下的接口共享该限额。

3. 适配实现方案 #

• 不要硬编码限流数值，优先从/api/v3/exchangeInfo返回结果中过滤rateLimitType为RAW_REQUESTS的条目，动态获取时间窗口、限额数值，适配后续官方规则调整。
• 在本地请求调度模块新增独立的RAW_REQUESTS计数器，每发起一次请求计数+1，按对应时间窗口做限流控制，不要和权重计数、订单计数逻辑混用。
• 每次请求后读取响应头中X-MBX-USED-RAW-REQUESTS-(intervalNum)(intervalLetter)字段（比如分钟维度对应X-MBX-USED-RAW-REQUESTS-1M），用官方返回的已使用计数校准本地计数器，避免两边统计偏差导致误触限流。
• 触发RAW_REQUESTS限流时接口会返回429状态码，同时响应头会携带Retry-After字段标注需要等待的秒数，需要做好对应的重试逻辑，避免频繁触发限流导致IP被临时封禁。

内容的提问来源于stack exchange，提问作者Jeffrey Chen