現貨幣種市場數據歷史

獲取某個幣種每天的價格、流通量和市值歷史,一次返回全部記錄。適合分析幣種的長期市值變化、流通量增長,或比較不同幣種的市值走勢。

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

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

更新頻率每天

響應數據

data 為陣列,每個元素是一天的數據。本接口沒有時間範圍和條數參數,一次返回該幣種的全部記錄:截至 2026-10-20,symbol=BTC 返回 5943 條,最早一條為 2010-07-13(UTC),按每天一條計正好覆蓋到 2026-10-19;響應約 0.7 MB,右側範例只保留了前 2 條。

📘

數值類型不同

price、circulating_supply 以字串返回,market_cap 以數字返回。計算前請先把字串轉換為數字。

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

欄位類型必返說明
codestring是業務狀態碼,"0" 表示成功
msgstring否結果說明;出錯時為錯誤訊息
dataarray of object是每日數據陣列,每個元素是一天
data[].timestampinteger(int64)是日期,毫秒時間戳(UTC);範例為當天 00:00(UTC)
data[].pricestring是價格,美元;取當天記錄的開盤價
data[].circulating_supplystring是流通供應量,單位為該幣種的數量(如 BTC 的個數)
data[].market_capnumber是市值,美元

API 等級

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

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

用 AI 調用本接口

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

用 Python 獲取數據
讓 AI 寫一個 Python 函式,獲取 BTC 的全部市值歷史並畫圖。
對比多個幣種市值
讓 AI 寫代碼,比較 BTC、ETH、SOL 的市值走勢和 ETH/BTC 市值比。
看懂這個接口
讓 AI 用白話解釋返回欄位和使用注意事項。

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

應用場景

場景說明
長期市值走勢獲取幣種從有記錄以來每天的市值,繪製長期走勢或做週期研究。
流通量變化分析跟蹤 circulating_supply 的增長,估算幣種的年度增發速度。
幣種市值對比比較多個幣種的市值曲線,例如計算 ETH 與 BTC 的市值比。
研究與回測數據長週期的日級價格和市值,可作為宏觀研究或長期策略回測的基礎數據。

相關接口

接口區別
現貨幣種市場列表各幣種當前的價格、市值和成交額
現貨交易對價格歷史(K 線)單個交易所現貨交易對的分鐘到週級 K 線
現貨支援的幣種現貨幣種代碼列表
幣種市場列表(合約)合約市場的幣種指標,含市值和持倉

常見問題

能只取某一段時間嗎?

不能。本接口只有 symbol 一個參數,一次返回全部日級歷史(BTC 共 5943 條、約 0.7 MB),請在本地按 timestamp 篩選。

price 和 circulating_supply 為什麼是字串?

這是接口的返回格式,兩個欄位都以字串返回(如 "0.0618333200"),market_cap 則是數字。計算前請先轉換為數字,注意保留精度。

市值為什麼不等於 price × circulating_supply?

market_cap 是數據源提供的市值,而 price 取的是當天記錄的開盤價,兩者不一定對得上。例如 2010-07-13 這條,price × circulating_supply 約為 20.68 萬美元,market_cap 為 19.45 萬美元。需要兩者一致時,請用同一價格自行計算。

多久更新一次?

每天更新一次。

深入了解:幣種市值與流通量

什麼是流通供應量?

流通供應量指當前已經在市場上流通、可以自由交易的幣的數量,不包括尚未解鎖或未發行的部分。市值通常按價格乘以流通供應量計算。

如何用流通量估算增發速度?

取同一幣種相隔一年的兩條 circulating_supply,用(後值 − 前值)÷ 前值 × 100,就能得到這一年流通量增長的百分比,可用來比較不同幣種的通脹程度。

需要更細的價格數據怎麼辦?

本接口每天只有一條數據。需要分鐘、小時級的價格,請使用「現貨交易對價格歷史(K 線)」按交易所和交易對查詢。

Query Params
string
required
Defaults to BTC

幣種代碼,必填,例如 BTC、ETH。本接口使用單獨的幣種市值數據集,並非每個幣種都有記錄;查不到記錄時返回空陣列 [],不會報錯。

Response

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