# Equity Screener

`GET /v1/screener`

Filter the US-equity universe by valuation, size, growth, quality.

Screen ~5–8k US equities. Numeric filters use a <field>_<op> convention where op is one of gt, gte, lt, lte — e.g. marketCap_gt=1000&pe_lt=20&ebitdaMargin_gte=0.2. Text filters (sector, exchange) are case-insensitive contains. Supports paging and sort.

Authentication: `Authorization: Bearer <API key>`. As-reported SEC fundamentals, quotes, valuation and screener.

## Query parameters

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `marketCap_gt` | number | no | — | Market cap greater than (USD millions). Any numeric field supports _gt/_gte/_lt/_lte. |
| `pe_lt` | number | no | — | Trailing P/E less than. |
| `ebitdaMargin_gte` | number | no | — | EBITDA margin at least (decimal, 0.2 = 20%). |
| `sector` | string | no | — | SIC sector description contains (case-insensitive). |
| `exchange` | string | no | — | Exchange contains (e.g. NASDAQ). |
| `sort` | string | no | `marketCap` | Numeric field to sort by. |
| `order` | string (asc \\| desc) | no | `desc` | Sort direction. |
| `limit` | integer | no | `50` | Page size (max 500). |
| `offset` | integer | no | `0` | Rows to skip (pagination). |

## Request

```bash
curl "https://app.akyla.ai/v1/screener" \
  -H "Authorization: Bearer $AKYLA_API_KEY"
```

## Response

`200 OK` · `application/json`

| Attribute | Type | Description |
| --- | --- | --- |
| `data.results[]` | object[] | Matching rows (ticker, name, sector, price, marketCap, pe, ps, evEbitda, revenue, ebitda, margins, growth, debt, …). |
| `data.count` | integer | Rows returned on this page. |
| `data.total` | integer | Total rows matching the filters. |
| `data.limit / offset` | integer | Echoed paging params. |

## Example response

```json
{
  "data": {
    "results": [
      {
        "ticker": "NVDA",
        "name": "NVIDIA Corp.",
        "sector": "Semiconductors",
        "exchange": "XNAS",
        "price": 178.4,
        "marketCap": 4350000,
        "pe": 48.1,
        "ps": 28.2,
        "evEbitda": 41,
        "revenue": 154200,
        "ebitda": 106000,
        "ebitdaMargin": 0.687,
        "revenueGrowth": 0.62
      }
    ],
    "count": 1,
    "total": 312,
    "limit": 25,
    "offset": 0
  },
  "meta": {
    "source": "SEC XBRL + market data",
    "api_version": "v1",
    "generated_at": "2026-06-27T15:24:00.000Z"
  }
}
```

Part of the Financial Data API — full reference: https://app.akyla.ai/docs (Markdown: https://app.akyla.ai/docs.md).