期权全部合约 · REST 接口

期权合约索引。获取期权合约的完整索引，涵盖正在交易与已到期合约，可返回全量或按特定标的筛选。每个合约条目包含合约类型（看涨或看跌）、行权方式、到期日与行权价等信息，可用于评估市场供给并筛选符合条件的合约。

GET /v3/reference/options/contracts

上游时效说明

每日更新

上游历史范围

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

适用场景

市场供给分析、策略开发、研究与建模、合约探索。

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

查询参数

参数	类型	必填	说明
`underlying_ticker`	string	No	按底层标的股票代码查询相关合约。
`ticker`	string	No	该参数已弃用。要按具体的期权代码查询，请使用期权合约接口。
`contract_type`	string	No	按合约类型查询。
`expiration_date`	string	No	按合约到期日查询，日期格式 YYYY-MM-DD。
`as_of`	string	No	指定合约查询时点对应的日期，格式 YYYY-MM-DD，默认为当天。
`strike_price`	number	No	按合约行权价查询。
`expired`	boolean	No	是否查询已到期合约，默认为 false。
`underlying_ticker.gte`	string	No	按 underlying_ticker 范围筛选。
`underlying_ticker.gt`	string	No	按 underlying_ticker 范围筛选。
`underlying_ticker.lte`	string	No	按 underlying_ticker 范围筛选。
`underlying_ticker.lt`	string	No	按 underlying_ticker 范围筛选。
`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 范围筛选。
`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 范围筛选。
`order`	string	No	按 sort 字段对结果排序。
`limit`	integer	No	限制返回结果数量，默认 10，最大 1000。
`sort`	string	No	用于排序的字段。

响应字段

字段	类型	说明
`next_url`	string	若存在，可用该值获取下一页数据。
`request_id`	string	服务器分配的请求 ID。
`results`	array[object]	包含所请求数据的数组。
`results[].additional_underlyings`	array[object]	若某期权合约附带额外的底层标的或交割物，会在此列出。关于哪些情况会造成合约附带额外底层标的，见相关示例。
`results[].cfi`	string	该合约的 6 位 CFI 代码（定义于 ISO 10962）。
`results[].contract_type`	string	合约类型，可为 put、call，极少数情况下为 other。
`results[].correction`	integer	该期权合约的更正序号。
`results[].exercise_style`	enum: american, european, bermudan	该合约的行权方式。关于行权方式的更多说明见相关文档。
`results[].expiration_date`	string	该合约的到期日，格式 YYYY-MM-DD。
`results[].primary_exchange`	string	该合约上市的主交易所 MIC 代码。
`results[].shares_per_contract`	number	该合约每张对应的股数。
`results[].strike_price`	number	该期权合约的行权价。
`results[].ticker`	string	该期权合约的代码。
`results[].underlying_ticker`	string	该期权合约对应的底层标的代码。
`status`	string	本次请求响应的状态。

响应示例

{
  "request_id": "603902c0-a5a5-406f-bd08-f030f92418fa",
  "results": [
    {
      "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"
    },
    {
      "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": 90,
      "ticker": "O:AAPL211119C00090000",
      "underlying_ticker": "AAPL"
    }
  ],
  "status": "OK"
}

原文：Massive 文档 ↗

期权 全部合约 · REST 接口

适用场景

查询参数

响应字段

响应示例

期权全部合约 · REST 接口