Option Trade-Stance Ranking

GET https://api.unusualwhales.com/api/stock/{ticker}/option-stance

Request

Security: Bearer Auth Authorization: Bearer <token>

Path Parameters

ticker string required

Ticker symbol, e.g. RBLX.

Query Parameters

stance string required

Trade stance to rank by.

enum: sell_premium, sell_vega, directional, leaps, cheapies

limit integer optional

Max contracts to return. Default 25, max 100.

type string optional

Restrict to Calls or Puts.

enum: Calls, Puts

option_symbol string optional

Score a single specific contract (OCC option symbol, e.g. NVDA270115P00275000) instead of ranking the chain. `data` returns just that one scored contract.

date string optional

Optional historical date (YYYY-MM-DD).

Responses

200 422 500

Response Body 200 OK

as_of_date string

Example: 2026-07-14

context object

data array[object]

disclaimer string

stance string

Example: sell_premium

ticker string

Example: RBLX

Try It GET

API Token

Path Parameters

ticker required

Query Parameters

stance required string

limit integer

type string

option_symbol string

date string

Request Sample

curl -X GET "https://api.unusualwhales.com/api/stock/{ticker}/option-stance?stance=VALUE" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

import http.client

conn = http.client.HTTPSConnection("api.unusualwhales.com")
headers = {"Authorization": "Bearer YOUR_API_KEY", "Accept": "application/json"}
conn.request("GET", "/api/stock/{ticker}/option-stance?stance=VALUE", headers=headers)
response = conn.getresponse()
print(response.read().decode("utf-8"))

Response Example 200

{
  "as_of_date": "2026-07-14",
  "context": {
    "iv_30d": 0.0,
    "iv_percentile": 0.0,
    "iv_rank": 0.0,
    "stock_price": 0.0
  },
  "data": [
    {
      "avg_price": 0.0,
      "components": null,
      "delta": 0.0,
      "dte": 0,
      "earnings_before_expiry": true
    }
  ],
  "disclaimer": "string",
  "stance": "sell_premium"
}