Unified Snapshot
GET
/v3/snapshot
Retrieve unified snapshots of market data for multiple asset classes including stocks, options, forex, and cryptocurrencies in a single request. This endpoint consolidates key metrics such as last trade, last quote, open, high, low, close, and volume for a comprehensive view of current market conditions. By aggregating data from various sources into one response, users can efficiently monitor, compare, and act on information spanning multiple markets and asset types.
Use Cases: Cross-market analysis, diversified portfolio monitoring, global market insights, multi-asset trading strategies.
Plan AccessIncluded in select Currencies plans
Plan RecencyReal-time
Plan HistoryNot applicable
Query Parameters
ticker
string
Search a range of tickers lexicographically.
type
enum (string)
Query by the type of asset.
order
enum (string)
Order results based on the `sort` field.
limit
integer
Limit the number of results returned, default is 10 and max is 250.
sort
enum (string)
Sort field used for ordering.
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
array (object)
optional
An array of results containing the requested data.
error
string
optional
The error while looking for this ticker.
fmv
number
optional
Fair Market Value is only available on Business plans. It is our proprietary algorithm to generate a real-time, accurate, fair market value of a tradable security.
For more information, contact us.
Access included in select Currencies plans
fmv_last_updated
integer
optional
If Fair Market Value (FMV) is available, this field is the nanosecond timestamp of the last FMV calculation.
Access included in select Currencies plans
last_minute
object
optional
The most recent minute aggregate for this stock.
last_quote
object
optional
The most recent quote for this contract. This is only returned if your current plan includes quotes.
market_status
string
optional
The market status for the market that trades this ticker. Possible values for stocks, options, crypto, and forex snapshots are open, closed, early_trading, or late_trading.
Possible values for indices snapshots are regular_trading, closed, early_trading, and late_trading.
message
string
optional
The error message while looking for this ticker.
name
string
optional
The name of this contract.
session
object
optional
Comprehensive trading session metrics, detailing price changes, trading volume, and key price points (open, close, high, low) for the asset within the current trading day. Includes specific changes during early, regular, and late trading periods to enable detailed performance analysis and trend tracking.
ticker
string
The ticker symbol for the asset.
type
enum (stocks, options, fx, crypto, indices)
optional
The asset class for this ticker.
status
string
The status of this request's response.
Code Examples
Query URL
GET
Run query unavailable
Create account or sign in to Polygon
Scroll to see updated query response
Response Object