獲取某個幣種在所選交易所的合約成交額、現貨成交額,以及兩者的比值(合約 ÷ 現貨),按時間週期返回。適合觀察交易是集中在合約市場還是現貨市場。
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
以下 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 · 響應範例見右側面板。
| 欄位 | 類型 | 必返 | 說明 |
|---|---|---|---|
code | string | 是 | 業務狀態碼,"0" 表示成功 |
msg | string | 否 | 結果說明;成功時可能不返回 |
data | array of object | 是 | 週期陣列,按時間從早到晚排列 |
data[].time | integer(int64) | 是 | 週期開始時間,毫秒時間戳(UTC) |
data[].futures_spot_vol_ratio | number | 是 | 合約成交額 ÷ 現貨成交額,單位為倍;1 表示兩者相等 |
data[].futures_vol_usd | number | 是 | 該週期的合約成交額(合約成交量),美元 |
data[].spot_vol_usd | number | 是 | 該週期的現貨成交額(現貨成交量),美元 |
API 等級
只有下表中標為可以的 API 等級能調用本接口。各等級價格見 API 等級。
| API 等級 | 能否調用 |
|---|---|
| 業餘 | ❌ 不可以 |
| 創業 | ✅ 可以 |
| 標準 | ✅ 可以 |
| 專業 | ✅ 可以 |
| 企業 | ✅ 可以 |
用 AI 調用本接口
選一個任務,點「在 ChatGPT 中開啟」或「在 Claude 中開啟」,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 的交易所範圍不變,否則比值的變化可能只是統計範圍不同造成的。可填的交易所名稱見「支援的交易所」接口。
