---
title: "Flow Tape"
method: GET
path: "/v1/options-flow/tape"
tags: ["options-flow"]
---

# Flow Tape

`GET /v1/options-flow/tape`

## Request

- Base URL: `https://api.optionwhales.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.optionwhales.io/v1/options-flow/tape`
- Auth: none declared

Filtered, cursor-paginated recorded-order tape, newest first.

Historical sessions require a ``ticker`` or ``occ`` filter — the session index
is sorted by ticker, so an unfiltered historical read is a bulk export.

## Query parameters

- `session` string, nullable: Session YYYY-MM-DD; default live
- `ticker` string[], nullable: Underlying(s); required for historical
- `occ` string[], nullable: OCC contract symbol(s)
- `type` string, nullable: call | put
- `direction` string, nullable: buy | sell
- `order_type` string, nullable
- `min_contracts` integer
- `min_premium` number
- `min_confidence` number, nullable
- `dte_min` integer, nullable
- `dte_max` integer, nullable
- `strike_min` number, nullable
- `strike_max` number, nullable
- `expiry_from` string, nullable
- `expiry_to` string, nullable
- `older_than` string, nullable: Cursor — rows strictly older
- `newer_than` string, nullable
- `limit` integer

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/optionwhales/apis/optionwhales-pro-api.md) · [All operations](https://skmtc.dev/optionwhales/apis/optionwhales-pro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/optionwhales/apis/optionwhales-pro-api/revisions/e76bc0d3a770?raw)