Pick the Quant plan
REST API access, including the screener and journal endpoints, comes with Quant.
Options-selling screener · REST API v1
The options-selling screener, as JSON
POST your filters, get ranked cash-secured put and covered call candidates back. Your wheels, journal, earnings, and expirations live on the same key.
Included with the Quant plan.
POST/api/v1/screener200 - 412ms
{"strategies": ["Cash Secured Put"],"tickers": ["NVDA", "AMD", "SPY"],"minYield": 0.5,"maxDays": 45,"maxRisk": 0.2,"minZScore": 3}{ "count": 12, "options": [{ "ticker": "NVDA", "strike": 175,"expiration": "2026-10-16", "rating": 112,"weeklyYield": 0.71, "assignmentRisk": 0.14 },...], "pagination": { ... } }
/v1/screener · puts · rating ≥ 90live
| Ticker | Contract | Premium | Rating | Annualized |
|---|---|---|---|---|
| NVDA | 08/15 175P | 1.9% | 96 | 69% |
| AMD | 08/15 155P | 1.6% | 99 | 58% |
| SPY | 08/22 610P | 0.8% | 103 | 24% |
| TSLA | 08/08 300P | 2.4% | 93 | 88% |
6screener and journal endpoints
5strategies
30screens / min
1API key
Screen the way the app does, from code
Every filter in Find Deals is a JSON field. The response carries derived scores only: rating, yield, annualized return, assignment risk, and distance to strike.
Filters, not menus
Rating, yield, days, and risk in one body
Combine strategy, option filters, company financials, and technicals in one request. Results come back sorted by rating and paginated, so an agent can page through a whole universe.
- strategiesCash Secured Put, Covered Calls, Buy Write, Long Call, Long Put
- minYield, maxDays, maxRiskweekly yield, days to expiration, assignment risk
- minZScore, minFScore, minMarketCapcompany quality filters on the same call
/v1/screener · puts · rating ≥ 90live
| Ticker | Contract | Premium | Rating | Annualized |
|---|---|---|---|---|
| NVDA | 08/15 175P | 1.9% | 96 | 69% |
| AMD | 08/15 155P | 1.6% | 99 | 58% |
| SPY | 08/22 610P | 0.8% | 103 | 24% |
| TSLA | 08/08 300P | 2.4% | 93 | 88% |
Derived scores, no quote data
The public screener returns rating, yield, annualized return, and assignment risk. Bid, ask, implied volatility, and greeks stay in the app, so the endpoint is safe to expose to an agent.
Your account on the same key
/v1/wheels returns your open wheels and stats from the synced broker; /v1/journal returns performance over time and yearly summaries.
Calendar context
/v1/earnings lists upcoming reports and /v1/expirations the tradable expirations, so a script can avoid earnings and pick the right cycle before it screens.
Same engine as the MCP tools
Everything here is also an MCP tool, so Claude, ChatGPT, and Cursor can call it in plain English. Meet the Wheel MCP.
The screener and journal endpoints
The full request and response reference lives in the docs.
POST/v1/screener
Ranked candidates for your filters (30 requests a minute)
GET/v1/wheels
Your wheel positions and stats; ?symbol= narrows to one ticker
GET/v1/journal/performance
Journal performance over time
GET/v1/journal/summary
Yearly journal stats; ?year= picks the year
GET/v1/earnings
Upcoming earnings calendar; ?limit= caps the list
GET/v1/expirations
Available option expirations for ?symbol=
How it works
First screen in three minutes
Generate your key
Head to Dashboard → API and mint a key. Rotate it anytime.
POST your filters
Send a JSON body with your strategy and filters, Bearer key in the header, and page through the candidates.
Prefer prompts over HTTP?
The same screener and journal, as MCP tools for your AI
Ask Claude, ChatGPT, or Cursor what to sell next and how your wheels are doing, in plain English.
Want everything?
The full API: GEX, flows, screener, and your account
The screener is one part of the catalogue - the overview page lists every endpoint on the key.
Screen the market from your own code
One key, one POST, ranked candidates back. Wheels, journal, earnings, and expirations on the same key.
Included with the Quant plan. MCP access is included with every paid plan.