現貨交易對主動買賣歷史

獲取某個交易所、某個現貨交易對的主動買入與主動賣出成交額歷史,按週期返回,單位為美元。適合觀察現貨市場的買賣力量對比,或計算主動買賣比。

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

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

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

響應數據

data 為陣列,每個元素是一個週期,time 為週期的開始時間(毫秒)。成交額的單位為美元。

📘

成交額可能是數字,也可能是字串

同一次請求返回的 3 條數據中,有的成交額以數字返回(例如 23461495.6515),有的以字串返回。解析時請統一轉換為數字再計算,例如 Python 用 float()、JavaScript 用 Number()。

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

欄位類型必返說明
codestring是業務狀態碼,"0" 表示成功
msgstring否結果說明
dataarray of object是週期陣列,每個元素是一個週期
data[].timeinteger(int64)是週期開始時間,毫秒時間戳(UTC)
data[].taker_buy_volume_usdstring 或 number是週期內主動買入成交額,美元;可能是數字,也可能是字串
data[].taker_sell_volume_usdstring 或 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 工具裡。

計算主動買賣比
讓 AI 寫一個 Python 函式,獲取 Binance BTCUSDT 現貨最近 7 天的小時級主動買賣額並計算買賣比。
對比現貨和合約
讓 AI 寫代碼,把同一幣種現貨和合約的主動買賣差畫在一張圖裡。
看懂這個接口
讓 AI 用白話解釋參數、返回欄位和主動買賣的含義。

本接口透過 REST API 提供數據,可使用上方提示詞讓 AI 編寫調用代碼。MCP 可調用的工具見 CoinGlass MCP。

應用場景

場景說明
判斷現貨買賣力量主動買入額持續高於主動賣出額,說明現貨市價買單更積極;反之說明現貨賣壓更重。
計算主動買賣比用買入額除以賣出額得到主動買賣比,大於 1 表示主動買入佔優,適合做趨勢確認指標。
對照價格走勢與現貨交易對價格歷史(K 線)按 time 對齊,觀察放量上漲或下跌時是哪一方在主導。
與合約對比與合約交易對主動買賣歷史對比,判斷行情主要由現貨買盤還是合約資金推動。

相關接口

接口區別
現貨幣種主動買賣歷史多個交易所合計的現貨幣種主動買賣額
現貨累計成交量差值(CVD)同一交易對的主動買賣額,並附帶累計差值
現貨足跡圖歷史按價格區間拆分的主動買賣量
合約交易對主動買賣歷史合約市場的同類數據,成交額以字串返回
現貨支援的交易所和交易對查詢 exchange 和 symbol 的可用寫法

常見問題

symbol 應該填什麼?

這裡填現貨交易對,而不是幣種,例如 Binance 的 BTC 現貨是 BTCUSDT。不同交易所的寫法不同,例如 OKX 為 BTC-USDT、Coinbase 為 BTC-USD,請以「現貨支援的交易所和交易對」接口返回的為準。注意現貨與合約的寫法也不同,例如 OKX 合約是 BTC-USDT-SWAP,不能填到現貨接口裡。

成交額為什麼有時是數字、有時是字串?

同一次響應裡可能混用兩種類型,也可能只出現其中一種。兩種寫法表示的都是美元成交額,解析時請統一轉換為數字再計算,不要按固定類型解析。

同時傳了 start_time 和 end_time,為什麼返回條數和 limit 不一樣?

同時傳開始和結束時間時,返回哪些週期由時間範圍決定,條數不一定等於 limit。例如 interval=1h、limit=2,時間範圍為 3 小時,返回了 3 條。只想要固定條數時,可以不傳時間(以當前時間為終點向前取),或只傳 start_time 和 limit。

為什麼最後一條的數值一直在變?

最後一條對應尚未結束的週期,成交額會隨新成交不斷累加,所以每次請求的數值可能不同。

深入了解:現貨主動買賣成交額

什麼是現貨主動買入和主動賣出?

主動買入(Taker Buy)指用市價單或立即成交的限價單吃掉賣單,主動賣出(Taker Sell)則是吃掉買單。主動成交的一方願意付出價差立即成交,更能反映交易者的急迫程度。

現貨和合約的主動買賣有什麼區別?

現貨成交是幣的實際買賣,買入後得到的是幣本身;合約成交買賣的是合約,通常帶槓桿,也可以直接做空。現貨主動買入放大通常被視為真實需求,合約主動買入則可能只是槓桿資金的短線行為,兩者結合看更容易判斷行情由誰推動。

如何獲取多個交易所的現貨合計?

使用「現貨幣種主動買賣歷史」接口,傳幣種和 exchange_list,即可得到多個交易所的現貨合計。

Query Params
string
required
Defaults to Binance

現貨交易所名稱,必填,例如 Binance、OKX。可查詢的交易所見「現貨支援的交易所和交易對」接口。

string
required
Defaults to BTCUSDT

現貨交易對代碼,必填,例如 BTCUSDT。這裡填交易對,不是幣種;不同交易所的寫法不同,例如 OKX 為 BTC-USDT、Coinbase 為 BTC-USD,可查詢的交易對見「現貨支援的交易所和交易對」接口。

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

Responses

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