How do I fetch SPY gamma exposure from the API?

Call /api/v1/gex with symbol=SPY and your api_key query parameter. The response includes total gamma exposure and per-strike values.

Can I use this endpoint with an AI agent like OpenClaw?

Yes. Register the GEX endpoint as a tool, pass a symbol, and return structured JSON for downstream reasoning and trade-planning workflows.

What else should I pair with GEX for decision-making?

Use key-levels and gamma-profile endpoints to track call wall, put wall, hedge wall, and the zero-gamma regime context.

API Use Case

SPY Gamma Exposure API

Pull real-time SPY gamma exposure data for trading dashboards, alerting, and agent workflows. This page targets the exact implementation path from request to signal.

Endpoint:

GET https://thetavantage.com/api/v1/gex?symbol=SPY&api_key=tvk_YOUR_KEY

What You Get

The response includes current SPY price, total gamma exposure, call-side vs put-side breakdown, and strike-level gamma values for plotting walls and concentration zones.

Example Request

curl "https://thetavantage.com/api/v1/gex?symbol=SPY&api_key=tvk_YOUR_KEY"

Example Response (Truncated)

{
  "symbol": "SPY",
  "current_price": 598.23,
  "total_gamma_exposure": 152345678.12,
  "call_gamma_exposure": 221004411.77,
  "put_gamma_exposure": -68658733.65,
  "strikes": [
    {
      "strike": 600,
      "gamma_exposure": 28455210.03,
      "call_gamma": 39821122.14,
      "put_gamma": -11365912.11
    }
  ]
}

OpenClaw Tool Example

@tool("get_spy_gex")
def get_spy_gex() -> dict:
    resp = requests.get(
        "https://thetavantage.com/api/v1/gex",
        params={"symbol": "SPY", "api_key": os.environ["TV_API_KEY"]},
        timeout=15,
    )
    resp.raise_for_status()
    return resp.json()

Next Endpoints to Pair

/api/v1/key-levels for call wall, put wall, hedge wall, and expected move.
/api/v1/gamma-profile for zero-gamma level and regime interpretation.
/api/v1/report for AI-generated daily narrative and scenarios.

View Full API Reference See API Access Plans