---
title: "Token screener"
method: POST
path: "/v1/screener"
tags: ["Screener"]
---

# Token screener

`POST /v1/screener`

## Request

- Base URL: `https://api.marketintell.ai`
- URL: `https://api.marketintell.ai/v1/screener`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Screen tokens by fundamental metrics or momentum indicators.

## Request body

- object
  - `mode` 'fundamental' | 'momentum'
  - `min_tvl` number: Minimum TVL filter
  - `max_tvl` number: Maximum TVL filter
  - `min_tvl_growth_1d` number: Minimum 1-day TVL growth %
  - `min_tvl_growth_7d` number: Minimum 7-day TVL growth %
  - `min_fees_24h` number: Minimum 24h fees
  - `category` string: Protocol category filter
  - `tokens` string[]: Token list for momentum mode
  - `limit` integer

## Response `200`

Screener results

- object
  - `success` boolean, required
  - `trending` object[]
    - `symbol` string
    - `name` string
    - `market_cap_rank` integer, nullable
    - `change_24h` number
  - `gainers` object[]
    - `symbol` string
    - `name` string
    - `change_24h` number
  - `losers` object[]
    - `symbol` string
    - `name` string
    - `change_24h` number

## Other responses

- `400`: Invalid request

---

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