---
title: "Changes to Get Snapshots"
method: GET
path: "/v1/market-data/snapshot"
---

# Changes to Get Snapshots

`GET /v1/market-data/snapshot`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 8 of 62 revisions.

- **2026-10-30** `7e4b278ca27a`: 1 info
- **2026-10-16** `1bd9eddeffc8`: 1 breaking, 1 warning, 25 info
- **2026-07-14** `9632aa50482b`: 1 warning
- **2026-07-14** `6ffc79452bbe`: 1 warning
- **2026-07-14** `2d8a75e46de7`: 1 warning
- **2026-06-25** `3ec7298ffad4`: 6 breaking
- **2026-05-28** `31dbdc1ad324`: 1 info
- **2026-05-19** `dc926c706aea`: 1 info

## Changes

- **2026-10-30** `7e4b278ca27a`: 1 info
  - added the non-success response with the status `503`
- **2026-10-16** `1bd9eddeffc8`: 1 breaking, 1 warning, 25 info
  - the `allOf[subschema #2]/data/items/session` response's property type changed from no type to `object` for status `200`
  - for the `query` request parameter `instrument_ids`, the type of property `items/` changed from no type to `string`
  - added the new optional `query` request parameter `expiry`
  - added the new optional `query` request parameter `underlying_instrument_id`
  - added the non-success response with the status `500`
  - added the optional property `allOf[subschema #2]/data/items/last_quote/oneOf[#/components/schemas/SnapshotQuote]/ask_timestamp` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/items/last_quote/oneOf[#/components/schemas/SnapshotQuote]/ask_venue` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/items/last_quote/oneOf[#/components/schemas/SnapshotQuote]/bid_timestamp` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/items/last_quote/oneOf[#/components/schemas/SnapshotQuote]/bid_venue` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/items/last_trade/oneOf[#/components/schemas/SnapshotLastTrade]/timestamp` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/items/last_trade/oneOf[#/components/schemas/SnapshotLastTrade]/venue` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/items/open_interest` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/items/session/change` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/items/session/change_percent` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/items/session/cumulative_volume` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/items/session/high` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/items/session/low` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/items/session/ohlv_date` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/items/session/open` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/items/session/previous_close` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/items/session/previous_close_unadjusted` to the response with the `200` status
  - the response property `allOf[subschema #2]/data/items/session` became required for the status `200`
  - response property `allOf[subschema #2]/data/items/cumulative_volume` deprecated
  - removed `#/components/schemas/SnapshotSession, subschema #1` from the `allOf[subschema #2]/data/items/session` response property `oneOf` list for the response status `200`
  - added the required property `allOf[subschema #2]/data/items/session/ohlv_applicable` to the response with the `200` status
  - added the required property `allOf[subschema #2]/data/items/short_sale_restricted` to the response with the `200` status
  - added the success response with the status `207`
- **2026-07-14** `9632aa50482b`: 1 warning
  - for the `query` request parameter `instrument_ids`, the type of property `items/` changed from `string` to no type, and format from `uuid` to no format
- **2026-07-14** `6ffc79452bbe`: 1 warning
  - for the `query` request parameter `instrument_ids`, the type of property `items/` changed from no type to `string`, and format from no format to `uuid`
- **2026-07-14** `2d8a75e46de7`: 1 warning
  - for the `query` request parameter `instrument_ids`, the type of property `items/` changed from `string` to no type, and format from `uuid` to no format
- **2026-06-25** `3ec7298ffad4`: 6 breaking
  - the response property `allOf[subschema #2]/data/items/last_quote/oneOf[#/components/schemas/SnapshotQuote]/ask` became nullable for the status `200`
  - the response property `allOf[subschema #2]/data/items/last_quote/oneOf[#/components/schemas/SnapshotQuote]/bid` became nullable for the status `200`
  - the response property `allOf[subschema #2]/data/items/last_quote/oneOf[#/components/schemas/SnapshotQuote]/midpoint` became nullable for the status `200`
  - the response property `allOf[subschema #2]/data/items/last_quote/oneOf[#/components/schemas/SnapshotQuote]/ask` became optional for the status `200`
  - the response property `allOf[subschema #2]/data/items/last_quote/oneOf[#/components/schemas/SnapshotQuote]/bid` became optional for the status `200`
  - the response property `allOf[subschema #2]/data/items/last_quote/oneOf[#/components/schemas/SnapshotQuote]/midpoint` became optional for the status `200`
- **2026-05-28** `31dbdc1ad324`: 1 info
  - added the optional property `allOf[subschema #2]/data/items/greeks` to the response with the `200` status
- **2026-05-19** `dc926c706aea`: 1 info
  - added the required property `allOf[subschema #2]/data/items/last_trade/oneOf[#/components/schemas/SnapshotLastTrade]/size` to the response with the `200` status

---

[Operation](https://skmtc.dev/clear-street/apis/clear-street-trading-api/docs/v1/market-data/snapshot/get.md) - [API](https://skmtc.dev/clear-street/apis/clear-street-trading-api.md) - [Page](https://skmtc.dev/clear-street/apis/clear-street-trading-api/changes/v1/market-data/snapshot/get)