Option Contract Snapshot
GET
/v3/snapshot/options/{underlyingAsset}/{optionContract}Retrieve a comprehensive snapshot of a specified options contract, consolidating vital metrics and market data into a single response. This endpoint provides details such as break-even price, day-over-day changes, implied volatility, open interest, greeks (delta, gamma, theta, vega), and the latest quote and trade information. Users also gain insights into the underlying asset’s current price, enabling a full evaluation of the contract’s value and potential.
Use Cases: Trade evaluation, market analysis, risk assessment, and strategy refinement.
Path Parameters
underlyingAsset
string
required
The underlying ticker symbol of the option contract.
optionContract
string
required
The option contract identifier.
Response Attributes
next_url
string
optional
If present, this value can be used to fetch the next page of data.
request_id
string
A request id assigned by the server.
results
object
optional
Contains the requested snapshot data for the specified contract.
break_even_price
number
The price of the underlying asset for the contract to break even. For a call, this value is (strike price + premium paid). For a put, this value is (strike price - premium paid).
day
object
The most recent daily bar for this contract.
details
object
The details for this contract.
fmv
number
optional
Fair market value is only available on Business plans. It's it our proprietary algorithm to generate a real-time, accurate, fair market value of a tradable security.
For more information, contact us.
greeks
object
optional
The greeks for this contract.
There are certain circumstances where greeks will not be returned, such as options contracts that are deep in the money.
See this article for more information.
implied_volatility
number
optional
The market's forecast for the volatility of the underlying asset, based on this option's current price.
last_quote
object
The most recent quote for this contract. This is only returned if your current plan includes quotes.
last_trade
object
optional
The most recent trade for this contract. This is only returned if your current plan includes trades.
open_interest
number
The quantity of this contract held at the end of the last trading day.
underlying_asset
object
Information on the underlying stock for this options contract. The market data returned depends on your current stocks plan.
status
string
The status of this request's response.