獲取現貨交易對最近 90 天的足跡圖(Footprint)歷史,按週期返回每個價格區間的主動買入量、主動賣出量、成交額和成交筆數。適合分析現貨訂單流、尋找成交密集價位。
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
以下 API 等級可以調用本接口:專業 企業
響應數據
data 為陣列,每個元素是一個週期。週期是位置陣列,沒有欄位名,按位置讀取:[0] 週期開始時間(Unix 秒),[1] 本週期的價格檔位行;每一行對應一個價格區間,固定 10 個位置。下表中 data[].0 表示週期的第 1 個位置,data[].1[].0 表示某個價格檔位行的第 1 個位置(價格下界),以此類推。
時間單位:請求用毫秒,返回是秒
start_time、end_time傳毫秒時間戳;返回的週期開始時間data[].0是 Unix 秒級時間戳,例如1792458000。和其他接口的毫秒time對齊,或在 JavaScript 等按毫秒處理時間的語言裡轉日期時,需要先乘以 1000。
200 · application/json · 響應範例見右側面板。
| 欄位 | 類型 | 必返 | 說明 |
|---|---|---|---|
code | string | 是 | 業務狀態碼,"0" 表示成功 |
msg | string | 否 | 結果說明 |
data | array of array | 是 | 週期陣列;每個週期是位置陣列 [週期開始時間, 價格檔位行] |
data[].0 | integer | 是 | 位置 0:週期開始時間,Unix 秒級時間戳(UTC),不是毫秒 |
data[].1 | array of array | 是 | 位置 1:本週期的價格檔位行,每行對應一個價格區間,固定 10 個位置 |
data[].1[].0 | number | 是 | 檔位行位置 0:價格區間下界(起始價格),計價幣種 |
data[].1[].1 | number | 是 | 檔位行位置 1:價格區間上界(結束價格),計價幣種 |
data[].1[].2 | number | 是 | 檔位行位置 2:主動買入量,基礎幣數量(例如 BTC 的個數) |
data[].1[].3 | number | 是 | 檔位行位置 3:主動賣出量,基礎幣數量 |
data[].1[].4 | number | 是 | 檔位行位置 4:主動買入額,計價幣種(例如 USDT) |
data[].1[].5 | number | 是 | 檔位行位置 5:主動賣出額,計價幣種 |
data[].1[].6 | number | 是 | 檔位行位置 6:主動買入額,美元;BTCUSDT 與位置 4 的數值相同 |
data[].1[].7 | number | 是 | 檔位行位置 7:主動賣出額,美元;BTCUSDT 與位置 5 的數值相同 |
data[].1[].8 | integer | 是 | 檔位行位置 8:主動買入成交筆數 |
data[].1[].9 | integer | 是 | 檔位行位置 9:主動賣出成交筆數 |
數據量較大:Binance BTCUSDT 1 小時週期,每個週期約有 73~130 個價格檔位行,3 個週期的響應約 27 KB。請按需控制 limit 和時間範圍。
API 等級
只有下表中標為可以的 API 等級能調用本接口。各等級價格見 API 等級。
| API 等級 | 能否調用 |
|---|---|
| 業餘 | ❌ 不可以 |
| 創業 | ❌ 不可以 |
| 標準 | ❌ 不可以 |
| 專業 | ✅ 可以 |
| 企業 | ✅ 可以 |
用 AI 調用本接口
選一個任務,點「在 ChatGPT 中開啟」或「在 Claude 中開啟」,AI 會先讀取本頁說明,再直接給出結果;也可以點「複製」,把完整提示詞貼上到你常用的 AI 工具裡。
本接口透過 REST API 提供數據,可使用上方提示詞讓 AI 編寫調用代碼。MCP 可調用的工具見 CoinGlass MCP。
應用場景
| 場景 | 說明 |
|---|---|
| 找成交密集價位 | 按價格區間統計成交量,找出現貨成交最集中的價位,作為日內支撐或阻力參考。 |
| 識別買賣失衡 | 同一價格區間內主動買入遠大於主動賣出(或相反),說明該價位有一方在集中出手。 |
| 觀察吸收與衰竭 | 價格不再下跌但低位主動賣出很大,可能說明賣單被承接;高位主動買入放大卻漲不動,可能是買盤衰竭。 |
| 對照合約訂單流 | 與合約足跡圖歷史對照,看同一價位上現貨和合約哪一邊在主動買賣。 |
相關接口
| 接口 | 區別 |
|---|---|
| 合約足跡圖歷史 | 合約市場的足跡圖,支援的交易所不同 |
| 現貨累計成交量差值(CVD) | 不分價格區間,只看每個週期的買賣差和累計值 |
| 現貨交易對主動買賣歷史 | 每個週期的主動買賣成交額合計 |
| 現貨訂單簿歷史(熱力圖) | 盤口掛單,與成交數據互相印證 |
| 現貨支援的交易所和交易對 | 查詢 exchange 和 symbol 的可用寫法 |
常見問題
為什麼返回的時間是 10 位?
本接口返回的週期開始時間是秒級時間戳,例如 1792458000,需要乘以 1000 才能和其他接口的毫秒時間對齊。請求參數 start_time、end_time 仍然傳毫秒。
價格區間的寬度是固定的嗎?
不要按固定步長推算。價格檔位可能經過合併,請以每一行返回的下界(位置 0)和上界(位置 1)為準。
支援哪些交易所和交易對?
交易所支援 Binance、OKX、Bybit、Coinbase;交易對需為 USDT 或 USD 計價的現貨交易對,寫法以「現貨支援的交易所和交易對」接口為準,例如 OKX 為 BTC-USDT、Coinbase 為 BTC-USD。
能查詢多久的歷史?
最近 90 天。只有專業、企業等級可以調用本接口。
深入了解:現貨足跡圖(Footprint)
什麼是足跡圖?
足跡圖把每個週期拆成多個價格區間,顯示每個區間內主動買入和主動賣出各成交了多少,可以看到價格在每個位置是被誰推動的,是常見的訂單流分析工具。
足跡圖怎麼看買賣失衡?
比較同一價格區間(或相鄰區間)的主動買入量和主動賣出量。一方明顯多於另一方(例如 3 倍以上)時,通常視為失衡,連續出現的失衡價位常被當作支撐或阻力。
現貨足跡圖和合約足跡圖有什麼區別?
現貨足跡圖反映的是幣的實際買賣成交;合約足跡圖反映的是合約成交,通常帶槓桿。兩者支援的交易所也不同:現貨為 Binance、OKX、Bybit、Coinbase,合約為 Binance、OKX、Bybit、Hyperliquid。
