/api/exchanges/detail
GET可用

單一交易所的衍生品總覽

單一交易所的衍生品總覽(OI、成交量、幣種數……)

GET/api/exchanges/detail

請求

查詢參數

名稱型別必填預設值可用值說明
exstring必填——交易所 ID(會轉為小寫,僅限 a-z0-9.);缺少時回傳 400。 範例: binance

請求範例

curl -s "https://www.coinboss.com/api/exchanges/detail?ex=binance"

回應欄位

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

欄位型別單位說明
successboolean—請求成功時為 true。失敗時回應內容為 `{ success: false, code, error, request_id }`。
dataobject—回應主體資料。
data.exchangestring—交易所 ID,小寫(例如 `binance`)。
data.namestring—名稱。
data.volume_usdnumberUSD成交量,以 USD 名義價值計。
data.oi_usdnumberUSD持倉量,以 USD 名義價值計。
data.liq_24h_longnumber—24h 多單爆倉金額。
data.liq_24h_shortnumber—24h 空單爆倉金額。
data.liq_24h_totalnumber—24h 爆倉總額。
data.liq_24h_cntnumbercount該交易所過去 24 小時內記錄到的爆倉單筆數;交易所沒有爆倉資料來源時為 null。
data.liq_sourceboolean—該交易所過去 7 天內有爆倉紀錄時為 true;為 false 時 `liq_24h_*` 欄位為 null,而非 0。
data.contractsnumber—各合約的資料列。
data.options_vol_usdnullUSD保留給該交易所的期權成交量;目前尚未填入,因此數值一律為 null。
data.taker_feenumber%USDT 永續合約的基礎等級吃單手續費,取自交易所的公開費率表(0.05 = 0.05 %);為靜態參考值,未知時為 null。
data.maker_feenumber%USDT 永續合約的基礎等級掛單手續費,取自交易所的公開費率表(0.02 = 0.02 %);為靜態參考值,未知時為 null。
data.is_dexboolean—去中心化永續合約交易所(例如 Hyperliquid、dYdX、Aster)為 true,中心化交易所為 false。
data.scorenumber—評分。
data.has_lsboolean—此交易所有多空比資料時為 true。
data.total_assets_usdnumber|nullUSD該交易所已揭露錢包中持有的總資產(與 `reserve.tvl_usd` 相同),取自第三方來源;未涵蓋時為 null。
data.reserveobject|null—該交易所已揭露錢包的儲備快照,取自第三方來源,約每 6 小時更新一次;該交易所未涵蓋時為 null。
data.reserve.tvl_usdnumberUSD總鎖倉價值。
data.reserve.clean_tvl_usdnumberUSD不含交易所自家平台幣的錢包資產,依第三方來源的定義;未公布時為 null。
data.reserve.inflow_24hnumberUSD過去 24 小時流入該交易所錢包的淨流入(負值 = 淨流出),依第三方來源回報。
data.reserve.inflow_1wnumberUSD過去 7 天流入該交易所錢包的淨流入(負值 = 淨流出),依第三方來源回報。
data.reserve.inflow_1mnumberUSD過去一個月流入該交易所錢包的淨流入(負值 = 淨流出),依第三方來源回報。
data.reserve.wallets_linkstring—該交易所自行揭露錢包或儲備證明的頁面 URL;未知時為 null。
data.reserve.updated_atnumberms此資料列最近一次更新的時間。
data.dist_oiarray—此交易所持倉量前 20 名的幣種,由大到小排列;近期未更新的合約不計入。
data.dist_oi[]object—單一幣種:`coin` 為基礎資產,`v` 為其在此交易所的持倉量(USD)。
data.dist_oi[].coinstring—幣種代號,大寫(例如 BTC)。
data.dist_oi[].vnumber—數值。
data.dist_volarray—此交易所 24 小時合約成交量前 20 名的幣種,由大到小排列;1 小時內未更新的行情不計入。
data.dist_vol[]object—單一幣種:`coin` 為基礎資產,`v` 為其在此交易所的 24 小時成交量(USD)。
data.dist_vol[].coinstring—幣種代號,大寫(例如 BTC)。
data.dist_vol[].vnumber—數值。

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

回應範例

/api/exchanges/detail?ex=binance · 真實回應,擷取於 2026-11-13 03:52:50 UTC。 較長的陣列與對應表已截短顯示:data.dist_oi 原有 20 個項目; data.dist_vol 原有 20 個項目。

  • {
    • "success": true,
    • "data": {
      • "exchange": "binance",
      • "name": "Binance",
      • "volume_usd": 65939302653.96,
      • "oi_usd": 24379577678.85,
      • "liq_24h_long": 417516080.56,
      • "liq_24h_short": 15925112.83,
      • "liq_24h_total": 433441193.39,
      • "liq_24h_cnt": 45872,
      • "liq_source": true,
      • "contracts": 762,
      • "options_vol_usd": null,
      • "taker_fee": 0.05,
      • "maker_fee": 0.02,
      • "is_dex": false,
      • "score": 96,
      • "has_ls": true,
      • "total_assets_usd": 121135381605.44,
      • "reserve": { … 7 },
      • "dist_oi": [ … 2 ],
      • "dist_vol": [ … 2 ]
      }
    }

已驗證的樣本

除了上方的範例之外,探針還會以下列參數呼叫此端點,並在每次呼叫時檢查結構描述。

參數HTTP延遲結果
ex=okx200164 ms通過
ex=hyperliquid200179 ms通過
—4001 ms通過 回傳預期的錯誤

檢查於 2026-11-13 03:28:10 UTC

詳細資訊

身分驗證
無。公開端點。
速率限制
每個 IP 每分鐘 1200 次請求
伺服器快取
30s
邊緣微快取
10s
更新頻率
行情每 1 min;OI 每 5 min;儲備每 6 h;記憶體快取 30 s
時間視窗
24h 滾動成交量與爆倉
資料來源
各交易所的概況,彙整自該交易所的公開 API(成交量、OI、合約)、爆倉串流與第三方來源的 CEX 儲備資料。
交易所覆蓋範圍
任何已採集的衍生品交易場所;儲備資料僅限由第三方來源追蹤的 10 家交易場所
分頁
無
單位
USD; score 1-99
計算方法
score = clamp(1..99, round(log10(vol + 10) / 11.2 * 70 + log10(oi + 10) / 11 * 30))
時間戳記
Unix epoch 毫秒(UTC),除非欄位說明另有註明
回應格式
json
穩定性
穩定版

即時狀態

可用檢查於 2026-11-13 03:52:50 UTCHTTP 200177 ms結構描述相符最新資料點距今 4.7h

近 30 天可用率

409 次檢查中有 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/exchanges/detail可用
參數

string — Exchange id (lower-cased, a-z0-9. only); 400 when missing.

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