> For the complete documentation index, see [llms.txt](https://docs.infoway.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.infoway.io/getting-started/api-limitation/http.md).

# HTTP接口限制

WebSocket 频率与连接数见 [WebSocket限制](/getting-started/api-limitation/websocket.md)。超限错误码见 [HTTP错误码](/getting-started/error-codes/http.md)。

### 频率限制

| 套餐 | 频率限制说明                                       |
| -- | -------------------------------------------- |
| 免费 | 所有接口，每秒最多 1 次，一分钟上限 60 次，一天请求上限 86400 次      |
| 基础 | 所有接口，每秒最多 2 次，一分钟上限 120 次，一天请求上限 172800 次    |
| 高级 | 所有接口，每秒最多 10 次，一分钟上限 600 次，一天请求上限 864000 次   |
| 专业 | 所有接口，每秒最多 20 次，一分钟上限 1200 次，一天请求上限 1728000 次 |

具体以当前 套餐信息 返回的 `apiNumPerSec` 为准。

### 单次行情查询限制

* 批量成交、盘口、K 线接口最多查询 100 个有效且去重后的产品。代码区分大小写，请按产品列表填写，并用英文逗号分隔，不要在代码两侧添加空格。
* K 线单产品最多 500 根；多个产品时每产品最多 2 根，较大的 `klineNum` 会按 2 处理。
* 不存在的产品会被过滤；全部无效时返回 `ret=508`。返回顺序不保证与请求一致，请按响应 `s` 匹配。
* Free 套餐可查询的市场和产品受账户权限限制。任一有效产品无权限时，整次请求返回 `ret=514`；不会只略过该产品。

### K 线月归档下载限制

[月归档下载](/rest-api/http-endpoints/post-kline-archive-download.md)除通用频率限制外，每个 API Key 每个 UTC 自然日最多成功请求 5 次，所有市场共用；UTC 00:00（北京时间 08:00）重置。一次请求最多 36 个去重后的月份，一次成功请求多个包只计 1 次。Free 套餐不支持此接口。

返回的 `remaining` 表示本次请求后剩余次数，`refreshInSeconds` 表示距离重置的秒数。每条下载链接有效期 3 分钟，以 `expireAt` 为准。参数错误、无权限或包不存在的请求不扣成功次数。

### IP限制

* 正常业务接口只校验 API Key 套餐权限，不对 IP 做限制。
* 官网页面展示类接口会对 IP 做频率限制。
* 请合理请求。大量失败可能被风控临时封禁，解封请联系 Telegram 客服。