---
title: "Get Gamma Weather"
method: GET
path: "/api/gex/weather"
tags: ["GEX"]
---

# Get Gamma Weather

`GET /api/gex/weather`

## Request

- Base URL: `https://api.zerogex.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.zerogex.io/api/gex/weather`
- Auth: HTTP bearer

The combined current-state read: Gamma Weather.

Consolidates what is already on the Hedging Flow page into one sentence:
whether estimated hedging pressure is persistently buying or selling,
whether near-price dealer gamma is building or thinning, which side the
book leans, and how much room is left before the gamma regime itself
changes.

Two precedence rules, both of which the spec left open:

* the **cushion is a modifier, not a state**. "Thin and closing" answers a
  different question from "stable bid", so they compose rather than
  compete;
* **stability decides the state, lean colors it.** They disagree often and
  the panel exists to say whether a condition can persist, which is what
  stability speaks to.

Nothing is stored. The state is derived on read from components that are,
so retuning a threshold reclassifies the whole archive rather than leaving
old sessions labelled by a rule that is no longer live.

Reads the two materialised series and classifies their latest COMMON bar,
so the pressure and the structure in one sentence always describe the same
five minutes. Returns 404 for an unknown symbol, and 409 when neither
series has a bar yet for the resolved session.

## Query parameters

- `symbol` string, required
- `session` 'current' | 'prior'
- `date` string, nullable: An explicit ET trading day, YYYY-MM-DD. Overrides `session`, and is passed straight through to the two series this reads, so a dated weather read classifies that session's last common bar. 409 when neither series has a bar for the day.

## Response `200`

Successful Response

- GammaWeatherResponse: One combined current-state read from the pieces already on the page. A market-health classification. Not a directional signal, an entry or exit, or a recommendation, and it inherits the estimated-not-observed caveat from the hedging flow it reads. ``components`` is returned alongside the verdict deliberately: a panel that shows only a conclusion cannot be checked against the charts sitting directly underneath it.
  - `symbol` string, required
  - `session` string, required
  - `bar_start` string, nullable
  - `state` string, required
  - `label` string, required
  - `sentence` string, required
  - `pressure` string, required
  - `structure` string, required
  - `gamma_trend` string, required
  - `lean_side` string, nullable
  - `cushion` string, required
  - `persistence` string
  - `pressure_reversing_bars` integer
  - `age_bars` integer
  - `age_minutes` number, nullable
  - `age` string, nullable
  - `persistence_label` string
  - `age_label` string, nullable
  - `pending_state` string, nullable
  - `pending_label` string, nullable
  - `pending_bars` integer
  - `lights` object, nullable
  - `confirm_bars` integer
  - `cushion_summary` string, nullable
  - `components` object
  - `basis` string, required
  - `disclosure` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/zerogex/apis/zerogex-api.md) · [All operations](https://skmtc.dev/zerogex/apis/zerogex-api/llms.txt) · [OpenAPI document](https://skmtc.dev/zerogex/apis/zerogex-api/revisions/753b26bf0592?raw)