時間週期與 interval

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含義業餘創業標準專業
1m1 分鐘——6 天12 天
3m3 分鐘——20 天40 天
5m5 分鐘——30 天60 天
15m15 分鐘——90 天180 天
30m30 分鐘—90 天180 天360 天
1h1 小時—180 天360 天720 天
2h2 小時—180 天360 天720 天
4h4 小時180 天180 天360 天720 天
6h6 小時360 天360 天360 天720 天
8h8 小時360 天360 天360 天720 天
12h12 小時360 天360 天360 天720 天
1d1 天全部歷史全部歷史全部歷史全部歷史

歷史長度數據來自 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 線欄位

欄位說明
timeK 線週期的開始時間,毫秒時間戳(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)的全部歷史,適合做長週期回測、牛熊週期對比和年度研究。

相關文件