市场结构 API：一次 GET 获取完整链 GEX

今天我们推出 市场结构 API（Market Structure），继实时 WebSocket、历史 SQL 与期权链 REST 之后，OptionData 家族的第四位成员。一次 GET、一个标的，你就能拿到预计算的完整期权链持仓结构快照：交易商风格的 Gamma Exposure（GEX）、未平仓墙、Gamma Flip、Max Pain、波动率背景、盘中资金流，以及可选的约五分钟盘中 GEX 汇总。

无需 SQL，无需维持长连接，也无需自己拼装行权价。

你会得到什么

请求一个期权根（例如 SPY 或 AAPL），返回自包含的 JSON：

一份快照，四层信息

• 结构: 看涨/看跌 GEX · 墙位 · Gamma Flip · Max Pain · 行权价 × 到期日

• 盘中 GEX: 完整链 call_gex / put_gex · spot · 盘中约 5 分钟刷新

• 资金流: 看涨/看跌权利金 · 多空 DEX · 成交笔数

• 标的元数据: 价格 · IV30 · IV rank/percentile · 偏斜 · 期限斜率 · 板块

与其他 API 同源：OPRA 授权美股期权数据，形态面向持仓/结构看板，而不是逐笔成交流或可筛选的合约列表。

何时使用它

OptionData 现在提供访问同一份数据的四种方式，按任务选型：

用在哪里： 突破与墙位验证、伽马挤压结构，以及“零伽马在哪”的交易台视图——无需每次从原始链重算敞口。

快速开始

获取 API 密钥

登录并开启 Pro 免费试用，从控制台复制 API 密钥。同一密钥适用于实时、历史 SQL、期权链与市场结构。

GET 一个标的

使用 Bearer 鉴权，将期权根放在路径中。

curl "https://www.optiondata.io/api/v1/market-structure/SPY" \
  -H "Authorization: Bearer YOUR_API_KEY"

可选历史快照：

curl "https://www.optiondata.io/api/v1/market-structure/SPY?date=2026-07-24" \
  -H "Authorization: Bearer YOUR_API_KEY"

读取结构与关键位

用 data.structure 看 GEX 与墙位，用 data.symbol_meta 看 IV 背景，用 data.flow 看盘中权利金，用 data.intraday_gex 读取五分钟汇总（若存在）。

请求

GET https://www.optiondata.io/api/v1/market-structure/:symbol

包含在 Pro 套餐中（trialing 或 active）。速率限制与其他 HTTP 数据 API 一致（约每密钥每 60 秒 60 次；超出 429 并带 Retry-After）。

响应形态（v1）

顶层结构：

{
  "data": {
    "symbol": "SPY",
    "symbol_meta": { },
    "flow": { },
    "intraday_gex": { "spot": 0, "call_gex": 0, "put_gex": 0 },
    "structure": {
      "spot": 0,
      "call_oi": 0,
      "put_oi": 0,
      "call_gex": 0,
      "put_gex": 0,
      "scopes": { "all": { }, "zero_dte": { }, "weekly": { }, "monthly": { } },
      "max_pain_curve": [ ],
      "expirations": [ ]
    }
  },
  "meta": {
    "effective_date": "2026-07-24",
    "structure_as_of": "2026-07-24T20:15:00.000Z",
    "flow_as_of": "2026-07-24T20:15:00.000Z",
    "intraday_gex_as_of": "2026-07-24T20:15:00.000Z"
  }
}

要点

• structure.call_gex / put_gex — 完整链上 1% 波动对应的美元 GEX。看跌 GEX 在文档约定的交易商空 put 符号下为负号。净 GEX ≈ call_gex + put_gex。
• scopes — all / zero_dte / weekly / monthly 关键的关键位（Gamma Flip、Max Pain、GEX 墙、OI 墙）。
• expirations[] — 按到期日分组的行权价 call/put OI 与 GEX（热力图的“棋盘”）。
• intraday_gex — 轻量完整链 GEX + spot；常规交易时段约每五分钟可刷新（有数据时）。
• meta.structure_as_of — 结构墙位 / flip / max pain / 行权价 GEX 最近构建时间（不会随每次 flow 刷新跳动）。

模型，不是库存

交易商持仓是模型，不是上报的做市商库存。墙位与 flip 是决策辅助，不是账本真相。

Python 示例

import requests

r = requests.get(
    "https://www.optiondata.io/api/v1/market-structure/SPY",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    timeout=30,
)
r.raise_for_status()
body = r.json()
structure = body["data"]["structure"]
meta = body["meta"]

print(body["data"]["symbol"], "spot", structure["spot"])
print("net GEX (model)", structure["call_gex"] + structure["put_gex"])
print("structure as of", meta["structure_as_of"])
print("expirations", len(structure["expirations"]))

市场结构 vs 期权链

两者一起用： 结构当地图，期权链当地图上的单点合约。

覆盖与新鲜度

• 快照历史随美股交易日增长（约自 2026-02-20 起）。
• 结构字段在结构构建时更新；flow 与 intraday_gex 在盘中可能更频繁。
• 需要追溯至 2025-02-18 的逐笔成交，用历史 SQL（延迟 ≥15 分钟）。实时成交用 WebSocket。

一个密钥，四个 API

包含在 Pro 中

市场结构与实时 WebSocket、历史 SQL、期权链同属 Pro 套餐。一个 API 密钥鉴权全部四个产品。14 天免费试用，开通无需信用卡。

一份数据，四种入口

实时流告诉你现在在成交什么。历史 SQL 回答关于过去的深问题。期权链给出合约棋盘。市场结构给出棋盘上的持仓地图——GEX、墙位与 flip——无需从零重算。

准备试用？打开市场结构页面，在测试台跑一个标的，并开始免费试用。

用 OptionData API 运行。 开启 14 天免费试用（无需信用卡）。一个密钥覆盖实时 WebSocket、历史 SQL、期权链 REST 与市场结构。