24h成交量—未平倉—24h爆倉$1.36B24h多空比—BTC市佔—ETH市佔—
App
語言 ▾
NT$ TWD ▾
/api/home/macro-cards
GET可用測試版

首頁總經卡片

首頁總經卡片（股票指數、美元、黃金……）

GET/api/home/macro-cards

請求

此端點不接受任何參數。

請求範例

curl -s "https://www.coinboss.com/api/home/macro-cards"

回應欄位

欄位表由真實回應產生，因此列出的正是端點實際回傳的內容。路徑中的 a[] 代表陣列元素，{*} 代表以動態名稱（例如幣種或交易所）為鍵的物件。

欄位型別單位說明
successboolean—請求成功時為 true。失敗時回應內容為 `{ success: false, code, error, request_id }`。
updated_atnumberms此資料列最近一次更新的時間。
mcapobject—市值。
mcap.latestnumber—最近一筆紀錄。
mcap.datestring—日曆日期（UTC）。
mcap.chg24h_pctnumber%24h 漲跌幅（百分比）。
mcap.sparkarray—供迷你走勢圖使用的近期小型序列。
mcap.spark[]number—供迷你走勢圖使用的近期小型序列。
mcap.has_cmcboolean—`spark` 中任一資料點來自回補的第三方歷史、而非本站自有的每日快照時為 true。
volumeobject—成交量。
volume.futuresnumber—合約市場區塊或數值。
volume.spotnumber—現貨市場區塊或數值。
volume.tsnumberms時間戳記。
volume.sparkarray—供迷你走勢圖使用的近期小型序列。
volume.spark[]object—供迷你走勢圖使用的近期小型序列。
volume.spark[].tnumberms時間戳記。
volume.spark[].fnumberUSD該 3 小時區間內 24h 合約成交量讀數的平均值。
volume.spark[].snumberUSD該 3 小時區間內 24h 現貨成交量讀數的平均值。
btc_candlesarray—供疊加顯示的 BTC K 線。
btc_candles[]array—供疊加顯示的 BTC K 線。
btc_candles[][]number—供疊加顯示的 BTC K 線。
fngobject—恐懼貪婪指數卡片：最新的 `value`、其標籤 `cls`，以及由近期每日數值組成的 `spark`；沒有資料時為 null。
fng.valuenumber—數值。
fng.clsstring—最新恐懼貪婪指數值的文字標籤，例如 `Fear` 或 `Greed`。
fng.sparkarray—供迷你走勢圖使用的近期小型序列。
fng.spark[]number—供迷你走勢圖使用的近期小型序列。
stablecoinobject—穩定幣卡片：以 USD 計的總流通價值（`total`）、穩定幣數量（`count`）及其 24h 與 7d 變化。
stablecoin.totalnumber—總數。
stablecoin.countnumber—項目數。
stablecoin.chg24h_pctnumber%24h 漲跌幅（百分比）。
stablecoin.chg7d_pctnumber%7 天漲跌幅（百分比）。
liqobject—爆倉金額或區塊。
liq.totalnumber—總數。
liq.longnumber—多方數值。
liq.shortnumber—空方數值。
liq.chg24h_pctnumber%24h 漲跌幅（百分比）。
liq.sparkarray—供迷你走勢圖使用的近期小型序列。
liq.spark[]number—供迷你走勢圖使用的近期小型序列。

產生於 2026-11-11 23:01 UTC，依據 1 筆真實回應。

回應範例

