期权期权合约快照 · REST 接口

期权合约快照。将指定期权合约的关键指标与行情数据汇总在单个响应中，包括盈亏平衡价、日间变动、隐含波动率、未平仓量、希腊字母（delta、gamma、theta、vega）以及最新报价与成交，并给出标的当前价格。

GET /v3/snapshot/options/{underlyingAsset}/{optionContract}

上游时效说明

延迟 15 分钟或实时

上游历史范围

该接口不适用

适用场景

成交评估、市场分析、风险评估、策略优化。

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

查询参数

参数	类型	必填	说明
`underlyingAsset`	string	Yes	该期权合约的底层标的代码。
`optionContract`	string	Yes	期权合约的标识。

响应字段

字段	类型	说明
`next_url`	string	若存在，可用该值获取下一页数据。
`request_id`	string	服务器分配的请求 ID。
`results`	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": "d9ff18dac69f55c218f69e4753706acd",
  "results": {
    "break_even_price": 171.075,
    "day": {
      "change": -1.05,
      "change_percent": -4.67,
      "close": 21.4,
      "high": 22.49,
      "last_updated": 1636520400000000000,
      "low": 21.35,
      "open": 22.49,
      "previous_close": 22.45,
      "volume": 37,
      "vwap": 21.6741
    },
    "details": {
      "contract_type": "call",
      "exercise_style": "american",
      "expiration_date": "2023-06-16",
      "shares_per_contract": 100,
      "strike_price": 150,
      "ticker": "O:AAPL230616C00150000"
    },
    "fmv": 0.05,
    "fmv_last_updated": 1636573458757383400,
    "greeks": {
      "delta": 0.5520187372272933,
      "gamma": 0.00706756515659829,
      "theta": -0.018532772783847958,
      "vega": 0.7274811132998142
    },
    "implied_volatility": 0.3048997097864957,
    "last_quote": {
      "ask": 21.25,
      "ask_exchange": 301,
      "ask_size": 110,
      "bid": 20.9,
      "bid_exchange": 301,
      "bid_size": 172,
      "last_updated": 1636573458756383500,
      "midpoint": 21.075,
      "timeframe": "REAL-TIME"
    },
    "last_trade": {
      "conditions": [
        209
      ],
      "exchange": 316,
      "price": 0.05,
      "sip_timestamp": 1675280958783136800,
      "size": 2,
      "timeframe": "REAL-TIME"
    },
    "open_interest": 8921,
    "underlying_asset": {
      "change_to_break_even": 23.123999999999995,
      "last_updated": 1636573459862384600,
      "price": 147.951,
      "ticker": "AAPL",
      "timeframe": "REAL-TIME"
    }
  },
  "status": "OK"
}

原文：Massive 文档 ↗

期权 期权合约快照 · REST 接口

适用场景

查询参数

响应字段

响应示例

期权期权合约快照 · REST 接口