期权期权链快照 · REST 接口

期权链快照。获取指定标的关联的全部期权合约快照，汇总每个合约的价格、希腊字母（delta、gamma、theta、vega）、隐含波动率、报价、成交与未平仓量，并给出标的当前价格与盈亏平衡点。一次请求即可获得完整期权链，便于比较各合约特征并优化策略。

GET /v3/snapshot/options/{underlyingAsset}

上游时效说明

延迟 15 分钟或实时

上游历史范围

该接口不适用

适用场景

市场总览、策略对比、研究与建模、组合优化。

接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例，文档收录不等于本站已开放全部能力。

查询参数

参数	类型	必填	说明
`underlyingAsset`	string	Yes	该期权合约的底层标的代码。
`strike_price`	number	No	按合约行权价查询。
`expiration_date`	string	No	按合约到期日查询，日期格式 YYYY-MM-DD。
`contract_type`	string	No	按合约类型查询。
`strike_price.gte`	number	No	按 strike_price 范围筛选。
`strike_price.gt`	number	No	按 strike_price 范围筛选。
`strike_price.lte`	number	No	按 strike_price 范围筛选。
`strike_price.lt`	number	No	按 strike_price 范围筛选。
`expiration_date.gte`	string	No	按 expiration_date 范围筛选。
`expiration_date.gt`	string	No	按 expiration_date 范围筛选。
`expiration_date.lte`	string	No	按 expiration_date 范围筛选。
`expiration_date.lt`	string	No	按 expiration_date 范围筛选。
`order`	string	No	按 sort 字段对结果排序。
`limit`	integer	No	限制返回结果数量，默认 10，最大 250。
`sort`	string	No	用于排序的字段。

响应字段

字段	类型	说明
`next_url`	string	若存在，可用该值获取下一页数据。
`request_id`	string	服务器分配的请求 ID。
`results`	array[object]	包含所请求数据的数组。
`results[].break_even_price`	number	该合约的底层标的资产盈亏平衡价。看涨期权为（行权价 + 已付权利金），看跌期权为（行权价 − 已付权利金）。
`results[].day`	object	该合约最新的一根日线。
`results[].details`	object	该合约的详细信息。
`results[].fmv`	number	Massive 的公允市场价值由其专有算法计算，提供可交易证券的实时估计公允价。上游仅向 Business 套餐提供；本站能否提供该数据，以实际开通清单为准。
`results[].fmv_last_updated`	integer	若公允市场价值（FMV）可用，该字段为最近一次 FMV 计算的纳秒时间戳。
`results[].greeks`	object	该合约的希腊值（greeks）。某些情况下不会返回希腊值，例如深度实值的期权合约。详见相关说明。
`results[].implied_volatility`	number	市场基于该期权当前价格对底层标的资产波动率的预期。
`results[].last_quote`	object	该合约的最新报价，仅当所购套餐包含报价数据时返回。
`results[].last_trade`	object	该合约的最新一笔成交。仅当当前套餐包含成交数据时才会返回。
`results[].open_interest`	number	截至上一交易日收盘时该合约的持仓量。
`results[].underlying_asset`	object	该期权合约底层标的股票的信息。返回的行情数据取决于当前的股票套餐。
`status`	string	本次请求响应的状态。

响应示例

{
  "request_id": "6a7e466379af0a71039d60cc78e72282",
  "results": [
    {
      "break_even_price": 151.2,
      "day": {
        "change": 4.5,
        "change_percent": 6.76,
        "close": 120.73,
        "high": 120.81,
        "last_updated": 1605195918507251700,
        "low": 118.9,
        "open": 119.32,
        "previous_close": 119.12,
        "volume": 868,
        "vwap": 119.31
      },
      "details": {
        "contract_type": "call",
        "exercise_style": "american",
        "expiration_date": "2022-01-21",
        "shares_per_contract": 100,
        "strike_price": 150,
        "ticker": "O:AAPL211022C000150000"
      },
      "fmv": 0.05,
      "fmv_last_updated": 1605195918508251600,
      "greeks": {
        "delta": 1,
        "gamma": 0,
        "theta": 0.00229,
        "vega": 0
      },
      "implied_volatility": 5,
      "last_quote": {
        "ask": 120.3,
        "ask_size": 4,
        "bid": 120.28,
        "bid_size": 8,
        "last_updated": 1605195918507251700,
        "midpoint": 120.29,
        "timeframe": "REAL-TIME"
      },
      "last_trade": {
        "conditions": [
          209
        ],
        "decimal_size": "2.0",
        "exchange": 316,
        "price": 0.05,
        "sip_timestamp": 1675280958783136800,
        "size": 2,
        "timeframe": "REAL-TIME"
      },
      "open_interest": 1543,
      "underlying_asset": {
        "change_to_break_even": 4.2,
        "last_updated": 1605195918507251700,
        "price": 147,
        "ticker": "AAPL",
        "timeframe": "DELAYED"
      }
    }
  ],
  "status": "OK"
}

原文：Massive 文档 ↗

期权 期权链快照 · REST 接口

适用场景

查询参数

响应字段

响应示例

期权期权链快照 · REST 接口