> For the complete documentation index, see [llms.txt](https://docs.blockchainsecurity.asia/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.blockchainsecurity.asia/help-center/zheng-he-yu-yi-nan-pai-jie/rate-limits-and-quotas.md).

# 限流與配額

為確保服務穩定與公平使用，BCS API 會對每把 API key 限流。

## 限流如何運作

* 維度為 **「API key + 端點」**——同一把 key 對不同端點各有獨立額度。
* 額度由方案的 **RPS**（每秒請求數）與 **Burst**（突發容量）決定。

## 超量時

依方案設定有兩種行為：

| 行為     | 結果                                     |
| ------ | -------------------------------------- |
| Reject | 立即回 `429 rate_limited`，附 `Retry-After` |
| Wait   | 在容量內短暫排隊，等到有額度自動放行；佇列滿則回 `503`         |

## 如何優雅因應

* 收到 `429` 時，**遵守 `Retry-After`** 再重試。
* 採用**指數退避**，避免雪崩式重打。
* 在客戶端設定合理併發上限，平滑送出請求。

## 需要更高額度？

請聯絡你的客戶經理調整方案，或請管理員將 key 套用到更高 RPS／Burst 的方案。

延伸閱讀：[開發者文件 — 限流](https://api.blockchainsecurity.asia/docs)。