---
title: "Screen Stocks"
method: GET
path: "/api/v1/screener/"
tags: ["screener"]
---

# Screen Stocks

`GET /api/v1/screener/`

Screen stocks by fundamental metrics.

Scans all ~264 traded companies. Use {metric}_gt and {metric}_lt query
params to filter (e.g. ?pl_lt=15&roe_gt=10&dividend_yield_gt=5).

## Query parameters

- `sector` string, nullable — Filter by sector
- `sort` string — Metric to sort by
- `order` string — Sort order: asc or desc
- `limit` integer — Results per page
- `offset` integer — Pagination offset
- `format` string — Response format: json or csv

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/usebolsai/apis/bolsai.md) · [All operations](https://skmtc.net/usebolsai/apis/bolsai/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/usebolsai/bolsai/versions/4ff1922c6a7f/schema)