合約與現貨成交量比值

獲取某個幣種在所選交易所的合約成交額、現貨成交額,以及兩者的比值(合約 ÷ 現貨),按時間週期返回。適合觀察交易是集中在合約市場還是現貨市場。

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

以下 API 等級可以調用本接口:創業 標準 專業 企業

更新頻率即時

響應數據

data 為陣列,每個元素是一個週期,time 為週期的開始時間(毫秒),按時間從早到晚排列。futures_vol_usd、spot_vol_usd 是所選交易所中該幣種在這個週期內的合約、現貨成交額(美元),futures_spot_vol_ratio 是兩者之比。

📘

比值是倍數,不是百分數

futures_spot_vol_ratio 等於 futures_vol_usd ÷ spot_vol_usd。16.5868 表示合約成交額約是現貨成交額的 16.59 倍,1 表示兩者相等。

200 · application/json · 響應範例見右側面板。

欄位類型必返說明
codestring是業務狀態碼,"0" 表示成功
msgstring否結果說明;成功時可能不返回
dataarray of object是週期陣列,按時間從早到晚排列
data[].timeinteger(int64)是週期開始時間,毫秒時間戳(UTC)
data[].futures_spot_vol_rationumber是合約成交額 ÷ 現貨成交額,單位為倍;1 表示兩者相等
data[].futures_vol_usdnumber是該週期的合約成交額(合約成交量),美元
data[].spot_vol_usdnumber是該週期的現貨成交額(現貨成交量),美元

API 等級

只有下表中標為可以的 API 等級能調用本接口。各等級價格見 API 等級。

API 等級能否調用
業餘❌ 不可以
創業✅ 可以
標準✅ 可以
專業✅ 可以
企業✅ 可以

用 AI 調用本接口

選一個任務,點「在 ChatGPT 中開啟」或「在 Claude 中開啟」,AI 會先讀取本頁說明,再直接給出結果;也可以點「複製」,把完整提示詞貼上到你常用的 AI 工具裡。

用 Python 獲取數據
讓 AI 寫一個 Python 函式,獲取三大交易所 BTC 最近 7 天的小時級成交量比值。
畫比值走勢圖
讓 AI 寫代碼,畫出比值走勢和合約、現貨成交額。
看懂這個接口
讓 AI 用白話解釋參數、返回欄位和比值的含義。

本接口透過 REST API 提供數據,可使用上方提示詞讓 AI 編寫調用代碼。MCP 可調用的工具見 CoinGlass MCP。

應用場景

場景說明
判斷行情由誰推動比值走高說明交易集中在合約市場,行情更多由槓桿資金推動;比值走低說明現貨交易佔比在提升。
觀察投機熱度比值在短時間內快速放大,通常意味著合約交易明顯升溫,可與聚合持倉歷史(K 線)一起觀察。
比較交易所結構分別查詢不同交易所,比較各平台合約與現貨交易的相對活躍程度。
構建量化因子把比值的水平和變化作為擇時或風控研究中的市場結構因子。

相關接口

接口區別
交易所成交量歷史各交易所合約成交量的歷史曲線
幣種主動買賣歷史合約市場主動買入與主動賣出的成交額
現貨幣種主動買賣歷史現貨市場主動買入與主動賣出的成交額
支援的交易所查詢 exchange_list 可填的交易所名稱

常見問題

比值 16.5 是 16.5% 還是 16.5 倍?

是倍數。futures_spot_vol_ratio 等於合約成交額除以現貨成交額,16.5 表示合約成交額約是現貨的 16.5 倍。

exchange_list 寫錯了會報錯嗎?

不一定。寫錯或不支援的交易所名稱可能被直接忽略,返回的只是其餘交易所的數據。建議先用「支援的交易所」接口核對名稱。

同時傳了 start_time 和 end_time,為什麼返回條數比 limit 多?

同時指定起止時間時,返回條數可能由時間範圍決定,而不是 limit。例如傳 interval=1h、limit=2,start_time 為 01:00、end_time 為 04:00(2026-10-20,UTC),返回了 3 條,第一條從 01:00 開始。

多久更新一次?

即時更新。最後一個週期尚未結束,成交額會隨新的成交繼續變化。

深入了解:合約與現貨成交量比值

什麼是合約與現貨成交量比值?

用同一時間段內合約市場的成交額除以現貨市場的成交額,衡量交易活動在合約和現貨之間的分佈。比值大於 1 說明合約成交更多。

比值高低通常說明什麼?

比值越高,說明交易越集中在合約市場,槓桿資金對價格的影響越大;比值下降,說明現貨交易的佔比在提升。比值反映的是市場結構,不能單獨用來判斷漲跌方向。

比較不同時期的比值要注意什麼?

請保持 exchange_list 的交易所範圍不變,否則比值的變化可能只是統計範圍不同造成的。可填的交易所名稱見「支援的交易所」接口。

Query Params
string
required
Defaults to Binance

參與彙總的交易所,多個用英文逗號分隔,例如 Binance,OKX,Bybit。寫錯或不支援的名稱可能被直接忽略、不會報錯,可查詢的交易所見「支援的交易所」接口。

string
required
Defaults to BTC

幣種代碼,例如 BTC、ETH、SOL。可查詢的幣種見「支援的幣種」接口。

string
required
Defaults to 1d

數據週期,必填,例如 1h。可選 1m、3m、5m、15m、30m、1h、2h、4h、6h、8h、12h、1d、1w;能用的最短週期還受 API 等級限制。

integer
≤ 1000
Defaults to 1000

返回的數據條數,預設 1000,最大 1000,傳入更大的值按 1000 處理。同時傳了 start_time 和 end_time 時,返回條數可能多於 limit,見下方常見問題。

int64

開始時間,毫秒時間戳(UTC),例如 1792458000000(2026-10-20 01:00 UTC)。返回的第一條數據從 start_time 開始。

int64

結束時間,毫秒時間戳(UTC),例如 1792468800000(2026-10-20 04:00 UTC)。不傳時以當前時間為結束時間。

Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json