# Scan

A universe-wide query: send a SQL `WHERE` clause, get every ticker that matches.

- **Market-wide scan (live)** — `POST /v2/scan`
- **Market-wide scan (as-of)** — `POST /v2/scan` (with `asof`)
- **Subscribe (webhook)** — `POST /v2/scan/subscribe`

## Three tenses, one clause

Send `q` in a JSON body and the server returns every ticker matching right now. Add `asof` — a `YYYY-MM-DD` date for that day's close, or a full ISO timestamp for any intraday moment — and the same clause evaluates against the past, with the serving tier reported in `_meta.interval`. Subscribe that clause as a [webhook](/docs/endpoints/webhooks/create) and we push you each time a new ticker enters the match set.

`universe` is a scoping shortcut on every form. The live and as-of endpoints also accept GET with parameters in the query string — handy for short queries and interactive testing.