獲取某個交易所、某個現貨交易對的主動買入與主動賣出成交額歷史,按週期返回,單位為美元。適合觀察現貨市場的買賣力量對比,或計算主動買賣比。
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
以下 API 等級均可調用本接口:業餘 創業 標準 專業 企業
不同等級能用的最短週期不同,詳見本頁下方的「API 等級與可用週期」。
響應數據
data 為陣列,每個元素是一個週期,time 為週期的開始時間(毫秒)。成交額的單位為美元。
成交額可能是數字,也可能是字串同一次請求返回的 3 條數據中,有的成交額以數字返回(例如
23461495.6515),有的以字串返回。解析時請統一轉換為數字再計算,例如 Python 用float()、JavaScript 用Number()。
200 · application/json · 響應範例見右側面板。
| 欄位 | 類型 | 必返 | 說明 |
|---|---|---|---|
code | string | 是 | 業務狀態碼,"0" 表示成功 |
msg | string | 否 | 結果說明 |
data | array of object | 是 | 週期陣列,每個元素是一個週期 |
data[].time | integer(int64) | 是 | 週期開始時間,毫秒時間戳(UTC) |
data[].taker_buy_volume_usd | string 或 number | 是 | 週期內主動買入成交額,美元;可能是數字,也可能是字串 |
data[].taker_sell_volume_usd | string 或 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。
應用場景
| 場景 | 說明 |
|---|---|
| 判斷現貨買賣力量 | 主動買入額持續高於主動賣出額,說明現貨市價買單更積極;反之說明現貨賣壓更重。 |
| 計算主動買賣比 | 用買入額除以賣出額得到主動買賣比,大於 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,即可得到多個交易所的現貨合計。
