# 访问限制

对 REST API 的访问有频率限制。除下单接口外，所有接口均按照 IP 限频；下单接口按照 `ORDERS` 类型限频。这里的下单接口指单笔下单和批量下单接口，撤单、查询订单等其他订单相关接口仍按照 IP 限频。

当您超出请求速率限制时，请求会失败并返回 HTTP 状态码 `429`。收到 `429` 时，您有责任停止发送请求，不得滥用 API。违反限制时，封禁时间为 `10s`。

## 访问限制基本信息

以下是 `intervalLetter` 作为头部值时的取值：

| interval | intervalLetter |
|----------|----------------|
| SECOND   | S              |
| MINUTE   | M              |
| HOUR     | H              |
| DAY      | D              |

在 `/api/v3/exchangeInfo` 接口中，`rateLimits` 数组包含 REST 接口的访问限制，不限于本文中列出的 REST 接口。访问限制包括带权重的访问频次限制和下单速率限制。限制类型的更多说明请参考枚举定义。

## IP 访问限制

除下单接口外，所有接口均使用 IP 访问限制。访问限制基于 IP，而不是 API Key，也不是 UID。

每一个接口均有一个相应的权重 `weight`，有的接口会根据参数不同拥有不同的权重。越消耗资源的接口权重越大。

每个请求将包含以下响应头：

| 响应头                                                | 说明                    |
|----------------------------------------------------|-----------------------|
| `X-USED-WEIGHT-(intervalNum)(intervalLetter)`      | 当前 IP 在指定时间周期内的已使用权重。 |
| `X-REMAINING-WEIGHT-(intervalNum)(intervalLetter)` | 当前 IP 在指定时间周期内的剩余权重。  |

例如，`X-USED-WEIGHT-1M` 表示当前 IP 在 1 分钟周期内的已使用权重。

## ORDERS 访问限制

下单接口按照 `ORDERS` 类型限频。这里的下单接口指单笔下单和批量下单接口。该访问限制基于账户，也就是 `userId`。

下单接口不消耗 IP 权重，响应头中的 IP rate limit 计数为 `0`。

每个下单请求将包含以下响应头：

| 响应头                                               | 说明                   |
|---------------------------------------------------|----------------------|
| `X-ORDER-COUNT-(intervalNum)(intervalLetter)`     | 当前账户在指定时间周期内的已下单数量。  |
| `X-ORDER-REMAINING-(intervalNum)(intervalLetter)` | 当前账户在指定时间周期内的剩余下单数量。 |