Options

A stock's daily implied-volatility history, newest first: constant-30-day implied volatility (`derivedIv30`), IV rank and IV percentile over the trailing year, the at-the-money IV of the near and far expirations, and 30-session realized volatility. Two bases are stated apart and never blended: derived figures come from our model on each session's at-the-money option closes with the stock close (ranked, stored from 2024-01-18), and quoted figures from the source's model captured in the session's last quarter hour (from launch, unranked); each session carries the contract and trade counts behind its derived figure, and a session without enough traded contracts has none. Volatilities are decimal fractions and rank and percentile run 0 to 100. A stock the one-time backfill has not reached yet is queued by the first read and answers with `coverage.backfillComplete: false` and a `notice`. `startDate` and `endDate` set the window (default: the last year). Plus and Pro read it; the Free plan covers end-of-day data only and receives 403. US listings only.

get/v1/securities/{ticker}/options/volatility

Request

Path parameters

tickerstring required

Exact listed underlying (e.g. GOOG, GOOGL, BRK-A, or BRK-B). A listing never falls through to its sibling; dot class-share spelling such as BRK.B is accepted as BRK-B.

Query parameters

startDatestring

First session, YYYY-MM-DD (default: a year before endDate).

endDatestring

Last session, YYYY-MM-DD (default: today).

limitinteger

Maximum sessions to return, newest first (default: 250, max: 500).

Response

OK

tickerstring nullable
companyNamestring nullable
startDatestring date
endDatestring date
returnedinteger
truncatedboolean

True when older sessions exist in the window; pass the oldest session as endDate, or raise limit.

delayedboolean

True on Plus, where a quoted capture younger than 15 minutes is withheld; derived figures are end-of-day and never withheld.

noticestring nullable

Present while the series is still being built for this stock.

Changes

No recorded changes to this operation across all 1 revision of this API.