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 Indices plans
Plan
Recency
Not included
15-minute delayed
15-minute delayed
Real-time
Plan Recency15-minute delayed or real-time
Plan HistoryNot applicable to this endpoint
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_last_updated
integer
optional
If Fair Market Value (FMV) is available, this field is the nanosecond timestamp of the last FMV calculation.
last_updated
integer
optional
The nanosecond timestamp of when this information was updated.
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.
timeframe
enum (DELAYED, REAL-TIME)
optional
The time relevance of the data.
type
enum (stocks, options, fx, crypto, indices)
optional
The asset class for this ticker.
value
number
optional
Value of Index.
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