限制
本頁集中列出容易被斷章取義的限制。參數預設值與上限的權威來源是 OpenAPI； 本頁說明周邊的操作限制。
資料查詢
| 限制 | 值 |
|---|---|
| 每次請求的商品數 | 100 |
| 每次請求的交易日區間 | 31 個日曆日 |
| 每次請求的時間點區間 | 31 天，另加 10 天容納跨夜時段 |
每頁列數（limit） | 1 到 10,000；預設 1,000 |
還沒準備好的交易日回 503 data_pending。同一個請求重試不會重複排工作。
K 線
| 限制 | 值 |
|---|---|
| 由 rollup 提供的盤中區間 | 366 天 |
日曆 K 線（1d、1w、1mo、1q、1y） | 30 年（366 × 30 天） |
| 最小週期 | 交易所快照間隔 |
每頁列數（limit） | 1 到 10,000；預設 1,000 |
交易所快照間隔在 GET /v2/catalog/datasets。要求更細的 K 線回
unsupported_resolution。
匯出
| 限制 | 值 |
|---|---|
| 每次匯出的商品數 | 5,000 |
| 每次匯出的交易日區間 | 10 年（3,660 天） |
| 檔案大小 | 每個 1 GiB；更大的匯出會切成多檔 |
| 格式 | Parquet、CSV |
| 保留期限 | 完成後 7 天 |
| 同時工作數 | 依金鑰 policy；管理限制可能更嚴 |
時間點區間每次最多 31 天；更長的區間請用交易日。超過保留期限的下載回
not_found；工作還在跑時下載檔案回 data_pending。
即時串流
| 限制 | 值 |
|---|---|
| 每條連線的訂閱數 | 100 |
| 每條連線的商品總數 | 1,000 |
| 心跳 | 每 15 秒 |
| resume token 有效期 | 50 分鐘 |
| 慢用戶端 | 有界佇列；溢出以 resync_required 關閉 |
| 單一訂閱的市場 | 一個；另一個市場請另開訂閱 |
目錄
| 限制 | 值 |
|---|---|
| 每頁 instrument 數 | 1 到 10,000；預設 1,000 |
| 日曆區間 | 400 天 |
| 交易所與商品篩選 | 每次一個交易所、一個商品 |
MCP 工具
| 工具 | 預設列數 | 上限 |
|---|---|---|
search_instruments | 50 | 200 |
get_bars | 500 | 2,000 |
get_data | 200 | 1,000 |
create_export | — | 與 HTTP 匯出相同 |
工具會等待正在準備的交易日最多 90 秒，之後回 data_pending。
金鑰
| 限制 | 值 |
|---|---|
| 預設效期 | 90 天 |
| 最長效期 | 365 天 |
| 輪替重疊 | 預設 0；最多 24 小時 |
| 撤銷生效 | 約一分鐘內 |
配額
指定使用政策後，/v2 會強制該 principal 的每分鐘請求數、每分鐘輸出位元組、
同時請求數、每小時匯出工作數與同時串流連線數。沒有政策的 principal 不受限。
政策由管理員指派，金鑰不能自己改。
超過限制回 429、代碼 quota_exceeded，並帶 retry_after。單一回應超過
輸出上限回 413、代碼 resource_exhausted。大量讀取請用匯出，不要用一個
超大的請求。