獲取某個幣種在指定交易所的現貨主動買入與主動賣出成交額合計,按週期返回,單位為美元。可用 exchange_list 自選參與彙總的交易所,適合觀察現貨市場整體的買賣力量。
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
以下 API 等級均可調用本接口:業餘 創業 標準 專業 企業
不同等級能用的最短週期不同,詳見本頁下方的「API 等級與可用週期」。
響應數據
data 為陣列,每個元素是一個週期,time 為週期的開始時間(毫秒)。成交額為所選交易所的現貨合計,單位為美元,以數字返回。
關於unit參數本接口目前不讀取
unit參數,傳入不會改變結果,返回的始終是美元成交額:傳coin返回的仍是美元金額。需要幣的數量時,可用同期價格自行換算,或改用「現貨聚合累計成交量差值(CVD)」並傳unit=coin。
200 · application/json · 響應範例見右側面板。
| 欄位 | 類型 | 必返 | 說明 |
|---|---|---|---|
code | string | 是 | 業務狀態碼,"0" 表示成功 |
msg | string | 否 | 結果說明 |
data | array of object | 是 | 週期陣列,每個元素是一個週期 |
data[].time | integer(int64) | 是 | 週期開始時間,毫秒時間戳(UTC) |
data[].aggregated_buy_volume_usd | number | 是 | 所選交易所合計的現貨主動買入成交額,美元 |
data[].aggregated_sell_volume_usd | number | 是 | 所選交易所合計的現貨主動賣出成交額,美元 |
API 等級與可用週期
所有 API 等級都可以調用本接口,區別在於能使用的數據週期:等級越低,能用的最短週期越長。各等級價格見 API 等級。
| API 等級 | 能否調用 | 可用的週期(interval 參數) |
|---|---|---|
| 業餘 | ✅ 可以 | 4 小時及以上:4h、6h、8h、12h、1d、1w |
| 創業 | ✅ 可以 | 30 分鐘及以上:30m、1h、2h、4h、6h、8h、12h、1d、1w |
| 標準 | ✅ 可以 | 全部週期,最短 1 分鐘(1m) |
| 專業 | ✅ 可以 | 全部週期,最短 1 分鐘(1m) |
| 企業 | ✅ 可以 | 全部週期,最短 1 分鐘(1m) |
各週期能查詢多長的歷史數據,見時間週期與 interval。
用 AI 調用本接口
選一個任務,點「在 ChatGPT 中開啟」或「在 Claude 中開啟」,AI 會先讀取本頁說明,再直接給出結果;也可以點「複製」,把完整提示詞貼上到你常用的 AI 工具裡。
本接口透過 REST API 提供數據,可使用上方提示詞讓 AI 編寫調用代碼。MCP 可調用的工具見 CoinGlass MCP。
應用場景
| 場景 | 說明 |
|---|---|
| 觀察現貨整體買賣力量 | 彙總多個交易所後,主動買賣額更能代表整個現貨市場的買賣傾向,減少單一平台的噪音。 |
| 自選交易所範圍 | 只統計你關心的交易所,例如只看 Binance、OKX、Bybit 三個平台的合計。 |
| 確認趨勢 | 價格突破時觀察現貨主動買入額是否同步放大,判斷突破是否有真實買盤支援。 |
| 與合約對比 | 與合約幣種主動買賣歷史對比,判斷行情由現貨買盤還是合約資金推動。 |
相關接口
| 接口 | 區別 |
|---|---|
| 現貨交易對主動買賣歷史 | 單個交易所、單個現貨交易對的主動買賣額 |
| 現貨聚合累計成交量差值(CVD) | 彙總方式相同,並附帶累計差值,支援返回幣的數量 |
| 現貨單幣種流入流出 | 多個時間窗口的現貨主動買賣額和淨流入 |
| 合約幣種主動買賣歷史 | 合約市場的同類數據 |
| 現貨支援的交易所和交易對 | 查詢 exchange_list 可填的交易所名稱 |
常見問題
傳了 unit=coin,為什麼返回的還是美元?
本接口目前不讀取 unit 參數,只返回美元成交額。需要幣的數量時,可用同期價格自行換算,或改用「現貨聚合累計成交量差值(CVD)」並傳 unit=coin。
exchange_list 寫錯了會報錯嗎?
不一定。寫錯或不支援的交易所名稱可能被直接忽略,返回的只是其餘交易所的合計。建議先用「現貨支援的交易所和交易對」接口核對名稱。
聚合包含哪些交易對?
只彙總本接口已接入、且有數據的現貨市場,結果不一定包含交易所的全部現貨交易對。例如 exchange_list=Binance、symbol=BTC、interval=1h 時,返回的主動買賣額與 Binance BTCUSDT 交易對完全相同。需要某一個交易對的數據時,請改用對應的交易對接口。
同時傳了 start_time 和 end_time,為什麼返回條數和 limit 不一樣?
同時傳開始和結束時間時,返回哪些週期由時間範圍決定,條數不一定等於 limit。例如 interval=1h、limit=2,時間範圍為 3 小時,返回了 3 條。只想要固定條數時,可以不傳時間(以當前時間為終點向前取),或只傳 start_time 和 limit。
深入了解:現貨市場主動買賣力量
為什麼要看現貨市場的主動買賣?
現貨買入換到的是幣本身,現貨主動買入放大通常代表真實需求。相比合約,現貨數據受槓桿資金短線進出的影響更小。
現貨主動買入多、合約主動賣出多說明什麼?
常見情況是現貨有人持續買入,同時有人在合約市場做空或對沖現貨持倉。價格仍能上漲,說明現貨買盤足以吸收合約賣壓;價格走弱,說明合約賣壓佔了上風。可以結合合約持倉量一起看:持倉同時增加,多為新開空單;持倉減少,多為多頭平倉。
如何查看累計的買賣差?
使用「現貨聚合累計成交量差值(CVD)」接口,它在每個週期的主動買賣額之外,還給出逐週期累加的差值。
