---
title: "Universal Snapshot"
method: GET
path: "/v3/snapshot"
---

# Universal Snapshot

`GET /v3/snapshot`

Get snapshots for assets of all types

## Query parameters

- `ticker` string
- `type` 'stocks' | 'options' | 'crypto' | 'fx' | 'indices'
- `ticker.gte` string
- `ticker.gt` string
- `ticker.lte` string
- `ticker.lt` string
- `ticker.any_of` string
- `order` 'asc' | 'desc'
- `limit` integer
- `sort` 'ticker'

## Response `200`

Snapshots for the ticker list

- object
  - `next_url` string — If present, this value can be used to fetch the next page of data.
  - `request_id` string, required — A request id assigned by the server.
  - `results` object[] — An array of results containing the requested data.
    - `break_even_price` number, double — 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).
    - `details` object — The details for this contract.
      - `contract_type` 'put' | 'call' | 'other', required — The type of contract. Can be "put", "call", or in some rare cases, "other".
      - `exercise_style` 'american' | 'european' | 'bermudan', required — The exercise style of this contract. See <a rel="nofollow" target="_blank" href="https://en.wikipedia.org/wiki/Option_style">this link</a> for more details on exercise styles.
      - `expiration_date` string, date, required — The contract's expiration date in YYYY-MM-DD format.
      - `shares_per_contract` number, required — The number of shares per contract for this contract.
      - `strike_price` number, double, required — The strike price of the option contract.
    - `error` string — The error while looking for this ticker.
    - `fmv` number — 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, <a rel="nofollow" target="_blank" href="https://massive.com/contact">contact us</a>.
    - `fmv_last_updated` integer — If Fair Market Value (FMV) is available, this field is the nanosecond timestamp of the last FMV calculation.
    - `greeks` object — 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 <a href="https://massive.com/blog/greeks-and-implied-volatility/#testing" alt="link">article</a> for more information.
      - `delta` number, double, required — The change in the option's price per $0.01 increment in the price of the underlying asset.
      - `gamma` number, double, required — The change in delta per $0.01 change in the price of the underlying asset.
      - `theta` number, double, required — The change in the option's price per day.
      - `vega` number, double, required — The change in the option's price per 1% increment in volatility.
    - `implied_volatility` number, double — The market's forecast for the volatility of the underlying asset, based on this option's current price.
    - `last_minute` object — The most recent minute aggregate for this stock.
      - `close` number, double, required — The closing value for the minute aggreate.
      - `decimal_volume` string — The trading volume for the minute aggregate with decimal precision. This field provides support for fractional shares, representing volume as a decimal string where the fractional part is expressed in millionths. This field is only returned for stocks snapshots.
      - `high` number, double, required — The highest value for the minute aggregate.
      - `low` number, double, required — The lowest value for the minute aggregate.
      - `open` number, double, required — The open value for the minute aggregate.
      - `transactions` integer, required — The number of transactions that took place within the minute aggregate.
      - `volume` number, double, required — The trading volume for the minute aggregate.
      - `vwap` number, double, required — The trading volume weighted average price for the minute aggregate.
    - `last_quote` object — The most recent quote for this contract. This is only returned if your current plan includes quotes.
      - `ask` number, double, required — The ask price.
      - `ask_exchange` integer — The ask side exchange ID. See <a href="https://massive.com/docs/rest/options/market-operations/exchanges" alt="Exchanges">Exchanges</a> for Massive's mapping of exchange IDs.
      - `ask_size` number, double — The ask size. This represents the number of round lot orders at the given ask price. The normal round lot size is 100 shares. An ask size of 2 means there are 200 shares available to purchase at the given ask price.
      - `bid` number, double, required — The bid price.
      - `bid_exchange` integer — The bid side exchange ID. See <a href="https://massive.com/docs/rest/options/market-operations/exchanges" alt="Exchanges">Exchanges</a> for Massive's mapping of exchange IDs.
      - `bid_size` number, double — The bid size. This represents the number of round lot orders at the given bid price. The normal round lot size is 100 shares. A bid size of 2 means there are 200 shares for purchase at the given bid price.
      - `last_updated` integer, required — The nanosecond timestamp of when this information was updated.
      - `midpoint` number, double — The average of the bid and ask price.
      - `timeframe` 'DELAYED' | 'REAL-TIME', required — The time relevance of the data.
    - `last_trade` object — The most recent quote for this contract. This is only returned if your current plan includes trades.
      - `conditions` integer[] — A list of condition codes.
      - `decimal_size` string — The size of a trade, including fractional shares, represented as a decimal string where the fractional part is expressed in millionths. This field is only returned for stocks snapshots.
      - `exchange` integer — The exchange ID. See <a href="https://massive.com/docs/rest/stocks/market-operations/exchanges" alt="Exchanges">Exchanges</a> for Massive's mapping of exchange IDs.
      - `id` string — The Trade ID which uniquely identifies a trade. These are unique per combination of ticker, exchange, and TRF. For example: A trade for AAPL executed on NYSE and a trade for AAPL executed on NASDAQ could potentially have the same Trade ID.
      - `last_updated` integer — The nanosecond timestamp of when this information was updated.
      - `participant_timestamp` integer — The nanosecond Exchange Unix Timestamp. This is the timestamp of when the trade was generated at the exchange.
      - `price` number, double, required — The price of the trade. This is the actual dollar value per whole share of this trade. A trade of 100 shares with a price of $2.00 would be worth a total dollar value of $200.00.
      - `sip_timestamp` integer — The nanosecond accuracy SIP Unix Timestamp. This is the timestamp of when the SIP received this trade from the exchange which produced it.
      - `size` integer, required — The size of a trade (also known as volume).
      - `timeframe` 'DELAYED' | 'REAL-TIME' — The time relevance of the data.
    - `last_updated` integer — The nanosecond timestamp of when this information was updated.
    - `market_status` string — 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 — The error message while looking for this ticker.
    - `name` string — The name of this contract.
    - `open_interest` number, double — The quantity of this contract held at the end of the last trading day.
    - `session` object — 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.
      - `change` number, double, required — The value of the price change for the asset from the previous trading day.
      - `change_percent` number, double, required — The percent of the price change for the asset from the previous trading day.
      - `close` number, double, required — The closing price of the asset for the day.
      - `decimal_volume` string — The trading volume for the asset for the day with decimal precision. This field provides support for fractional shares, representing volume as a decimal string. This field is only returned for stocks snapshots.
      - `early_trading_change` number, double — Today's early trading change amount, difference between price and previous close if in early trading hours, otherwise difference between last price during early trading and previous close.
      - `early_trading_change_percent` number, double — Today's early trading change as a percentage.
      - `high` number, double, required — The highest price of the asset for the day.
      - `late_trading_change` number, double — Today's late trading change amount, difference between price and today's close if in late trading hours, otherwise difference between last price during late trading and today's close.
      - `late_trading_change_percent` number, double — Today's late trading change as a percentage.
      - `low` number, double, required — The lowest price of the asset for the day.
      - `open` number, double, required — The open price of the asset for the day.
      - `previous_close` number, double, required — The closing price of the asset for the previous trading day.
      - `price` number, double — The price of the most recent trade or bid price for this asset.
      - `regular_trading_change` number, double — Today's change in regular trading hours, difference between current price and previous trading day's close, otherwise difference between today's close and previous day's close.
      - `regular_trading_change_percent` number, double — Today's regular trading change as a percentage.
      - `volume` number, double — The trading volume for the asset for the day.
    - `ticker` string, required — The ticker symbol for the asset.
    - `timeframe` 'DELAYED' | 'REAL-TIME' — The time relevance of the data.
    - `type` 'stocks' | 'options' | 'fx' | 'crypto' | 'indices' — The asset class for this ticker.
    - `underlying_asset` object — Information on the underlying stock for this options contract. The market data returned depends on your current stocks plan.
      - `change_to_break_even` number, double, required — The change in price for the contract to break even.
      - `last_updated` integer — The nanosecond timestamp of when this information was updated.
      - `price` number, double — The price of the trade. This is the actual dollar value per whole share of this trade. A trade of 100 shares with a price of $2.00 would be worth a total dollar value of $200.00.
      - `ticker` string, required — The ticker symbol for the contract's underlying asset.
      - `timeframe` 'DELAYED' | 'REAL-TIME' — The time relevance of the data.
      - `value` number, double — The value of the underlying index.
    - `value` number — Value of Index.
  - `status` string, required — The status of this request's response.

---

[API](https://skmtc.net/massive/apis/polygon-api.md) · [All operations](https://skmtc.net/massive/apis/polygon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/massive/polygon-api/revisions/ad6f143e43aa/schema)