---
title: "Screen stocks (FMP screener + revenue + P/E from `fundamentals` table)"
method: GET
path: "/api/research/screener"
tags: ["Research"]
---

# Screen stocks (FMP screener + revenue + P/E from `fundamentals` table)

`GET /api/research/screener`

## Query parameters

- `betaLowerThan` number, nullable
- `betaMoreThan` number, nullable
- `country` string
- `dividendLowerThan` number, nullable
- `dividendMoreThan` number, nullable
- `exchange` string — Ignored — this endpoint always returns NASDAQ and NYSE listings only.
- `industry` string
- `isActivelyTrading` 'true' | 'false' — Filter actively trading names
- `isEtf` 'true' | 'false' — ETF-only filter
- `limit` integer
- `marketCapLowerThan` number, nullable
- `marketCapMoreThan` number, nullable
- `priceLowerThan` number, nullable
- `priceMoreThan` number, nullable
- `sector` string
- `volumeLowerThan` number, nullable
- `volumeMoreThan` number, nullable

## Response `200`

FMP company screener results

- object
  - `count` number, required
  - `results` ScreenerRow[], required
    - `beta` number, nullable
    - `companyName` string, nullable
    - `country` string, nullable
    - `exchange` string, nullable
    - `exchangeShortName` string, nullable
    - `industry` string, nullable
    - `isActivelyTrading` boolean, nullable
    - `isEtf` boolean, nullable
    - `marketCap` number, nullable
    - `peRatio` number, nullable
    - `price` number, nullable
    - `revenue` number, nullable
    - `sector` string, nullable
    - `symbol` string, required
    - `volume` number, nullable

## Other responses

- `401` — Unauthorized
- `422` — Validation failed
- `502` — FMP upstream failed

---

[API](https://skmtc.net/cobaltpf/apis/cobalt-api.md) · [All operations](https://skmtc.net/cobaltpf/apis/cobalt-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cobaltpf/cobalt-api/versions/8ef0dfb5d23c/schema)