---
title: "Get Market Tide History"
method: GET
path: "/api/flow/market-tide/history"
tags: ["Options Flow"]
---

# Get Market Tide History

`GET /api/flow/market-tide/history`

## 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/flow/market-tide/history`
- Auth: HTTP bearer

Persisted Market Tide series for the trend chart.

A pure cache read over the snapshot table: ``intraday`` returns the most
recent session's 5-minute series (frozen at the 16:00 ET close after
hours), ``daily`` returns the last ``days`` session closes. Empty until
the refresher/backfill has written snapshots.

## Query parameters

- `window` 5 | 15 | 30 | 60: Supported Market Tide lookbacks, parsed from HTTP query strings.
- `mode` 'intraday' | 'daily': 'intraday' = the most recent session's 5-minute series; 'daily' = one close per session.
- `days` integer: Trailing sessions to return in daily mode (ignored for intraday).

## Response `200`

Successful Response

- MarketTideHistoryResponse: Market Tide over time for a window — intraday (today's 5-min series) or daily (one close per session).
  - `window_minutes` integer, required
  - `mode` string, required
  - `points` MarketTideHistoryPoint[], required
    - `timestamp` string, date-time, required
    - `session_date` string, date, required
    - `score` number, nullable
    - `label` string, required
    - `participation_pct` number, required
    - `flow_direction` number, nullable
    - `gamma_regime` number, nullable

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