現貨幣種主動買賣歷史

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

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

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

不同等級能用的最短週期不同,詳見本頁下方的「API 等級與可用週期」。

響應數據

data 為陣列,每個元素是一個週期,time 為週期的開始時間(毫秒)。成交額為所選交易所的現貨合計,單位為美元,以數字返回。

📘

關於 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 寫代碼,對比 BTC 現貨和合約每天的主動買賣差。
看懂這個接口
讓 AI 用白話解釋返回欄位和 exchange_list 的用法。

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

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 × limit 向前推算;結束時間晚於當前時間時按當前時間處理。

string
Defaults to usd

返回數值的單位。本接口目前不讀取此參數,傳入不會改變結果:不論傳 usd 還是 coin,返回的都是美元成交額,傳 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