Option quotes
Latest eligible observation per option contract at as_of, including open interest and provider Greeks. Requires exactly one of contract_ids or underlying_ids; these collections are subject to batch and chain-size limits. Observations are end-of-day snapshots, timed at the session close and published the next morning; only the two newest daily snapshots are kept, so an earlier as_of returns no quotes. volume is the snapshot session's, 0 when the contract did not trade; implied_volatility and the Greeks are the provider's. Default order: event_at ascending, id ascending. Explicit contract/underlying selection is required. Data is delivered from validated canonical batches; a connected dataset with nothing published for the key's markets yet returns 503. Access requires the operation capability on the API key.
/v1/options/quotes- Required capability
- options.read
- Data timing
- End of day; quotes the next morning
- Credits
- 50 credits per request.
Parameters
contract_idsstringoptional · query- Contract instrument IDs; mutually exclusive with underlying_ids.
underlying_idsstringoptional · query- Underlying IDs for chain-wide snapshots; mutually exclusive with contract_ids.
expirationstringoptional · query- Contract expiration date.
as_ofstringoptional · query- Knowledge cutoff as a UTC date (YYYY-MM-DD): the response reflects what was known by the end of that day. Defaults to now; cannot be in the future. A date from before the dataset's knowledge history returns 422 point-in-time-unavailable naming the earliest one, which GET /v1/datasets lists as earliest_as_of.
known_fromstringoptional · query- First UTC date (YYYY-MM-DD, inclusive) on which a revision became known.
known_tostringoptional · query- Last UTC date (YYYY-MM-DD, inclusive) on which a revision became known; on or after known_from.
orderstringoptional · query- Direction on event_at; ties use ID ascending.
Default:ascdescasc limitintegeroptional · query- Maximum records per page.Default:
100 cursorstringoptional · query- Opaque cursor, expires after one hour; binds filters, order, resolved as_of, account/key and entitlement. Repeat the original query unchanged.
formatstringoptional · query- Response format. csv returns the data rows with a header row, for spreadsheet functions such as IMPORTDATA; nested fields become dotted columns and lists one JSON array cell, the next page cursor is returned in X-Next-Cursor and meta.errors in X-Meta-Errors. A result without rows is the header row alone, listing the documented fields of a row. Default json, or csv when format is omitted and the Accept header ranks text/csv above JSON; a format the Accept header does not admit returns 406 not-acceptable.
jsoncsv
Response fields
Returns data as an array of records. All example values are illustrative.
idstring- Record identifier, stable across revisions.
instrument_idstring- Opaque stable public identifier; never an internal database key.
event_atstring- event at
bidobject- bid
askobject- ask
lastobject- last
volumestring · null- Contracts traded in the session.
open_intereststring · null- Open contracts.
open_interest_datestring · null- Date the open interest was measured. The connected source does not report it: always null.
implied_volatilitystring · null- Dimensionless ratio; 0.05 means 5%.
deltastring · null- Price sensitivity to a one-unit underlying move.
gammastring · null- Delta sensitivity per underlying unit.
thetastring · null- Option value change per calendar day.
vegastring · null- Option value change per one percentage point of volatility.
rhostring · null- Option value change per one percentage point of interest rate.
Response metadata
Responses include meta.timezone. Dataset responses include next_cursor; health and exports have their own metadata. Request tracing uses the X-Request-ID header.
When something goes wrong
An empty data: [] is a successful query with no matching records. Invalid symbols, permissions and malformed parameters produce an RFC 9457 problem with an actionable detail.
Plans
Requires options.read. Access, recency and history depth come from the plan definitions the API enforces.
| Plan | Access | Recency | History |
|---|---|---|---|
| Free | Not included | — | — |
| Developer | Not included | — | — |
| Pro | Included | End of day; quotes the next morning | Not date-bounded |
| Commercial | Included | End of day; quotes the next morning | Not date-bounded |
| Scale | Included | End of day; quotes the next morning | Not date-bounded |
History is how far back a plan may request. How far records actually go for a symbol is history_from in dataset coverage. Nothing is real-time. Compare plans