Option Trade-Stance Ranking
Ranks a ticker’s option contracts by how well their mechanics fit a chosen trade stance, across all
recent expiries and strikes. Returns a 0–5 fit_score plus named 0–1 sub-scores (iv_regime, greeks_fit,
dte_fit, liquidity, earnings_timing) and a plain-language explanation for each contract, alongside a
context header (stock price, IV rank, IV percentile).
This is descriptive analysis of greeks / IV context / liquidity mechanics — not trade advice or a
recommendation to buy or sell. Every response carries a disclaimer.
stance is one of: sell_premium, sell_vega, directional, leaps, cheapies. Any stance threshold can
be overridden by passing the corresponding screener filter (e.g. max_dte, min_premium, type).
Pass option_symbol to score a single specific contract for the stance instead of ranking the chain. The
response’s data then holds exactly that one scored contract (with the same fit_score, sub-scores and
explanation), even when it falls outside the stance’s usual candidate profile.
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Ticker symbol, e.g. RBLX.
Query Parameters
Trade stance to rank by.
sell_premium, sell_vega, directional, leaps, cheapies Max contracts to return. Default 25, max 100.
Restrict to Calls or Puts.
Calls, Puts Score a single specific contract (OCC option symbol, e.g. NVDA270115P00275000) instead of ranking the chain. data returns just that one scored contract.
Optional historical date (YYYY-MM-DD).
