期权链 API：一次 POST 获取完整期权链

今天我们推出 期权链 API——继实时 WebSocket 数据流与历史 SQL 接口之后，OptionData 家族的第三位成员。一次 POST、一个标的，你就能拿回整条期权链：每个行权价与到期日、完整定价，并附带未平仓量、隐含波动率与希腊字母。无需维持长连接，也无需编写 SQL。

你会得到什么

发送一个标的，返回一个干净的合约 JSON 数组。每个合约都带有你真正用于交易的字段：

每个合约、每个字段

• 定价: bid · ask · mark · close

• 持仓: open interest · OI 变化 · volume

• 风险 / 曲面: IV · delta · gamma · theta · vega

这与驱动我们实时与历史 API 的是同一份 OPRA 授权数据——只是被整理成整条期权链的某一时点快照，而非逐笔成交的数据流。

何时使用它

OptionData 现在提供了访问同一份数据的三种方式。按任务挑选合适的形态：

• 实时 · WebSocket — 逐笔成交的实时盘口。最适合资金流监测与告警。
• 历史 · SQL — 对完整成交历史的自定义分析查询。最适合回测与研究。
• 期权链 · REST — 整条期权链（行权价 × 到期日）的干净快照。最适合构建期权链视图、为价差定价、跨行权价筛选，或获取收盘时的 IV / 希腊字母曲面——无需编写 SQL，也无需保持连接。

用在哪里： 以下攻略现已用到它——看涨与看跌墙、伽马挤压 与 T+1 未平仓量确认。

快速开始

获取你的 API 密钥

登录、开启免费试用，并从仪表盘复制你的 API 密钥。同一个密钥在三套 API 中通用。

POST 一个标的

发送一个包含密钥与标的的 JSON 请求体，其余参数均为可选。

curl -X POST https://www.optiondata.io/api/option-chain \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_API_KEY",
    "symbol": "AAPL",
    "expiration_date": "2026-07-17"
  }'

读取期权链

你会得到一个完整定价的合约 data 数组。直接渲染、排序，或喂给你的定价模型。

请求

向 https://www.optiondata.io/api/option-chain 发起一次 POST，请求体为 JSON：

• api_key （必填） — 你的 OptionData API 密钥。
• symbol （必填） — 标的，例如 AAPL。
• date （可选） — 交易日，格式 YYYY-MM-DD。默认取最新可用交易日。
• expiration_date （可选） — 将期权链收窄到单个到期日。
• put_call （可选） — CALL 或 PUT，只返回其中一侧。

整个参数面就这么小。我们刻意保持精简——没有行权价区间、没有到期天数范围、没有资金流开关——让请求一目了然，响应就是你所请求的完整期权链。

响应

{
  "status": "SUCCESS",
  "data": [
    {
      "option_symbol": "AAPL260717C00185000",
      "put_call": "CALL",
      "strike": 185,
      "expiration_date": "2026-07-17",
      "bid": 6.55,
      "ask": 6.70,
      "mark": 6.63,
      "close": 6.41,
      "open_interest": 12840,
      "open_interest_change": 310,
      "volume": 4215,
      "implied_volatility": 0.2413,
      "delta": 0.58,
      "gamma": 0.021,
      "theta": -0.18,
      "vega": 0.12
    }
  ],
  "meta": { "row_limit": 10000, "truncated": false }
}

• data — 每个合约一个对象，覆盖匹配请求的所有行权价与到期日。
• meta.row_limit — 单次响应返回的最大行数。
• meta.truncated — 若期权链触达该上限则为 true；此时可用 expiration_date 或 put_call 收窄范围。

用你的语言

同样的调用，Python 版本：

import requests

response = requests.post(
    "https://www.optiondata.io/api/option-chain",
    json={
        "api_key": "YOUR_API_KEY",
        "symbol": "AAPL",
        "expiration_date": "2026-07-17",
        "put_call": "CALL",
    },
)

chain = response.json()["data"]
print(len(chain), "contracts")

最新交易日，或任意历史交易日

不传 date 即返回最新交易日。传入过去某个 YYYY-MM-DD，则返回那一天的期权链原貌——非常适合收盘定价、时点 IV 曲面，或还原某事件发生前价差的样子。

一个密钥，三套 API

期权链 API 已与实时 WebSocket 数据流、历史 SQL 访问一同包含在 Pro 套餐中。一个 API 密钥即可认证全部三套。

Beta

期权链 API 目前为 v1 / Beta。上述核心字段是稳定的；我们可能随时间新增字段，因此请按字段名而非位置读取。

一份数据，三种入口

实时数据流告诉你此刻在成交什么；历史 SQL 让你向过去提出深度问题；期权链 API 则让你一眼看到整张盘面。三者合在一起，覆盖实时监测、研究与按需定价——同一份授权数据源，同一个 API 密钥。

想试试吗？前往 期权链 API 页面，在实时演练台中运行一个标的，并开启免费试用。

用 OptionData API 实测。 开启 14 天免费试用（无需信用卡）——一个 API 密钥即可使用实时 WebSocket、历史 SQL 与期权链 REST 三套 API。