接口說明
歷史 K 線
參數 symbol、interval、limit 等，詳見控制檯 Playground。
REST / WebSocket 接口
加密貨幣 K 線
按交易對與時間週期獲取歷史 OHLCV K 線序列，支持常見 interval 參數。
更新日期：2026-09-12
請求參數
| 字段 | 類型 | 必填 | 說明 |
|---|---|---|---|
symbol | string | 是 | 現貨交易對，如 BTCUSDT |
interval | string | 否 | 默認 1h；1s/1m/3m/5m/15m/30m/1h/2h/4h/6h/8h/12h/1d/3d/1w/1M |
limit | number | 否 | 默認 100，範圍 1–1000 |
startTime / endTime | number | 否 | 毫秒時間戳（可選） |
timeZone | string | 否 | 時區（透傳上游） |
響應外殼與鑑權
| 字段 | 類型 | 說明 |
|---|---|---|
succ | boolean | 是否成功 |
data | object | array | 業務數據（見下方字段） |
msg | string | 失敗時的可讀錯誤信息（可選） |
code | string | 機器可讀錯誤碼（可選） |
X-Request-Id | header | 請求追蹤 ID（響應頭，不在 JSON body） |
X-API-Key | header | API Key；也可用 Authorization: Bearer |
data 業務字段
| 字段 | 類型 | 說明 |
|---|---|---|
symbol | string | 交易對 |
interval | string | 週期 |
bars | array | K 線數組 |
bars[].openTime / openTimeMs | string | number | K 線開盤時間 |
bars[].closeTime / closeTimeMs | string | number | K 線收盤時間 |
bars[].open / high / low / close | number | OHLC |
bars[].volume | number | 成交量 |
bars[].quoteVolume | number | 成交額 |
bars[].trades | number | 成交筆數 |
bars[].takerBuyVolume / takerBuyQuoteVolume | number | 主動買入量/額 |
常見錯誤碼
| code | HTTP | 說明 |
|---|---|---|
INVALID_REQUEST | 400 | 參數缺失或非法（如 interval） |
INVALID_SYMBOL | 400 | 標的代碼格式無效 |
UNKNOWN_SYMBOL | 400 | 無法識別的標的（多市場 quote） |
NO_SUBSCRIPTION | 403 | 無有效訂閱 |
SUBSCRIPTION_EXPIRED | 403 | 訂閱已過期 |
MARKET_NOT_ENABLED | 403 | 當前套餐未開通該市場 |
API_KEY_SCOPE_DENIED | 403 | Key 權限範圍不足 |
IP_DENIED / GEO_DENIED | 403 | IP 或地區策略拒絕 |
DAILY_LIMIT_EXCEEDED | 429 | 日請求配額用盡 |
MONTHLY_LIMIT_EXCEEDED | 429 | 月請求配額用盡 |
RATE_LIMIT_EXCEEDED | 429 | 用戶級 RPM 超限 |
KEY_RATE_LIMIT_EXCEEDED | 429 | 單 Key RPM 超限 |
UPSTREAM_UNAVAILABLE | 502 | 上游行情源暫時不可用 |
RATE_LIMIT_UNAVAILABLE | 503 | 限流組件不可用 |
WS_CONN_LIMIT | WS | WebSocket 連接數達到套餐上限 |
限流與配額
- REST 的 quote / kline / stream 握手計入日配額與 RPM；推送 tick 不再重複計次。
- 默認 RPM 約：Free/Trial 30、Growth/Standard 120、Pro 600、Enterprise 3000（以控制檯套餐為準）。
- WebSocket 連接/標的上限約：Free 1 連接/10 標的；Growth 3/25；Pro 10/50；Enterprise 50/200。
請求示例 (cURL)
curl https://api.tiqex.io/api/v1/market/crypto/kline?symbol=BTCUSDT&interval=1m \
-H "X-API-Key: YOUR_API_KEY"Python
import requests
url = "https://api.tiqex.io/api/v1/market/crypto/kline?symbol=BTCUSDT&interval=1m"
headers = {"X-API-Key": "YOUR_API_KEY"}
resp = requests.get(url, headers=headers, timeout=10)
resp.raise_for_status()
print(resp.json())JavaScript
const res = await fetch("https://api.tiqex.io/api/v1/market/crypto/kline?symbol=BTCUSDT&interval=1m", {
headers: { "X-API-Key": "YOUR_API_KEY" }
});
if (!res.ok) throw new Error(res.status);
console.log(await res.json());