/api/volume/coin-ex-share
GET可用

單一幣種成交量的交易所佔比

單一幣種成交量的交易所佔比

GET/api/volume/coin-ex-share

請求

查詢參數

名稱型別必填預設值可用值說明
coinstring選填ETH—基礎幣種代號(大寫,例如 BTC)。 範例: ETH

請求範例

curl -s "https://www.coinboss.com/api/volume/coin-ex-share?coin=ETH"

回應欄位

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

欄位型別單位說明
successboolean—請求成功時為 true。失敗時回應內容為 `{ success: false, code, error, request_id }`。
tsnumberms時間戳記。
coinstring—幣種代號,大寫(例如 BTC)。
sincenumber—該期間的起始時間。
coinsarray—幣種。
coins[]string—幣種。
exchangesarray—交易所。
exchanges[]object—交易所。
exchanges[].exchangestring—交易所 ID,小寫(例如 `binance`)。
exchanges[].volnumber—成交量。
exchanges[].sharenumber—佔總額的比例。
historyobject—歷史資料點,除非另有註明,否則由舊到新排列。
history.binancearray—交易所 `binance` 的數值(鍵為交易所 ID)。
history.binance[]array—交易所 `binance` 的數值(鍵為交易所 ID)。
history.binance[][]number—交易所 `binance` 的數值(鍵為交易所 ID)。
history.bitfinexarray—交易所 `bitfinex` 的數值(鍵為交易所 ID)。
history.bitfinex[]array—交易所 `bitfinex` 的數值(鍵為交易所 ID)。
history.bitfinex[][]number—交易所 `bitfinex` 的數值(鍵為交易所 ID)。
history.bitgetarray—交易所 `bitget` 的數值(鍵為交易所 ID)。
history.bitget[]array—交易所 `bitget` 的數值(鍵為交易所 ID)。
history.bitget[][]number—交易所 `bitget` 的數值(鍵為交易所 ID)。
history.bitstamparray—交易所 `bitstamp` 的數值(鍵為交易所 ID)。
history.bitstamp[]array—交易所 `bitstamp` 的數值(鍵為交易所 ID)。
history.bitstamp[][]number—交易所 `bitstamp` 的數值(鍵為交易所 ID)。
history.bybitarray—交易所 `bybit` 的數值(鍵為交易所 ID)。
history.bybit[]array—交易所 `bybit` 的數值(鍵為交易所 ID)。
history.bybit[][]number—交易所 `bybit` 的數值(鍵為交易所 ID)。
history.coinbasearray—交易所 `coinbase` 的數值(鍵為交易所 ID)。
history.coinbase[]array—交易所 `coinbase` 的數值(鍵為交易所 ID)。
history.coinbase[][]number—交易所 `coinbase` 的數值(鍵為交易所 ID)。
history.cryptocomarray—交易所 `cryptocom` 的數值(鍵為交易所 ID)。
history.cryptocom[]array—交易所 `cryptocom` 的數值(鍵為交易所 ID)。
history.cryptocom[][]number—交易所 `cryptocom` 的數值(鍵為交易所 ID)。
history.gatearray—交易所 `gate` 的數值(鍵為交易所 ID)。
history.gate[]array—交易所 `gate` 的數值(鍵為交易所 ID)。
history.gate[][]number—交易所 `gate` 的數值(鍵為交易所 ID)。
history.geminiarray—交易所 `gemini` 的數值(鍵為交易所 ID)。
history.gemini[]array—交易所 `gemini` 的數值(鍵為交易所 ID)。
history.gemini[][]number—交易所 `gemini` 的數值(鍵為交易所 ID)。
history.htxarray—交易所 `htx` 的數值(鍵為交易所 ID)。
history.htx[]array—交易所 `htx` 的數值(鍵為交易所 ID)。
history.htx[][]number—交易所 `htx` 的數值(鍵為交易所 ID)。
history.krakenarray—交易所 `kraken` 的數值(鍵為交易所 ID)。
history.kraken[]array—交易所 `kraken` 的數值(鍵為交易所 ID)。
history.kraken[][]number—交易所 `kraken` 的數值(鍵為交易所 ID)。
history.mexcarray—交易所 `mexc` 的數值(鍵為交易所 ID)。
history.mexc[]array—交易所 `mexc` 的數值(鍵為交易所 ID)。
history.mexc[][]number—交易所 `mexc` 的數值(鍵為交易所 ID)。
history.okxarray—交易所 `okx` 的數值(鍵為交易所 ID)。
history.okx[]array—交易所 `okx` 的數值(鍵為交易所 ID)。
history.okx[][]number—交易所 `okx` 的數值(鍵為交易所 ID)。
history.upbitarray—交易所 `upbit` 的數值(鍵為交易所 ID)。
history.upbit[]array—交易所 `upbit` 的數值(鍵為交易所 ID)。
history.upbit[][]number—交易所 `upbit` 的數值(鍵為交易所 ID)。

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

回應範例

/api/volume/coin-ex-share?coin=ETH · 真實回應,擷取於 2026-11-13 04:02:50 UTC。 較長的陣列與對應表已截短顯示:coins 原有 2487 個項目; exchanges 原有 14 個項目; history.htx 原有 288 個項目; history.okx 原有 288 個項目; history.gate 原有 288 個項目; history.mexc 原有 288 個項目。

  • {
    • "success": true,
    • "ts": 1794541800000,
    • "coin": "ETH",
    • "since": 1794369600000,
    • "coins": [
      • "00",
      • "0G",
      • "1000CAT",
      • "1000CHEEMS",
      • "1000SATS",
      • "10SET",
      • "1INCH",
      • "1MBABYDOGE"
      ],
    • "exchanges": [
      • { … 3 },
      • { … 3 }
      ],
    • "history": {
      • "binance": [ … 2 ],
      • "bitfinex": [ … 2 ],
      • "bitget": [ … 2 ],
      • "bitstamp": [ … 2 ],
      • "bybit": [ … 2 ],
      • "coinbase": [ … 2 ],
      • "cryptocom": [ … 2 ],
      • "gate": [ … 2 ],
      • "gemini": [ … 2 ],
      • "htx": [ … 2 ],
      • "kraken": [ … 2 ],
      • "mexc": [ … 2 ],
      • "okx": [ … 2 ],
      • "upbit": [ … 2 ]
      }
    }

詳細資訊

身分驗證
無。公開端點。
速率限制
每個 IP 每分鐘 1200 次請求
伺服器快取
10m
邊緣微快取
10s
更新頻率
每 10 min;API 快取 600 s
時間視窗
24h 滾動(最新快照);歷史僅限最近 48 h
資料來源
單一幣種依交易所拆分的現貨 24h 成交量,取自我們每 10 分鐘擷取的交易所行情快照。
交易所覆蓋範圍
在任一追蹤中的現貨交易所 24h 成交量至少 5,000 USD 的幣種;coin 預設為 ETH
分頁
無
排序
成交量降冪
單位
USD
計算方法
share = exchange volume for the coin / SUM across exchanges * 100
時間戳記
Unix epoch 毫秒(UTC),除非欄位說明另有註明
回應格式
json
穩定性
穩定版

即時狀態

可用檢查於 2026-11-13 04:02:50 UTCHTTP 2002 ms結構描述相符最新資料點距今 13m

近 30 天可用率

411 次檢查中有 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/volume/coin-ex-share可用
參數

string · 預設 ETH — Base coin symbol (uppercase, e.g. BTC).

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