---
title: "futures_snapshot_v1 API"
method: GET
path: "/futures/v1/snapshot"
tags: ["us_futures"]
---

# futures_snapshot_v1 API

`GET /futures/v1/snapshot`

Retrieve a snapshot of the most recent futures contract data.

## Query parameters

- `product_code` string
- `product_code.any_of` string
- `product_code.gt` string
- `product_code.gte` string
- `product_code.lt` string
- `product_code.lte` string
- `ticker` string
- `ticker.any_of` string
- `ticker.gt` string
- `ticker.gte` string
- `ticker.lt` string
- `ticker.lte` string
- `limit` integer
- `sort` string

## Response `200`

A list of results.

- object
  - `next_url` string — If present, this value can be used to fetch the next page.
  - `request_id` string, required — A request id assigned by the server.
  - `results` object[], required — The results for this request.
    - `details` object
      - `product_code` string
      - `settlement_date` string, date — The day that this contract is settled.
      - `ticker` string
    - `last_minute` object
      - `close` number, double — The price at the end of the minute bar.
      - `high` number, double — The highest price reached in the minute bar.
      - `last_updated` integer — The timestamp indicating the most recent update to the minute bar.
      - `low` number, double — The lowest price reached in the minute bar.
      - `open` number, double — The opening price at the start of the minute bar.
      - `timeframe` string — The timeliness of the data as determined by your subscription. One of REAL-TIME or DELAYED.
      - `volume` integer — The number of contracts traded in the minute bar.
    - `last_quote` object
      - `ask` number, double — The lowest price a seller is willing to accept.
      - `ask_size` integer — The number of contracts available at the ask price.
      - `ask_timestamp` integer — The time when the best ask price was last updated.
      - `bid` number, double — The highest price a buyer is willing to pay.
      - `bid_size` integer — The number of contracts available at the bid price.
      - `bid_timestamp` integer — The time when the best bid price was last updated.
      - `last_updated` integer — The time when the quote was generated at the exchange to nanosecond precision.
      - `timeframe` string — The timeliness of the data as determined by your subscription. One of REAL-TIME or DELAYED.
    - `last_trade` object
      - `last_updated` integer — The time when the trade was generated at the exchange to nanosecond precision.
      - `price` number, double — The price of the trade. This is the actual dollar value per whole contract of this trade. A trade of 100 contracts with a price of $2.00 would be worth a total dollar value of $200.00.
      - `size` integer — The total number of contracts exchanged between buyers and sellers on a given trade.
      - `timeframe` string — The timeliness of the data as determined by your subscription. One of REAL-TIME or DELAYED.
    - `session` object
      - `change` number, double — The change in price during this session.
      - `change_percent` number, double — The percentage change in price during this session.
      - `close` number, double — The price at the end of the session.
      - `high` number, double — The highest price reached in the session.
      - `low` number, double — The lowest price reached in the session.
      - `open` number, double — The opening price at the start of the session.
      - `previous_settlement` number, double — The settlement price of the previous session.
      - `settlement_price` number, double — The final settlement price at the end of the session.
      - `volume` integer — The number of contracts traded in the session.
  - `status` 'OK', required — The status of this request's response.

## Other responses

- `400` — An error message.

---

[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)