/api/home/macro-cards · 真實回應，擷取於 2026-11-13 03:59:25 UTC。 較長的陣列與對應表已截短顯示：fng.spark 原有 30 個項目; liq.spark 原有 57 個項目; mcap.spark 原有 90 個項目; btc_candles 原有 42 個項目; volume.spark 原有 57 個項目。

  • {
    • "success": true,
    • "updated_at": 1794542365066,
    • "mcap": {
      • "latest": 2476085584564.88,
      • "date": "2026-11-13",
      • "chg24h_pct": -3.19,
      • "spark": [ … 8 ],
      • "has_cmc": false
      },
    • "volume": {
      • "futures": 216570771117.84,
      • "spot": 66073226871.26,
      • "ts": 1794541800000,
      • "spark": [ … 2 ]
      },
    • "btc_candles": [
      • [ … 5 ],
      • [ … 5 ]
      ],
    • "fng": {
      • "value": 20,
      • "cls": "Extreme Fear",
      • "spark": [ … 8 ]
      },
    • "stablecoin": {
      • "total": 288099833329.21,
      • "count": 353,
      • "chg24h_pct": -0.53,
      • "chg7d_pct": -1.71
      },
    • "liq": {
      • "total": 1363532410.6799946,
      • "long": 1267567542.2399952,
      • "short": 95964868.44,
      • "chg24h_pct": 501.86,
      • "spark": [ … 8 ]
      }
    }

詳細資訊

身分驗證
無。公開端點。
速率限制
每個 IP 每分鐘 1200 次請求
伺服器快取
2m
邊緣微快取
10s
更新頻率
市值每日；成交量每 10 min；K 線每 5 min；恐懼貪婪指數每日；穩定幣每 10 min；API 快取 120 s
時間視窗
市值 90 天；成交量 7 天；BTC 4h K 線；恐懼貪婪指數 30 天；爆倉 24h
資料來源
首頁總經卡片：總市值（第三方行情資料聚合商市值的每日快照）、期貨成交量與爆倉（交易所資料）、BTC K 線（Binance）、恐懼貪婪指數（alternative.me）與穩定幣供應量（第三方來源）。
交易所覆蓋範圍
全市場
分頁
無
單位
USD; changes in percent; Fear & Greed 0-100
時間戳記
Unix epoch 毫秒（UTC），除非欄位說明另有註明
回應格式
json
穩定性
測試版

即時狀態

可用檢查於 2026-11-13 03:59:25 UTCHTTP 20012 ms結構描述相符最新資料點距今 0s

近 30 天可用率

408 次檢查中有 100% 通過

錯誤

所有端點的失敗回應都採用同一種結構。完整清單請見錯誤頁面。 錯誤與速率限制 →

錯誤碼HTTP意義處理方式
INVALID_PARAM400缺少必填參數，或某個值不被接受。已知時，`param` 會指出是哪個參數。請勿原樣重試；請修正請求。
UNAUTHORIZED401已送出 `CB-API-KEY` 標頭，但金鑰未知或已撤銷。公開資料不需要金鑰——請移除該標頭或改用有效的金鑰。請勿原樣重試。
FORBIDDEN403此路由不屬於公開 API（內部或僅限帳戶使用）。請勿重試。
NOT_FOUND404未知的路由，或所請求的幣種／交易所／基金不存在。請勿重試；請對照目錄檢查路徑與識別碼。
RATE_LIMITED429請求數超過每分鐘上限。`Retry-After` 會指出需等待的秒數。等待 `Retry-After` 指定的時間後，再以退避策略重試。
INTERNAL500非預期的伺服器錯誤。訊息刻意保持籠統；回報時請附上 `request_id`。幾秒後重試一次；若問題持續，請附上請求 ID 回報。
UPSTREAM_FAILED503此端點背後的資料來源未及時回應。不會以過期或替代的數字代替回傳。以退避策略重試；並查看狀態頁面。
UNAVAILABLE501 / 503資料集暫時尚未就緒（快取預熱中），或此端點目前尚無合法的公開來源。稍後重試；目錄會標示出設計上即無法使用的端點。
REQUEST_FAILED200部分舊版端點會以 HTTP 200 回應但帶有 `success: false`。請務必檢查 `success`，而不只是 HTTP 狀態碼。視訊息而定；請當作失敗的請求處理。

試用

GET/api/home/macro-cards可用
參數

無參數。

請求 URLhttps://www.coinboss.com/api/home/macro-cards
選擇一個端點並按下「送出請求」。回應內容、標頭與耗時會顯示在這裡。