---
title: "Api Options Unusual"
method: GET
path: "/api/options/unusual"
---

# Api Options Unusual

`GET /api/options/unusual`

## Request

- Base URL: `https://www.oxfordledge.com` (the document declares no server; this is the origin it was published from)
- URL: `https://www.oxfordledge.com/api/options/unusual`
- Auth: none declared

Unusual options activity scanner.

## Query parameters

- `ticker` string, nullable

## Response `200`

Successful Response

- OptionsUnusualResponse: `/api/options/unusual` — unusual options activity scanner. F4 boundary backfill 2026-05-08 (Initiative 6). Plus-tier gated. Frontend expects `unusual` as an iterable list always — error envelope still carries the empty list.
  - `ticker` string, required: Uppercase ticker echo.
  - `unusual` unknown[], required: Unusual-activity rows from the scanner. Empty list when none qualify. Item shape decided by services.analysis._handle_options_unusual_sync.
    - unknown
  - `error` string, nullable: Error message when the scanner failed; mutually exclusive with non-empty `unusual`.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/oxfordledge/apis/oxford-ledge-api.md) · [All operations](https://skmtc.dev/oxfordledge/apis/oxford-ledge-api/llms.txt) · [OpenAPI document](https://skmtc.dev/oxfordledge/apis/oxford-ledge-api/revisions/e832a1260f0b?raw)