---
title: "Get Options Screener"
method: GET
path: "/api/options-screener"
tags: ["options-screener"]
---

# Get Options Screener

`GET /api/options-screener`

## Request

- Base URL: `https://api.equity-rank.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.equity-rank.com/api/options-screener`
- Auth: HTTP bearer

Return ranked options strategy opportunities.

Each result includes a SAVE-score-derived directional signal, recommended
options strategy, IV rank, IV percentile, put/call ratio, total OI,
implied 7-day move, conviction score, margin of safety, and rationale bullets.

When wheel_preset=true, results are filtered for the cash-secured put /
covered-call wheel strategy: bullish/neutral direction, IV rank ≥ 40,
earnings > 14 days out, and covered-call premium yield ≥ 1.5%/month.
Use wheel_max_price to gate by account size (e.g. 50 for Standard, 200 for Enhanced).

## Query parameters

- `direction` string, nullable: Filter by direction: bullish | bearish | neutral
- `sector` string, nullable: Filter by sector name, e.g. 'Technology'
- `min_iv_rank` number, nullable: Minimum IV rank (0-100)
- `max_iv_rank` number, nullable: Maximum IV rank (0-100)
- `earnings_within_14d` boolean: Only show options where underlying has earnings within 14 days
- `sort_by` string: Sort field: conviction | iv_rank | save_score | implied_move
- `limit` integer: Maximum results to return
- `force_refresh` boolean: Bypass cache and re-fetch
- `wheel_preset` boolean: Filter for wheel-strategy candidates (iv_rank≥40, earnings>14d, cc_yield≥1.5%/mo)
- `wheel_max_price` number, nullable: Max stock price for account-size gating (e.g. 50 or 200)

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

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