/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 03:58:24 UTC。 为便于展示,较长的数组和映射已被截短:data 原有 87 项; expiries 原有 12 项。

  • {
    • "success": true,
    • "currency": "BTC",
    • "expiry": "all",
    • "index_price": 69009.96,
    • "snap_ts": 1794541801732,
    • "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 分钟(整份快照替换)
时间窗口
最新快照
数据来源
按行权价划分的期权持仓量,来自单一交易所(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 纪元毫秒(UTC)
响应格式
json
稳定性
稳定

实时状态

可用检查于 2026-11-13 03:58:24 UTCHTTP 2004 ms结构一致最新数据点距今 8m

近 30 天可用性

410 次检查中 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
选择一个端点,然后点击“发送请求”。响应、响应头和耗时将显示在这里。