---
title: "Changes to Get Option Contracts"
method: GET
path: "/v1/instruments/options/contracts"
---

# Changes to Get Option Contracts

`GET /v1/instruments/options/contracts`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 6 of 62 revisions.

- **2026-10-30** `7e4b278ca27a`: 1 info
- **2026-10-16** `1bd9eddeffc8`: 1 breaking, 8 info
- **2026-07-14** `6ffc79452bbe`: 1 info
- **2026-07-14** `2d8a75e46de7`: 1 breaking
- **2026-07-14** `6ffc79452bbe`: 1 info
- **2026-05-28** `031bbdb610a4`: 1 breaking

## Changes

- **2026-10-30** `7e4b278ca27a`: 1 info
  - added the optional property `allOf[subschema #2]/data/items/underlying_instrument_type` to the response with the `200` status
- **2026-10-16** `1bd9eddeffc8`: 1 breaking, 8 info
  - for the `query` request parameter `underlying_instrument_id`, the minLength was increased from `0` to `1`
  - added the new optional `query` request parameter `contract_ids`
  - added the new optional `query` request parameter `is_settle_on_open`
  - added the new optional `query` request parameter `root`
  - `query` request parameter `underlier` was deprecated
  - for the `query` request parameter `underlying_instrument_id`, the type was generalized from no type to `string`
  - added the optional property `allOf[subschema #2]/data/items/is_settle_on_open` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/items/last_trade_cutoff` to the response with the `200` status
  - added the optional property `allOf[subschema #2]/data/items/tick_rules` to the response with the `200` status
- **2026-07-14** `6ffc79452bbe`: 1 info
  - added the required property `allOf[subschema #2]/data/items/is_tradable` to the response with the `200` status
- **2026-07-14** `2d8a75e46de7`: 1 breaking
  - removed the required property `allOf[subschema #2]/data/items/is_tradable` from the response with the `200` status
- **2026-07-14** `6ffc79452bbe`: 1 info
  - added the required property `allOf[subschema #2]/data/items/is_tradable` to the response with the `200` status
- **2026-05-28** `031bbdb610a4`: 1 breaking
  - removed the required property `allOf[subschema #2]/data/items/is_restricted` from the response with the `200` status

---

[Operation](https://skmtc.dev/clear-street/apis/clear-street-trading-api/docs/v1/instruments/options/contracts/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/instruments/options/contracts/get)