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

# Get Surface

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

Forced Flow Surface: spot x time-of-day -> net dealer stock demand.

## Query parameters

- `symbol` string
- `expiry` string, nullable
- `spot_range_pct` number
- `time_steps` integer

## Response `200`

Successful Response

- SurfaceResponse
  - `symbol` string, required
  - `spot` number, required
  - `timestamp` string, date-time, required
  - `spots` number[], required
  - `times_days` number[], required
  - `z` array[], required
    - number[]

## 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)