# GET /api/mcp/data/batch/gex

> Where are the gamma flip, call wall and put wall for several indexes at once?

Returns the gamma exposure payload of the single endpoint for each symbol in tickers, keyed by symbol under results: total GEX, the flip level, the call and put walls, the implications block and the strike profile windowed to ten strikes each side of spot unless strikes_around says otherwise. A symbol the feed cannot answer lands in errors and never fails the others. One rate-limit unit per call; the monthly allowance is spent per symbol. The morning regime read across SPY, QQQ and IWM is one request instead of three.

- **Family:** Gamma exposure (https://apexvol.com/developers/gamma-exposure-api)
- **Plan:** Premium and above. Every call needs `Authorization: Bearer avmcp_<token>`; tokens are issued to paid and trial accounts under Account, then API Access.
- **Units:** GEX in dollars of gamma per 1 percent move; strikes and levels in the underlying's price.
- **Basis:** Per symbol, identical to /gex/{ticker}: the vendor's per-strike gamma times open interest, calls positive and puts negative, aggregated across expirations unless expiration is given.
- **MCP tools:** `get_gex`
- **Background:** https://apexvol.com/learn/gamma-exposure-explained

## Parameters

| Name | In | Default | Range | Meaning |
|---|---|---|---|---|
| `tickers` (required) | query |  | 1 to 25 symbols, comma-separated | The underlyings, upper case, duplicates dropped. A symbol with no listed options answers 404 for the whole call and names the symbol. |
| `expiration` | query |  | YYYY-MM-DD | One expiration instead of the aggregate, applied to every symbol. |
| `aggregate` | query | true | true or false | Aggregate across expirations. |
| `strikes_around` | query | 10 | 0 to 500 | Strikes kept each side of spot in the profile lists under compact detail. 0 keeps every strike. |
| `detail` | query | compact for MCP clients, full for REST | compact or full | full returns every strike for every symbol. |

## Request

```bash
curl -H "Authorization: Bearer avmcp_YOUR_TOKEN" \
     "https://apexvol.com/api/mcp/data/batch/gex?tickers=SPY,QQQ,IWM"
```

## Response (captured 2026-09-08)

Real response, lists cut to the rows nearest the money. The envelope is `{"success": true, "data": ...}`.

```json
{
  "success": true,
  "data": {
    "errors": {},
    "failed": 0,
    "note": "One rate-limit unit for the whole call; the monthly allowance is spent per symbol, exactly as if each were called alone.",
    "requested": 3,
    "results": {
      "IWM": {
        "by_expiration": [
          {
            "call_gex": 194570432.9169,
            "expiration": "2026-09-08",
            "flip_level": null,
            "max_gamma_strike": 297,
            "min_gamma_strike": 294,
            "put_gex": -314182169.4409,
            "stock_price": 294.93,
            "total_gex": -119611736.5241
          },
          {
            "call_gex": 79968880.5358,
            "expiration": "2026-09-09",
            "flip_level": null,
            "max_gamma_strike": 299,
            "min_gamma_strike": 290,
            "put_gex": -93802211.7899,
            "stock_price": 294.93,
            "total_gex": -13833331.2541
          },
          {
            "call_gex": 51676336.3829,
            "expiration": "2026-09-10",
            "flip_level": 301.4673,
            "max_gamma_strike": 302.0,
            "min_gamma_strike": 294.0,
            "put_gex": -40047226.9667,
            "stock_price": 294.93,
            "total_gex": 11629109.4162
          }
        ],
        "call_gex": 1991848779.967,
        "expirations_horizon_days": 90,
        "expirations_included": 15,
        "expirations_selected": [
          "2026-09-08",
          "2026-09-09",
          "2026-09-10"
        ],
        "expirations_through": "2026-11-20",
        "expirations_total": 32,
        "flip_degenerate": false,
        "flip_level": null,
        "gamma_flip": null,
        "gex_by_strike": [
          {
            "gex": -166405035.4131,
            "oi": 33821,
            "strike": 294
          },
          {
            "gex": -154744835.7884,
            "oi": 146505,
            "strike": 295
          },
          {
            "gex": 44989557.5864,
            "oi": 30511,
            "strike": 296
          }
        ],
        "gex_profile": [
          {
            "call_gex": 75108974.55202408,
            "net_gex": -166405035.41307533,
            "put_gex": -241514009.9650994,
            "strike": 294
          },
          {
            "call_gex": 287165563.55992734,
            "net_gex": -154744835.78841805,
            "put_gex": -441910399.3483454,
            "strike": 295
          },
          {
            "call_gex": 114600260.44456725,
            "net_gex": 44989557.58635123,
            "put_gex": -69610702.85821602,
            "strike": 296
          }
        ],
        "gex_ratio": 0.4101,
        "implications": {
          "directional_bias": "Put-heavy (call/put GEX 0.41)",
          "net_to_gross": -0.4183,
          "pin_at_spot": false,
          "positioning": "largest strike $290.00 (-1.7%); call wall $295.00 (+0.0%); put wall $290.00 (-1.7%)",
          "regime_code": "negative",
          "support_resistance": "--",
          "volatility_regime": "Negative GEX (dealers amplify moves)"
        },
        "key_levels": {
          "call_wall": 295.0,
          "call_wall_unconstrained": false,
          "call_wall_value": 287165563.5599,
          "flip_degenerate": false,
          "flip_level": null,
          "key_strike": 290.0,
          "key_strike_net": 636588202.6787,
          "max_pain": null,
          "put_wall": 290.0,
          "put_wall_unconstrained": false,
          "put_wall_value": 756139680.1716,
          "spot": 294.93
        },
        "max_gex_strike": 290,
        "put_gex": -4857032318.9163,
        "stock_price": 294.93,
        "ticker": "IWM",
        "total_gex": -2865183538.9493,
        "total_gex_billions": -2.8652,
        "window": {
          "detail": "full",
          "lists": {},
          "strikes_around": 0
        }
      },
      "QQQ": {
        "by_expiration": [
          {
            "call_gex": 2142262257.0523,
            "expiration": "2026-09-08",
            "flip_level": 724.0413,
            "max_gamma_strike": 722,
            "min_gamma_strike": 714,
            "put_gex": -1794824093.0343,
            "stock_price": 719.11,
            "total_gex": 347438164.0181
          },
          {
            "call_gex": 689389017.1428,
            "expiration": "2026-09-09",
            "flip_level": 725.2466,
            "max_gamma_strike": 722,
            "min_gamma_strike": 714,
            "put_gex": -519642458.0994,
            "stock_price": 719.11,
            "total_gex": 169746559.0433
          },
          {
            "call_gex": 336787261.3424,
            "expiration": "2026-09-10",
            "flip_level": 721.093,
            "max_gamma_strike": 725,
            "min_gamma_strike": 711,
            "put_gex": -202534668.4275,
            "stock_price": 719.11,
            "total_gex": 134252592.9149
          }
        ],
        "call_gex": 9648060927.0027,
        "expirations_horizon_days": 90,
        "expirations_included": 16,
        "expirations_selected": [
          "2026-09-08",
          "2026-09-09",
          "2026-09-10"
        ],
        "expirations_through": "2026-11-20",
        "expirations_total": 33,
        "flip_degenerate": false,
        "flip_level": 759.7918,
        "gamma_flip": 759.7918,
        "gex_by_strike": [
          {
            "gex": -0.0,
            "oi": 1218,
            "strike": 290
          },
          {
            "gex": -0.0,
            "oi": 1247,
            "strike": 295
          },
          {
            "gex": -0.0059,
            "oi": 5458,
            "strike": 300
          }
        ],
        "gex_profile": [
          {
            "call_gex": 2.6388805175953828e-09,
            "net_gex": -1.9560701836675777e-07,
            "put_gex": -1.9824589888435315e-07,
            "strike": 290
          },
          {
            "call_gex": 6.774953948619314e-09,
            "net_gex": -2.1478435085757986e-07,
            "put_gex": -2.2155930480619918e-07,
            "strike": 295
          },
          {
            "call_gex": 5.8615478295618864e-05,
            "net_gex": -0.005904420870384122,
            "put_gex": -0.005963036348679741,
            "strike": 300
          }
        ],
        "gex_ratio": 1.0418,
        "implications": {
          "directional_bias": "Balanced (call/put GEX 1.04)",
          "net_to_gross": 0.0205,
          "pin_at_spot": false,
          "positioning": "largest strike $700.00 (-2.7%); call wall $720.00 (+0.1%); put wall $700.00 (-2.7%); flip $759.79 (+5.7%)",
          "regime_code": "balanced",
          "support_resistance": "Flip at $759.79 (5.7% above spot): hedging amplifies moves below it, dampens above",
          "volatility_regime": "Balanced GEX (net 2.0% of gross, no dominant side)"
        },
        "key_levels": {
          "call_wall": 720.0,
          "call_wall_unconstrained": false,
          "call_wall_value": 986731585.5279,
          "flip_degenerate": false,
          "flip_level": 759.7918,
          "key_strike": 700.0,
          "key_strike_net": 710253911.9649,
          "max_pain": null,
          "put_wall": 700.0,
          "put_wall_unconstrained": false,
          "put_wall_value": 935281868.3011,
          "spot": 719.11
        },
        "max_gex_strike": 700,
        "put_gex": -9261153393.2054,
        "stock_price": 719.11,
        "ticker": "QQQ",
        "total_gex": 386907533.7973,
        "total_gex_billions": 0.3869,
        "window": {
          "detail": "full",
          "lists": {},
          "strikes_around": 0
        }
      },
      "SPY": {
        "by_expiration": [
          {
            "call_gex": 2476891013.9783,
            "expiration": "2026-09-08",
            "flip_level": 759.0,
            "max_gamma_strike": 773,
            "min_gamma_strike": 768,
            "put_gex": -3266496539.5316,
            "stock_price": 768.39,
            "total_gex": -789605525.5533
          },
          {
            "call_gex": 1038157463.9151,
            "expiration": "2026-09-09",
            "flip_level": null,
            "max_gamma_strike": 773,
            "min_gamma_strike": 769,
            "put_gex": -1178637074.864,
            "stock_price": 768.39,
            "total_gex": -140479610.9489
          },
          {
            "call_gex": 689747750.2082,
            "expiration": "2026-09-10",
            "flip_level": 771.7899,
            "max_gamma_strike": 770,
            "min_gamma_strike": 768,
            "put_gex": -497495552.7004,
            "stock_price": 768.39,
            "total_gex": 192252197.5078
          }
        ],
        "call_gex": 14807169751.726,
        "expirations_horizon_days": 90,
        "expirations_included": 16,
        "expirations_selected": [
          "2026-09-08",
          "2026-09-09",
          "2026-09-10"
        ],
        "expirations_through": "2026-11-20",
        "expirations_total": 34,
        "flip_degenerate": false,
        "flip_level": null,
        "gamma_flip": null,
        "gex_by_strike": [
          {
            "gex": -65.7071,
            "oi": 36665,
            "strike": 300
          },
          {
            "gex": -16.397,
            "oi": 10411,
            "strike": 305
          },
          {
            "gex": -0.9852,
            "oi": 19659,
            "strike": 310
          }
        ],
        "gex_profile": [
          {
            "call_gex": 1.5405511102348097,
            "net_gex": -65.70709879607838,
            "put_gex": -67.2476499063132,
            "strike": 300
          },
          {
            "call_gex": 2.9930291273567513e-07,
            "net_gex": -16.397040589271285,
            "put_gex": -16.397040888574196,
            "strike": 305
          },
          {
            "call_gex": 1.888430482493683e-07,
            "net_gex": -0.9852460785906124,
            "put_gex": -0.9852462674336606,
            "strike": 310
          }
        ],
        "gex_ratio": 0.742,
        "implications": {
          "directional_bias": "Balanced (call/put GEX 0.74)",
          "net_to_gross": -0.1481,
          "pin_at_spot": false,
          "positioning": "largest strike $760.00 (-1.1%); call wall $770.00 (+0.2%); put wall $760.00 (-1.1%)",
          "regime_code": "negative",
          "support_resistance": "--",
          "volatility_regime": "Negative GEX (dealers amplify moves)"
        },
        "key_levels": {
          "call_wall": 770.0,
          "call_wall_unconstrained": false,
          "call_wall_value": 1664476542.9575,
          "flip_degenerate": false,
          "flip_level": null,
          "key_strike": 760.0,
          "key_strike_net": 2139119152.7301,
          "max_pain": null,
          "put_wall": 760.0,
          "put_wall_unconstrained": false,
          "put_wall_value": 2603902619.2914,
          "spot": 768.39
        },
        "max_gex_strike": 760,
        "put_gex": -19956183040.1022,
        "stock_price": 768.39,
        "ticker": "SPY",
        "total_gex": -5149013288.3761,
        "total_gex_billions": -5.149,
        "window": {
          "detail": "full",
          "lists": {},
          "strikes_around": 0
        }
      }
    },
    "succeeded": 3,
    "tickers": [
      "SPY",
      "QQQ",
      "IWM"
    ]
  }
}
```

## Fields

- `tickers, requested, succeeded, failed`: The symbols asked for and how many answered.
- `results.{SYMBOL}.total_gex, flip_level`: Net dealer gamma and the price where it changes sign.
- `results.{SYMBOL}.key_levels`: call_wall, put_wall, key_strike and max_pain.
- `results.{SYMBOL}.gex_by_strike[]`: The per-strike profile inside the window.
- `results.{SYMBOL}.window`: What the window kept and whether it truncated.
- `errors.{SYMBOL}`: Why a symbol is missing from results.

## Errors

- `401`: no or revoked token
- `429`: Retry-After seconds
- `403`: Premium plan required
- `424`: no symbol in the batch returned data
- `404`: a symbol with no listed options; the whole call fails and the body names it
- Full list: https://apexvol.com/developers/errors

## Ask it in an MCP client

- Give me the gamma flip and walls for SPY, QQQ and IWM in one go.
- Which of the big indexes is in negative gamma this morning?
- Compare dealer positioning across SPY, QQQ, IWM and DIA.

Conventions for units, bases and timestamps: https://apexvol.com/developers/conventions
