獲取某個幣種每天的價格、流通量和市值歷史,一次返回全部記錄。適合分析幣種的長期市值變化、流通量增長,或比較不同幣種的市值走勢。
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
以下 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 · 響應範例見右側面板。
| 欄位 | 類型 | 必返 | 說明 |
|---|---|---|---|
code | string | 是 | 業務狀態碼,"0" 表示成功 |
msg | string | 否 | 結果說明;出錯時為錯誤訊息 |
data | array of object | 是 | 每日數據陣列,每個元素是一天 |
data[].timestamp | integer(int64) | 是 | 日期,毫秒時間戳(UTC);範例為當天 00:00(UTC) |
data[].price | string | 是 | 價格,美元;取當天記錄的開盤價 |
data[].circulating_supply | string | 是 | 流通供應量,單位為該幣種的數量(如 BTC 的個數) |
data[].market_cap | number | 是 | 市值,美元 |
API 等級
只有下表中標為可以的 API 等級能調用本接口。各等級價格見 API 等級。
| API 等級 | 能否調用 |
|---|---|
| 業餘 | ❌ 不可以 |
| 創業 | ✅ 可以 |
| 標準 | ✅ 可以 |
| 專業 | ✅ 可以 |
| 企業 | ✅ 可以 |
用 AI 調用本接口
選一個任務,點「在 ChatGPT 中開啟」或「在 Claude 中開啟」,AI 會先讀取本頁說明,再直接給出結果;也可以點「複製」,把完整提示詞貼上到你常用的 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 線)」按交易所和交易對查詢。
