24h成交量—未平倉—24h爆倉$1.36B24h多空比—BTC市佔—ETH市佔—
App
語言 ▾
NT$ TWD ▾
/api/options/oi-by-strike
GET可用

依行權價的期權 OI

依行權價的期權 OI

GET/api/options/oi-by-strike
單一交易所：僅依 Deribit 的公開期權資料計算。在交易所回報權利金成交額的情況下，`volume_usd` 類欄位以權利金為基礎。若需要涵蓋六家交易所並附各交易所覆蓋範圍的資料，請使用 `/api/sd/options/overview`。

請求

查詢參數

名稱型別必填預設值可用值說明
currencystring選填BTCBTC, ETH標的資產：`BTC` 或 `ETH`。其他任何值都會回傳 400 `INVALID_PARAM`。別名：`coin`。 範例: BTC
expirystring選填all—到期日；all = 所有到期日。

請求範例

curl -s "https://www.coinboss.com/api/options/oi-by-strike?currency=BTC"

回應欄位

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

欄位型別單位說明
successboolean—請求成功時為 true。失敗時回應內容為 `{ success: false, code, error, request_id }`。
currencystring—貨幣／資產代號。
expirystring—該期權系列的到期日。
index_pricenumber—標的的指數價格。
snap_tsnumberms快照的時間。
expiriesarray—期權／期貨到期日。
expiries[]string—期權／期貨到期日。
countnumber—項目數。
dataarray—回應主體資料。
data[]object—回應主體資料。
data[].strikenumberUSD行權價。
data[].call_oinumbercoin此行權價的 Deribit 看漲期權持倉量，為所選到期日的加總，以標的幣種數量計。
data[].put_oinumbercoin此行權價的 Deribit 看跌期權持倉量，為所選到期日的加總，以標的幣種數量計。
data[].call_oi_usdnumberUSD看漲期權的持倉量。
data[].put_oi_usdnumberUSD看跌期權的持倉量。

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

回應範例

/api/options/oi-by-strike?currency=BTC · 真實回應，擷取於 2026-11-13 04:02:54 UTC。 較長的陣列與對應表已截短顯示：data 原有 87 個項目; expiries 原有 12 個項目。

  • {
    • "success": true,
    • "currency": "BTC",
    • "expiry": "all",
    • "index_price": 68883.34,
    • "snap_ts": 1794542401947,
    • "expiries": [
      • "2026-11-13",
      • "2026-11-14",
      • "2026-11-15",
      • "2026-11-16",
      • "2026-11-20",
      • "2026-11-27",
      • "2026-12-04",
      • "2026-12-25"
      ],
    • "count": 87,
    • "data": [
      • { … 5 },
      • { … 5 }
      ]
    }

已驗證的樣本

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

參數HTTP延遲結果
currency=ETH2004 ms通過
currency=SOL4001 ms通過 回傳預期的錯誤

檢查於 2026-11-13 03:58:24 UTC

詳細資訊

身分驗證
無。公開端點。
速率限制
每個 IP 每分鐘 1200 次請求
伺服器快取
2m
邊緣微快取
10s
更新頻率
每 10 min（整份快照替換）
時間視窗
最新快照
資料來源
依行權價分列的期權持倉量，取自單一交易所（Deribit）的公開 API。
交易所覆蓋範圍
僅 Deribit 的 BTC 與 ETH 期權；不含其他交易所（Binance/OKX/Bybit 期權、CME）。僅限持倉量 > 0 的行權價。
排序
行權價升冪
單位
coins and USD notional
計算方法
Call and put open interest summed per strike, for one expiry or all expiries.
時間戳記
Unix epoch 毫秒（UTC），除非欄位說明另有註明
回應格式
json
穩定性
穩定版

即時狀態

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

近 30 天可用率

411 次檢查中有 99.76% 通過

錯誤

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

錯誤碼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/options/oi-by-strike可用
參數

string · 預設 BTC — Underlying: `BTC` or `ETH`. Any other value returns 400 `INVALID_PARAM`. Alias: `coin`.

string · 預設 all — Expiry; all = every expiry.

請求 URLhttps://www.coinboss.com/api/options/oi-by-strike?currency=BTC
選擇一個端點並按下「送出請求」。回應內容、標頭與耗時會顯示在這裡。