---
title: "Scored unusual options flow"
method: GET
path: "/unusual-activity"
---

# Scored unusual options flow

`GET /unusual-activity`

## Request

- Base URL: `https://api.tradermatrix.pro/api/v1`
- URL: `https://api.tradermatrix.pro/api/v1/unusual-activity`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

## Query parameters

- `ticker` string
- `minPremium` integer
- `minScore` integer
- `type` 'all' | 'call' | 'put'
- `sentiment` 'all' | 'bullish' | 'bearish'
- `timeFrame` 'hour' | 'today' | 'todayOrLastSession' | 'yesterday' | '3days' | 'week' | 'month'
- `tier` 1 | 2 | 3
- `page` integer
- `pageSize` integer
- `dte` string
- `tradeType` string
- `flowAction` 'opening' | 'closing' | 'all'
- `minOtmPct` number
- `minVsOI` number
- `minOI` number
- `marketCapTier` 'mega' | 'large' | 'mid' | 'small' | 'all'

## Response `200`

OK. Top-level `sessionDate` (YYYY-MM-DD, ET) names the trading session the rows were read from for timeFrame today / todayOrLastSession / yesterday (todayOrLastSession serves the last complete session until the market opens); null for rolling windows.

## Other responses

- `401`: Missing or invalid API key.
- `429`: Rate limit exceeded (30 requests/minute per key). Back off; do not retry in a tight loop.

---

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