---
title: "Get Flip Surface"
method: GET
path: "/api/gex/flip-surface"
tags: ["GEX"]
---

# Get Flip Surface

`GET /api/gex/flip-surface`

## 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/flip-surface`
- Auth: HTTP bearer

Multi-horizon spot-shift dealer-gamma surface (PROTOTYPE).

Returns the dealer-gamma profile per horizon on a shared price grid,
plus the resolved flip per horizon and a single wall overlay.  See
docs/gex_flip_surface_contract.md for the full contract.

## Query parameters

- `symbol` string: Underlying symbol
- `horizons` string: Comma-separated list of multi-day reference horizons in days. Bounds: [0.25, 365], at most 12 entries.
- `span_pct` number: Half-width of the rendered price grid, as a fraction of spot.
- `step_pct` number: Grid step, as a fraction of spot.
- `include_walls` boolean: Include the canonical Call/Put walls overlay.

## Response `200`

Successful Response

- FlipSurfaceResponse
  - `symbol` string, required
  - `spot` number, required
  - `timestamp` string, date-time, required
  - `grid` number[], required
  - `horizons_days` number[], required
  - `profiles` array[], required
    - number[]
  - `flips` FlipSurfacePoint[], required
    - `horizon_days` number, required
    - `flip` number, nullable
    - `resolved` boolean, required
    - `span_used` number, required
    - `net_gex_at_spot` number, nullable
  - `walls` FlipSurfaceWall[], required
    - `strike` number, required
    - `type` string, required
    - `abs_dollar_gex` number, 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)