獲取某個幣種在指定交易所的合約主動買入與主動賣出成交額合計,按週期返回,單位為美元。可用 exchange_list 自選參與彙總的交易所,適合觀察全市場的買賣力量。
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
以下 API 等級均可調用本接口:業餘 創業 標準 專業 企業
不同等級可查詢的數據週期不同,詳見本頁下方的「API 等級與可用週期」。
響應數據
data 為陣列,每個元素是一個週期,time 為週期的開始時間。成交額是所選交易所中該幣種多個合約交易對的合計(Binance 的 BTC 合計大於單個 BTCUSDT 交易對),單位為美元,以數字返回。也可能以字串返回,讀取時建議同時相容數字和字串。
關於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 寫錯了會報錯嗎?
不一定。寫錯或不支援的交易所名稱可能被直接忽略,返回的只是其餘交易所的合計。建議先用「支援的交易所」接口核對名稱。
同時傳了 start_time 和 end_time,為什麼返回條數和 limit 不一樣?
同時傳開始和結束時間時,返回哪些週期由時間範圍決定,條數不一定等於 limit。例如 interval=1h、limit=2,時間範圍為 3 小時,返回了 3 條。只想要固定條數時,可以不傳時間(以當前時間為終點向前取),或只傳 start_time 和 limit。
為什麼最後一個週期的數值一直在變?
以當前時間為終點查詢時(例如不傳 end_time),最後一條通常是尚未結束的週期,成交額會隨新成交繼續累加。做統計或回測時,建議只用已結束的週期。
深入了解:全市場主動買賣成交額
為什麼要看多個交易所的合計?
單個交易所的主動買賣可能受個別大戶或平台活動影響,合計後更能反映整個市場的買賣傾向。
主動買賣差和價格背離說明什麼?
價格上漲而主動賣出額持續大於買入額,說明上漲中有人在持續拋售,走勢可能轉弱;價格下跌而主動買入佔優,可能有資金在逢低承接。
如何查看累計的買賣差?
使用「聚合累計成交量差值(CVD)」接口,它在每個週期的主動買賣額之外,還給出逐週期累加的差值。
