---
title: "Screen the market for option contracts"
method: GET
path: "/api/screener/option-contracts"
---

# Screen the market for option contracts

`GET /api/screener/option-contracts`

A contract screener endpoint to screen the market for contracts by a variety of filter options. Contracts with a volume of less than 200 are not returned.

## Query parameters

- `expiry_dates` string[]
- `is_otm` boolean
- `issue_types` string[]
- `max_daily_perc_change` number
- `min_volume` integer
- `order` 'bid_ask_vol' | 'bull_bear_vol' | 'contract_pricing' | 'daily_perc_change' | 'volume'
- `order_direction` 'asc' | 'desc'

## Response `200`

A list of option contracts

- HottestChainsResponse
  - `data` HottestChainEntry[]
    - `ask_side_volume` integer
    - `avg_price` string
    - `bid_side_volume` integer
    - `chain_prev_close` string
    - `close` string
    - `cross_volume` integer
    - `floor_volume` integer
    - `high` string
    - `low` string
    - `option_symbol` string
    - `premium` string
    - `sector` 'Basic Materials' | 'Communication Services' | 'Consumer Cyclical' | 'Consumer Defensive' | 'Energy' | 'Financial Services' | 'Healthcare' | 'Industrials' | 'Real Estate' | 'Technology' | 'Utilities'
    - `stock_price` string
    - `trades` integer
    - `volume` integer

## Other responses

- `422` — Validation Error
- `500` — Server Error

---

[API](https://skmtc.net/the-unnatural-group--llc/apis/tradesignals-api.md) · [All operations](https://skmtc.net/the-unnatural-group--llc/apis/tradesignals-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/the-unnatural-group--llc/tradesignals-api/revisions/0b37cadfb125/schema)