CoinGlass 歷史類接口用 interval 參數指定每根 K 線代表的時間長度。可用的週期和能查詢的歷史長度取決於你的 API 等級。
| 項目 | 內容 |
|---|---|
| 常用取值 | 1m、3m、5m、15m、30m、1h、2h、4h、6h、8h、12h、1d、1w,少數接口取值不同,以接口頁為準 |
| 業餘 | 4h 及以上 |
| 創業 | 30m 及以上 |
| 標準起 | 全部週期,分鐘級歷史長度見下表 |
| 時間跨度 | 約等於 interval × limit |
可選值與 API 等級
大多數 K 線類接口的 interval 支援下表中的取值。少數接口的取值範圍不同(例如只支援 1m、5m),請以各接口頁的參數說明為準。
表中天數是該 API 等級可查詢的最長歷史,「—」表示該 API 等級不支援此週期。
| interval | 含義 | 業餘 | 創業 | 標準 | 專業 |
|---|---|---|---|---|---|
1m | 1 分鐘 | — | — | 6 天 | 12 天 |
3m | 3 分鐘 | — | — | 20 天 | 40 天 |
5m | 5 分鐘 | — | — | 30 天 | 60 天 |
15m | 15 分鐘 | — | — | 90 天 | 180 天 |
30m | 30 分鐘 | — | 90 天 | 180 天 | 360 天 |
1h | 1 小時 | — | 180 天 | 360 天 | 720 天 |
2h | 2 小時 | — | 180 天 | 360 天 | 720 天 |
4h | 4 小時 | 180 天 | 180 天 | 360 天 | 720 天 |
6h | 6 小時 | 360 天 | 360 天 | 360 天 | 720 天 |
8h | 8 小時 | 360 天 | 360 天 | 360 天 | 720 天 |
12h | 12 小時 | 360 天 | 360 天 | 360 天 | 720 天 |
1d | 1 天 | 全部歷史 | 全部歷史 | 全部歷史 | 全部歷史 |
歷史長度數據來自 CoinGlass API 定價頁。定價頁列出了 2 小時週期,各接口是否支援 2h,以接口頁 interval 參數的可選值為準。企業的歷史長度可以按需定製,見企業定製。
interval 與 limit 決定時間跨度
一次請求返回的時間跨度約等於 interval × limit。需要更長的區間時,用 start_time、end_time 分段查詢,見時間戳與分頁。
| 參數 | 時間跨度 | 適合場景 |
|---|---|---|
interval=1h&limit=24 | 最近 1 天 | 看日內變化 |
interval=4h&limit=42 | 最近 7 天 | 看週內趨勢 |
interval=1d&limit=365 | 最近 1 年 | 長週期研究 |
import os
import requests
# 最近 7 天的比特幣全市場持倉量,4 小時一根 K 線
resp = requests.get(
"https://open-api-v4.coinglass.com/api/futures/open-interest/aggregated-history",
headers={"CG-API-KEY": os.environ["COINGLASS_API_KEY"]},
params={"symbol": "BTC", "interval": "4h", "limit": 42},
timeout=10,
)
print(len(resp.json()["data"]))K 線欄位
| 欄位 | 說明 |
|---|---|
time | K 線週期的開始時間,毫秒時間戳(UTC)。例如 interval=30m 時,time 為 15:30 的記錄表示 15:30–16:00 這個週期 |
open / close | 週期開始與結束時的數值 |
high / low | 週期內的最高與最低值 |
最後一根 K 線對應尚未結束的週期,數值會繼續變化。已經結束的週期也可能因數據補錄而更新,目前沒有統一的「定稿」等待時間。
常見問題
資金費率的 interval 和結算週期是一回事嗎?
不是。interval 只決定數據按多長時間聚合成一根 K 線;資金費率的結算週期由各交易所自行規定。
為什麼返回的 K 線條數比 limit 少?
請求的時間範圍超出了 API 等級可查詢的歷史長度時,超出部分不會返回。可以對照上方「可選值與 API 等級」表,或API 等級與權限。
深入了解加密貨幣 K 線數據
OHLC 是什麼意思?
OHLC 是開盤(Open)、最高(High)、最低(Low)、收盤(Close)的縮寫。CoinGlass 不只把價格做成 K 線,持倉量(Open Interest)、資金費率(Funding Rate)等指標也以 OHLC 形式返回,例如持倉歷史(K 線)和資金費率歷史(K 線)。
如何獲取 1 分鐘級別的歷史數據?
1m 到 15m 週期需要標準及以上的 API 等級:標準可查最近 6 至 90 天,專業可查最近 12 至 180 天;更長的分鐘級歷史可以聯繫企業定製。
日線數據可以查多久?
所有 API 等級都可以查詢日線(1d)的全部歷史,適合做長週期回測、牛熊週期對比和年度研究。
相關文件
- API 等級與權限:各 API 等級歷史數據長度
- 時間戳與分頁:分段獲取長歷史
- 聚合持倉歷史(K 線):持倉量 K 線 API
- 交易對 K 線歷史:合約價格 OHLC 歷史
