Dealer GEX API

​

概览

API Key 在账户页自助生成(见快速开始);鉴权方式为 Authorization: Bearer sk_live_...,配额包含于订阅。

​

Snapshot 响应字段

{
  "data": {
    "ticker": "SPY",
    "snapshot_at": "2026-07-08T14:30:01-04:00",
    "session_date_et": "2026-07-08",
    "state": "fresh",
    "spot_usd": 598.42,
    "strikes": [
      {
        "strike_usd": 600.0,
        "net_gex_usd": -1234567.0,
        "call_gex_usd": 2345678.0,
        "put_gex_usd": -3580245.0,
        "node_type": null
      }
    ],
    "summary": { "...": "结构摘要,字段见下文" }
  }
}

• spot_usd:该轮快照发布时刻的结构上下文价格样本;缺数据时为 null(不会伪装成 0)。
• net_gex_usd 为正 = 做市商净多 gamma,该行权价倾向钉住/支撑;为负 = 净空 gamma,倾向助推/加速。与产品内 Dealer 视角的金/紫配色语义一致。
• summary 为结构摘要:total_gex_usd、king_strike_usd / king_value_usd、gatekeeper_strike_usd / gatekeeper_value_usd、gamma_flip_usd、call_wall_strike_usd / call_wall_value_usd、put_wall_strike_usd / put_wall_value_usd、major_positive_strike_usd / major_positive_value_usd、major_negative_strike_usd / major_negative_value_usd、positive_gex_count、negative_gex_count。各节点概念的解读见关键节点与与传统 GEX 的区别。

​

state 值集

​

History 参数

• 查询窗口为最近 90 个 ET 自然日(窗口下界按 ET 午夜计)。date-only 写法(YYYY-MM-DD)按 ET 日历日理解:写边界 ET 日会被钳制到窗口起点正常返回,写更早的日返回 404 RANGE_TOO_DEEP;显式带时区的时间戳按精确时刻严格比较,早于窗口下界即返回 404 RANGE_TOO_DEEP。
• 每条 history item 的字段集与 snapshot 完全相同。
• 未知参数、非法日期、非法 cursor 均返回 400 且不消耗配额;401/402/403/429 同为零消耗。