GET/v1/stocks/top-ivr

Get stocks with highest IV rank

Returns equities ranked by highest 52-week IV rank (IVR), excluding stocks with IV > 200%. Limit defaults to 20; capped at your account plan's max_rows; requests exceeding 100 are capped silently.

Endpoint Usage & Plan Rules

Plan Access

Included in Basic

Active subscription

Rate Limit

Your plan's per-minute limit

One request per call; no daily quota

Result Clamping

Clamped by Plan

Clamped to plan max_rows

Parameters

Optional Parameters

Name	Type	Location	Description
limit	integer	query	Maximum stocks to return (1-100, default 20). Clamped to plan max_rows.

Request Examples

curl -s -H "Authorization: Bearer $WSO_API_KEY" \
  "https://api.wheelstrategyoptions.com/v1/stocks/top-ivr?limit=20"

Try it

GET/v1/stocks/top-ivr

Included in Basic

limitquery

Add your API key to send.

Response

Send a request to see the live response, its status, timing, and rate-limit headers.

Response Attributes (200 OK)

Field	Type	Nullable	Description
stocks	object[]	No	List of top IV stocks.

Response Example

json

{
  "stocks": [
    {
      "symbol": "AGNC",
      "name": "AGNC Investment Corp.",
      "stockIV": 33.1,
      "ivr": 100,
      "ivChange1w": 2,
      "marketCap": 10420400000,
      "logoUrl": "https://images.financialmodelingprep.com/symbol/AGNC.png"
    },
    {
      "symbol": "ASGN",
      "name": "ASGN Incorporated",
      "stockIV": 157.65,
      "ivr": 100,
      "ivChange1w": 0,
      "marketCap": null,
      "logoUrl": "https://images.financialmodelingprep.com/symbol/ASGN.png"
    },
    {
      "symbol": "AXL",
      "name": "American Axle & Manufacturing Holdings, Inc.",
      "stockIV": 170.6,
      "ivr": 100,
      "ivChange1w": 0,
      "marketCap": null,
      "logoUrl": "https://images.financialmodelingprep.com/symbol/AXL.png"
    }
  ]
}

Error Responses

Status	Description
400	Bad Request. The request body, query parameters, or path values violated validation constraints.
401	Unauthorized. Missing, malformed, or invalid API key credential.
403	Forbidden. Rejection reasons: `subscription_required` (no subscription record), `subscription_inactive` (subscription not active), `trial_ended` (trial has expired), `wrong_credential_type`, `origin_forbidden` (origin authentication failed).
404	Not Found. Requested resource, ticker symbol, or option contract does not exist.
405	Method Not Allowed. Returned with an `Allow` header when an unsupported HTTP method is used. Error code: `method_not_allowed`. (HEAD is served on all GET routes and counts against the rate limit like GET.)
429	Too Many Requests. Rejection reasons: `rate_limited` (per-minute limit), `too_many_concurrent_requests` (in-flight cap), `too_many_auth_failures`.
500	Internal Server Error. Unhandled internal server or database error.
503	Service Unavailable. Backing database, cache, or external provider connection unavailable.

Get stocks with highest implied volatility Get dealer gamma exposure profile