> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apexiumbet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 限制 - 速率限制与请求限制

> Apexium API 的每密钥速率限制、健康检查的每地址限制、认证失败的限流、订单、撤单和列表查询的大小限制，以及 WebSocket 的限制。

## 速率限制

每个密钥有三个配额，按一分钟计数：

| 配额 | 端点 | 每分钟请求数 |
| - | - | - |
| 下单 | `POST /v1/orders`，包括预览 | 600 |
| 投注单 | `GET /v1/betslip` | 60 |
| 其他所有 | 其他所有端点，包括行情数据 | 600 |

撤单不占用任何配额：`POST /v1/orders/{id}/cancel` 和 `POST /v1/orders/cancel-all` 不计入按密钥的速率限制，因此您随时都能撤回订单。

各配额相互独立：读取订单不会消耗下单配额。超出配额的请求会收到 `429 RATE_LIMITED`，并带有以下响应头：

| 响应头 | 含义 |
| - | - |
| `retry-after` | 距离配额重置的秒数 |
| `x-ratelimit-limit` | 每分钟允许的请求数 |
| `x-ratelimit-remaining` | 被拒绝时始终为 `0` |
| `x-ratelimit-reset` | 距离配额重置的秒数 |

请等待 `retry-after` 秒后再重试。如需下大量订单，请将它们分散在整分钟内，不要集中突发发送。

## 健康检查

[`GET /v1/health`](https://docs.apexiumbet.com/zh/api-reference/overview#健康状态) 不携带密钥，因此按地址单独计数：每分钟 120 个请求。超出后，请求会收到同样的 `429 RATE_LIMITED` 和响应头。其结果最多每 15 秒刷新一次，因此每 15 秒轮询一次就足够了。

## 认证失败

同一地址在一分钟内认证失败 20 次后，在这一分钟结束之前，来自该地址的每个请求都会收到 `429 RATE_LIMITED`，无论它携带哪个密钥。用已吊销的密钥反复重试的客户端可能因此把自己锁在外面：请先检查密钥。参见[认证](https://docs.apexiumbet.com/zh/api-reference/authentication.md#认证失败)。

## 请求限制

| 项目 | 限制 |
| - | - |
| `clientOrderId` | 1 到 200 个字符，在账户内唯一 |
| 订单上的 `bookmakers` | 1 到 50 个 |
| `stake.amount` | 为正数，最多两位小数 |
| `minPrice` | 至少 1.001，最多四位小数 |
| `expiresAt` | 未来时间，最晚为一小时之后 |
| `POST /v1/orders/cancel-all` | 每次调用 200 个订单；用 `nextCursor` 继续 |
| `GET /v1/pnl` 时间窗口 | 最长 366 天 |

您的账户还有自己的限额，例如每场赛事的最高投注额。每笔订单都会应用这些限额，并由 [`GET /v1/betslip`](https://docs.apexiumbet.com/zh/api-reference/overview#投注单) 显示。

## WebSocket

| 限制 | 值 |
| - | - |
| 每个 API 密钥的连接数 | 8 |
| 每个账户的赛事数，所有连接合计 | 500 |
| 每个账户的投注单选项数，所有连接合计 | 50 |
| 读取过慢的连接的发送缓冲区 | 超过 4 MB，或持续非空超过 5 秒时，以 `4002` 关闭 |

超出连接数、赛事数或选项数限制时，服务器会以 `4004 limit_exceeded` 拒绝。各关闭代码的含义及处理方式，参见[关闭代码](https://docs.apexiumbet.com/zh/websocket/close-codes.md#4004)。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.