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

# Screen the market for stocks

`GET /api/screener/stocks`

A stock screener endpoint to screen the market for stocks by a variety of filter options.

## Query parameters

- `has_dividends` boolean
- `is_s_p_500` boolean
- `issue_types` string[]
- `max_marketcap` integer
- `min_volume` integer
- `order` 'premium' | 'call_volume' | 'put_volume' | 'marketcap'
- `order_direction` 'asc' | 'desc'

## Response `200`

A list of stocks matching the filters

- StockScreenerResponse
  - `data` StockEntry[]
    - `ticker` string
    - `close` string
    - `sector` 'Basic Materials' | 'Communication Services' | 'Consumer Cyclical' | 'Consumer Defensive' | 'Energy' | 'Financial Services' | 'Healthcare' | 'Industrials' | 'Real Estate' | 'Technology' | 'Utilities'
    - `call_volume` integer
    - `put_volume` integer
    - `call_premium` string
    - `put_premium` string
    - `week_52_high` string
    - `week_52_low` string
    - `implied_move` string
    - `implied_move_perc` string
    - `total_open_interest` integer
    - `marketcap` string
    - `volatility` string
    - `avg_30_day_call_volume` string
    - `avg_30_day_put_volume` string
    - `iv_rank` string
    - `next_earnings_date` string, date
    - `next_dividend_date` string, date

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