---
title: "Retrieve Market Tide"
method: GET
path: "/api/market/market-tide"
---

# Retrieve Market Tide

`GET /api/market/market-tide`

## Request

- Base URL: `https://api.unusualwhales.com`
- URL: `https://api.unusualwhales.com/api/market/market-tide`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/the-unnatural-group--llc/apis/tradesignals-api/docs/api/market/market-tide/get.ts> (a function with typed inputs; its response is checked against the schema)

Provides real-time data based on a proprietary formula examining market-wide options activity while filtering out noise.

## Query parameters

- `date` string, date
- `interval_5m` boolean
- `otm_only` boolean

## Response `200`

Successful response with market tide data.

- MarketTideResponse
  - `data` MarketTideEntry[]
    - `date` string, date: The trading date.
    - `net_call_premium` string: Defined as (call premium ask side) - (call premium bid side).
    - `net_put_premium` string: Defined as (put premium ask side) - (put premium bid side).
    - `net_volume` integer: Defined as (call volume ask side) - (call volume bid side) - ((put volume ask side) - (put volume bid side)).
    - `timestamp` string, date-time: The start time of the tick as a timestamp with timezone.

## Other responses

- `422`: Unprocessable Entity
- `500`: Internal Server Error

---

[API](https://skmtc.dev/the-unnatural-group--llc/apis/tradesignals-api.md) - [All operations](https://skmtc.dev/the-unnatural-group--llc/apis/tradesignals-api/llms.txt) - [OpenAPI document](https://skmtc.dev/the-unnatural-group--llc/apis/tradesignals-api/revisions/0b37cadfb125?raw)