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

期權隱含波動率歷史

期權隱含波動率歷史

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

請求

查詢參數

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

請求範例

curl -s "https://www.coinboss.com/api/options/iv-history?currency=BTC"

回應欄位

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

欄位型別單位說明
successboolean—請求成功時為 true。失敗時回應內容為 `{ success: false, code, error, request_id }`。
currencystring—貨幣／資產代號。
countnumber—項目數。
updated_atnumberms此資料列最近一次更新的時間。
rowsarray—結果資料列。
rows[]object—結果資料列。
rows[].datestring—日曆日期（UTC）。
rows[].atm_iv_30dnumber%固定 30 天期的平值隱含波動率，由 30 天前後的兩個到期日線性內插而得；每個 UTC 日一筆快照（年化，37.5 = 37.5 %）。
rows[].index_pricenumber—標的的指數價格。

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

回應範例

/api/options/iv-history?currency=BTC · 真實回應，擷取於 2026-11-13 04:02:54 UTC。 較長的陣列與對應表已截短顯示：rows 原有 132 個項目。

  • {
    • "success": true,
    • "currency": "BTC",
    • "count": 132,
    • "updated_at": 1794529604144,
    • "rows": [
      • { … 3 },
      • { … 3 }
      ]
    }

已驗證的樣本

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

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

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

詳細資訊

身分驗證
無。公開端點。
速率限制
每個 IP 每分鐘 1200 次請求
伺服器快取
10m
邊緣微快取
10s
更新頻率
每個 UTC 日一個資料點（每 30 min 檢查一次；當日資料點每個行程每天寫入一次）
時間視窗
自功能上線以來累積的所有每日資料點
資料來源
每日的 30 天平值隱含波動率，由 CoinBoss 依單一交易所（Deribit）的期權資料自行推算。
交易所覆蓋範圍
BTC 與 ETH；歷史僅自本地開始累積之日起存在（不回補）。
排序
日期升冪
單位
percent (annualized implied volatility); USD (index price)
計算方法
30-day ATM IV = linear interpolation by days-to-expiry between the ATM IVs of the two expiries surrounding 30 days.
時間戳記
Unix epoch 毫秒（UTC），除非欄位說明另有註明
回應格式
json
穩定性
穩定版

即時狀態

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

近 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/options/iv-history可用
參數

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

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