現貨足跡圖歷史

獲取現貨交易對最近 90 天的足跡圖(Footprint)歷史,按週期返回每個價格區間的主動買入量、主動賣出量、成交額和成交筆數。適合分析現貨訂單流、尋找成交密集價位。

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

以下 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 · 響應範例見右側面板。

欄位類型必返說明
codestring是業務狀態碼,"0" 表示成功
msgstring否結果說明
dataarray of array是週期陣列;每個週期是位置陣列 [週期開始時間, 價格檔位行]
data[].0integer是位置 0:週期開始時間,Unix 秒級時間戳(UTC),不是毫秒
data[].1array of array是位置 1:本週期的價格檔位行,每行對應一個價格區間,固定 10 個位置
data[].1[].0number是檔位行位置 0:價格區間下界(起始價格),計價幣種
data[].1[].1number是檔位行位置 1:價格區間上界(結束價格),計價幣種
data[].1[].2number是檔位行位置 2:主動買入量,基礎幣數量(例如 BTC 的個數)
data[].1[].3number是檔位行位置 3:主動賣出量,基礎幣數量
data[].1[].4number是檔位行位置 4:主動買入額,計價幣種(例如 USDT)
data[].1[].5number是檔位行位置 5:主動賣出額,計價幣種
data[].1[].6number是檔位行位置 6:主動買入額,美元;BTCUSDT 與位置 4 的數值相同
data[].1[].7number是檔位行位置 7:主動賣出額,美元;BTCUSDT 與位置 5 的數值相同
data[].1[].8integer是檔位行位置 8:主動買入成交筆數
data[].1[].9integer是檔位行位置 9:主動賣出成交筆數

數據量較大:Binance BTCUSDT 1 小時週期,每個週期約有 73~130 個價格檔位行,3 個週期的響應約 27 KB。請按需控制 limit 和時間範圍。

API 等級

只有下表中標為可以的 API 等級能調用本接口。各等級價格見 API 等級。

API 等級能否調用
業餘❌ 不可以
創業❌ 不可以
標準❌ 不可以
專業✅ 可以
企業✅ 可以

用 AI 調用本接口

選一個任務,點「在 ChatGPT 中開啟」或「在 Claude 中開啟」,AI 會先讀取本頁說明,再直接給出結果;也可以點「複製」,把完整提示詞貼上到你常用的 AI 工具裡。

解析成表格
讓 AI 寫一個 Python 函式,把位置陣列展開成帶列名的 DataFrame。
找成交最密集的價位
讓 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。

Query Params
string
required
Defaults to Binance

現貨交易所名稱,必填,例如 Binance。目前支援 Binance、OKX、Bybit、Coinbase,傳其他交易所會返回失敗提示 Exchange not supported。

string
required
Defaults to BTCUSDT

現貨交易對代碼,必填,例如 BTCUSDT。只支援以 USDT 或 USD 計價的交易對。各交易所寫法不同:Binance、Bybit 為 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。

int32
≤ 1000
Defaults to 100

返回的週期數量,預設 100,最大 1000,超過 1000 按 1000 處理。同時傳了 start_time 和 end_time 時,返回條數由時間範圍決定,可能多於 limit。

int64

開始時間,毫秒時間戳(UTC),例如 1792458000000。只能查詢最近 90 天的數據。返回週期滿足 start_time ≤ 週期開始時間 < end_time。

int64

結束時間,毫秒時間戳(UTC),例如 1792468800000。注意請求參數用毫秒,而返回的週期開始時間是秒。

Response

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