幣種主動買賣歷史

獲取某個幣種在指定交易所的合約主動買入與主動賣出成交額合計,按週期返回,單位為美元。可用 exchange_list 自選參與彙總的交易所,適合觀察全市場的買賣力量。

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

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

不同等級可查詢的數據週期不同,詳見本頁下方的「API 等級與可用週期」。

響應數據

data 為陣列,每個元素是一個週期,time 為週期的開始時間。成交額是所選交易所中該幣種多個合約交易對的合計(Binance 的 BTC 合計大於單個 BTCUSDT 交易對),單位為美元,以數字返回。也可能以字串返回,讀取時建議同時相容數字和字串。

📘

關於 unit 參數

本接口目前不讀取 unit 參數,傳入不會改變結果,只返回美元成交額,傳 coin 也不會得到幣的數量。需要幣的數量時,可改用「聚合累計成交量差值(CVD)」接口並傳 unit=coin。

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

欄位類型必返說明
codestring是業務狀態碼,"0" 表示成功
msgstring否結果說明
dataarray of object是週期陣列,每個元素是一個週期
data[].timeinteger(int64)是週期開始時間,毫秒時間戳(UTC)
data[].aggregated_buy_volume_usdnumber是所選交易所合計的主動買入成交額,美元
data[].aggregated_sell_volume_usdnumber是所選交易所合計的主動賣出成交額,美元

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 工具裡。

用 Python 獲取數據
讓 AI 寫一個 Python 函式,獲取三大交易所 BTC 最近 30 天的主動買賣額日線。
畫買賣差柱狀圖
讓 AI 寫代碼,把每天的主動買賣差畫成紅綠柱狀圖。
看懂這個接口
讓 AI 用白話解釋返回欄位和 exchange_list 的用法。

本接口透過 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)」接口,它在每個週期的主動買賣額之外,還給出逐週期累加的差值。

Query Params
string
required
Defaults to Binance

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

string
required
Defaults to BTC

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

string
required
Defaults to 1d

數據週期,例如 4h。可選 1m、3m、5m、15m、30m、1h、2h、4h、6h、8h、12h、1d、1w。能用的最短週期取決於 API 等級:業餘為 4h,創業為 30m,標準及以上為 1m。

int32
≤ 1000
Defaults to 1000

返回的週期數量,預設 1000,可傳 1~1000。同時傳 start_time 和 end_time 時,返回條數由時間範圍決定,不一定等於 limit。

int64

開始時間,毫秒時間戳(UTC),例如 1790812800000(2026-10-01 00:00 UTC)。返回數據的 time 滿足 start_time ≤ time < end_time:包含開始時間,不包含結束時間。

int64

結束時間,毫秒時間戳(UTC),例如 1792022400000(2026-10-15 00:00 UTC)。返回數據的 time 滿足 start_time ≤ time < end_time:包含開始時間,不包含結束時間。例如 interval=1d 時,上面兩個範例時間返回 10 月 1 日至 10 月 14 日,共 14 個週期。

string
Defaults to usd

返回數值的單位,選填,預設 usd。本接口目前不讀取此參數,傳入不會改變結果:始終返回美元成交額,傳 coin 也不會返回幣的數量。

Responses

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