REST 接口 · 文档目录

期权 合约概览 · REST 接口

期权合约详情。获取指定期权合约的详细信息,包括合约类型(看涨或看跌)、行权方式、到期日、行权价、每张合约股数、底层标的代码与主交易所,是理解合约结构并纳入期权策略与组合评估的基础。

GET /v3/reference/options/contracts/{options_ticker}
上游时效说明

每日更新

上游历史范围

数据可追溯至 2014 年 6 月 2 日

适用场景

  • 合约规格查询、期权链分析、策略开发、组合集成。
接入地址与凭据以实际开通时下发为准。下面是上游字段定义与响应示例,文档收录不等于本站已开放全部能力。

查询参数

参数类型必填说明
options_tickerstringYes按期权代码查询合约。关于期权代码的构成,见相关说明。
as_ofstringNo指定该合约查询时点对应的日期,格式 YYYY-MM-DD,默认为当天。

响应字段

字段类型说明
request_idstring服务器分配的请求 ID。
resultsobject包含指定期权合约所请求的数据。
results.additional_underlyingsarray[object]若某期权合约附带额外的底层标的或交割物,会在此列出。关于哪些情况会造成合约附带额外底层标的,见相关示例。
results.cfistring该合约的 6 位 CFI 代码(定义于 ISO 10962)。
results.contract_typestring合约类型,可为 put、call,极少数情况下为 other。
results.correctioninteger该期权合约的更正序号。
results.exercise_styleenum: american, european, bermudan该合约的行权方式。关于行权方式的更多说明见相关文档。
results.expiration_datestring该合约的到期日,格式 YYYY-MM-DD。
results.primary_exchangestring该合约上市的主交易所 MIC 代码。
results.shares_per_contractnumber该合约每张对应的股数。
results.strike_pricenumber该期权合约的行权价。
results.tickerstring该期权合约的代码。
results.underlying_tickerstring该期权合约对应的底层标的代码。
statusstring本次请求响应的状态。

响应示例

{
  "request_id": "603902c0-a5a5-406f-bd08-f030f92418fa",
  "results": {
    "additional_underlyings": [
      {
        "amount": 44,
        "type": "equity",
        "underlying": "VMW"
      },
      {
        "amount": 6.53,
        "type": "currency",
        "underlying": "USD"
      }
    ],
    "cfi": "OCASPS",
    "contract_type": "call",
    "exercise_style": "american",
    "expiration_date": "2021-11-19",
    "primary_exchange": "BATO",
    "shares_per_contract": 100,
    "strike_price": 85,
    "ticker": "O:AAPL211119C00085000",
    "underlying_ticker": "AAPL"
  },
  "status": "OK"
}

原文:Massive 文档 ↗