---
title: "Run a screener (params as query string)"
method: GET
path: "/screeners/{id}/run"
---

# Run a screener (params as query string)

`GET /screeners/{id}/run`

## Request

- Base URL: `https://api.tradermatrix.pro/api/v1`
- URL: `https://api.tradermatrix.pro/api/v1/screeners/{id}/run`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

GET alternative to POST /screeners/{id}/run — same screener, params passed as query string instead of a JSON body. Screener ids include bullish-pullback, momentum, volatility-squeeze, small-cap, volatility-surge, gamma-scan, csp-wheel, leaps, leveraged, daily-cuts, accumulation-watch, stage2-uptrend and momentum-leaders. stage2-uptrend and momentum-leaders: membership list only on the public API (symbol, name, direction, earningsSoon; no prices or market data).

## Path parameters

- `id` string, required

## Response `200`

OK

## Other responses

- `404`: Screener not found
- `429`: Too many screener runs. Screener runs carry their own per-account rate limit on top of the per-key limit. Wait `retryAfter` seconds (also in the RateLimit headers) before retrying.
- `503`: The screener's data source failed, so the run produced no answer. This is an outage, not 'nothing matched' (an empty match is a 200 with an empty results list). Retry shortly.

---

[API](https://skmtc.dev/tradermatrix/apis/tradermatrix-developer-api.md) · [All operations](https://skmtc.dev/tradermatrix/apis/tradermatrix-developer-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tradermatrix/apis/tradermatrix-developer-api/revisions/e5ffa00818c4?raw)