---
title: "Get Session Surface"
method: GET
path: "/api/forced-flow/session-surface"
tags: ["Forced Flow"]
---

# Get Session Surface

`GET /api/forced-flow/session-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/forced-flow/session-surface`
- Auth: HTTP bearer

Full-session forced-flow field: the ACTUAL historical field recomputed from
stored ``option_chains`` (RTH open -> now) plus a projection of the current
book (now -> close).

Columns march left (open) to right (close); ``now_index`` marks the boundary
between recorded history and projection. History is rebuilt from
``option_chains`` because the persisted ``forced_flow_profile.profile`` JSONB
is written empty -- so the past field cannot be read back, only recomputed.

## Query parameters

- `symbol` string
- `spot_range_pct` number
- `past_steps` integer: Actual-history columns
- `future_steps` integer: Projection columns to close
- `expiry` string, nullable

## Response `200`

Successful Response

- SessionSurfaceResponse
  - `symbol` string, required
  - `spot` number, required
  - `timestamp` string, date-time, required
  - `session_open_min_to_close` number, required
  - `now_min_to_close` number, required
  - `prices` number[], required
  - `z` array[], required
    - number[]
  - `columns` SessionColumnOut[], required
    - `min_to_close` number, required
    - `spot` number, required
    - `magnet` number, nullable
    - `pivot` number, nullable
    - `is_past` boolean, required
  - `now_index` integer, required
  - `price_bars` SessionPriceBar[]
    - `min_to_close` number, required
    - `open` number, required
    - `high` number, required
    - `low` number, required
    - `close` 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)