期权统一快照 · REST 接口

一次请求即可获取股票、期权、外汇、加密货币等多资产类别的统一行情快照，涵盖最新成交、最新报价以及开盘价、最高价、最低价、收盘价与成交量等关键指标，可一览当前市场全貌。该接口把各来源数据聚合到一次响应中，便于高效监控、比较并据此操作跨市场、跨资产类别的信息。

GET /v3/snapshot

上游时效说明

延迟 15 分钟或实时

上游历史范围

该接口不适用

适用场景

跨市场分析、多元化组合监控、全球市场洞察、多资产交易策略。

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

查询参数

参数	类型	必填	说明
`ticker`	string	No	指定单个标的代码。代码区分大小写，非股票资产带前缀，例如股票 NVDA、期权 O:SPY280121C00750000、外汇 C:EURUSD、加密货币 X:BTCUSD、指数 I:SPX。若需请求多个标的或一个标的区间，请展开过滤修饰符。
`type`	string	No	按资产类型查询。
`ticker.gte`	string	No	按 ticker 范围筛选。
`ticker.gt`	string	No	按 ticker 范围筛选。
`ticker.lte`	string	No	按 ticker 范围筛选。
`ticker.lt`	string	No	按 ticker 范围筛选。
`ticker.any_of`	string	No	逗号分隔的标的代码列表，最多 250 个。若未传入任何代码，则以分页方式返回全部结果。注意：URL 可容纳的字符数上限取决于你的技术栈。
`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[].details`	object	该合约的详细信息。
`results[].error`	string	查找该标的时发生的错误。
`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	该合约的最新报价。仅当 Massive 上游套餐包含成交数据时才会返回。
`results[].market_status`	string	交易该标的的市场状态。股票、期权、加密货币与外汇快照的取值为 open、closed、early_trading 或 late_trading；指数快照的取值为 regular_trading、closed、early_trading 与 late_trading。
`results[].message`	string	查找该标的时的错误信息。
`results[].name`	string	该合约的名称。
`results[].open_interest`	number	截至上一交易日收盘时该合约的持仓量。
`results[].session`	object	完整的交易时段指标，给出该资产在当前交易日内的价格变动、成交量以及关键价格点（开盘价、收盘价、最高价、最低价），并分别列出盘前、常规与盘后时段的变动，便于做细致的表现分析与趋势跟踪。
`results[].ticker`	string	该资产的代码。
`results[].type`	enum: stocks, options, fx, crypto, indices	该标的所属的资产类别。
`results[].underlying_asset`	object	该期权合约底层标的股票的信息。返回的行情数据取决于当前的股票套餐。
`status`	string	本次请求响应的状态。

响应示例

{
  "request_id": "abc123",
  "results": [
    {
      "break_even_price": 171.075,
      "details": {
        "contract_type": "call",
        "exercise_style": "american",
        "expiration_date": "2022-10-14",
        "shares_per_contract": 100,
        "strike_price": 5,
        "underlying_ticker": "NCLH"
      },
      "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": 12,
        "ask_size": 110,
        "bid": 20.9,
        "bid_exchange": 10,
        "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"
      },
      "market_status": "closed",
      "name": "NCLH $5 Call",
      "open_interest": 8921,
      "session": {
        "change": -0.05,
        "change_percent": -1.07,
        "close": 6.65,
        "decimal_volume": "67.0",
        "early_trading_change": -0.01,
        "early_trading_change_percent": -0.03,
        "high": 7.01,
        "late_trading_change": -0.4,
        "late_trading_change_percent": -0.02,
        "low": 5.42,
        "open": 6.7,
        "previous_close": 6.71,
        "regular_trading_change": -0.6,
        "regular_trading_change_percent": -0.5,
        "volume": 67
      },
      "ticker": "O:NCLH221014C00005000",
      "type": "options",
      "underlying_asset": {
        "change_to_break_even": 23.123999999999995,
        "last_updated": 1636573459862384600,
        "price": 147.951,
        "ticker": "AAPL",
        "timeframe": "REAL-TIME"
      }
    },
    {
      "fmv": 0.05,
      "fmv_last_updated": 1636573458757383400,
      "last_minute": {
        "close": 412.05,
        "decimal_volume": "610.0",
        "high": 412.1,
        "low": 412.05,
        "open": 412.1,
        "transactions": 26,
        "volume": 610,
        "vwap": 412.0881
      },
      "last_quote": {
        "ask": 21.25,
        "ask_exchange": 300,
        "ask_size": 110,
        "bid": 20.9,
        "bid_exchange": 323,
        "bid_size": 172,
        "last_updated": 1636573458756383500,
        "timeframe": "REAL-TIME"
      },
      "last_trade": {
        "conditions": [
          209
        ],
        "decimal_size": "2.0",
        "exchange": 316,
        "id": "4064",
        "last_updated": 1675280958783136800,
        "price": 0.05,
        "size": 2,
        "timeframe": "REAL-TIME"
      },
      "market_status": "closed",
      "name": "Apple Inc.",
      "session": {
        "change": -1.05,
        "change_percent": -4.67,
        "close": 21.4,
        "decimal_volume": "37.0",
        "early_trading_change": -0.39,
        "early_trading_change_percent": -0.07,
        "high": 22.49,
        "late_trading_change": 1.2,
        "late_trading_change_percent": 3.92,
        "low": 21.35,
        "open": 22.49,
        "previous_close": 22.45,
        "volume": 37
      },
      "ticker": "AAPL",
      "type": "stocks"
    },
    {
      "error": "NOT_FOUND",
      "message": "Ticker not found.",
      "ticker": "TSLAAPL"
    }
  ],
  "status": "OK"
}

原文：Massive 文档 ↗

期权 统一快照 · REST 接口

适用场景

查询参数

响应字段

响应示例

期权统一快照 · REST 接口