---
title: "Elenca i filtri dello screener"
description: "Elenca i filtri dello screener cerca nel catalogo per nome o per concetto d’investimento e restituisce ogni filtro con il livello, la categoria e le relazioni."
canonical_url: "https://fincanva.com/it/docs/api-e-mcp/elenca-i-filtri-dello-screener"
last_updated: "2026-10-01"
md_url: "https://fincanva.com/it/docs/api-e-mcp/elenca-i-filtri-dello-screener.md"
---

# Elenca i filtri dello screener

Cerca nel catalogo dei filtri dello screener per parole nel nome o nella descrizione di un filtro, per concetto d’investimento (value, momentum, quality e altri), per livello (asset, sector, market), per categoria o per tipo di asset, e restituisce ogni filtro trovato con gli input che accetta e i tipi di confronto che supporta. I risultati arrivano nell’ordine del catalogo, una pagina alla volta.

Id dell’operazione: `list_screen_filters` — REST `POST /api/v1/research/list_screen_filters`, strumento MCP `list_screen_filters`.

## Quando si usa Elenca i filtri dello screener?

- L’utente cerca filtri per un’idea — azioni a buon mercato, momentum, dividendi — o chiede su che cosa può filtrare lo screener.
- Prima di costruire uno screener, per trovare gli id dei filtri da usare.

Usa un’altra operazione quando:

- Conosci già il filtro e ti servono i suoi input, le relazioni e i valori ammessi — usa invece [`describe_screen_filter`](/it/docs/api-e-mcp/descrivi-un-filtro-dello-screener).
- Hai scelto i filtri e vuoi che lo screener venga costruito — usa invece `create_screener`.

## Quali parametri accetta Elenca i filtri dello screener?

- `query` (facoltativo; testo; 1–80 caratteri) — Parole da cercare, senza distinguere maiuscole e minuscole, nel nome e nella descrizione di ogni filtro.
- `concept` (facoltativo; testo; uno tra `value`, `momentum`, `quality`, `dividends`, `volatility`, `size`, `liquidity`, `solvency`, `risk_reward`) — Un concetto d’investimento, associato alle sottocategorie del catalogo: `value` (rapporti di valutazione), `momentum`, `quality` (redditività e margine operativo), `dividends`, `volatility`, `size` (profilo dell’azienda), `liquidity`, `solvency` e `risk_reward`.
- `level` (facoltativo; testo; uno tra `asset`, `sector`, `market`) — `asset` per i filtri sullo strumento stesso, `sector` per l’aggregato del suo settore, `market` per quello dell’intero mercato.
- `category` (facoltativo; testo; uno tra `fundamental`, `technical`, `market_and_sector`) — `fundamental`, `technical` o `market_and_sector`.
- `assetType` (facoltativo; testo; uno tra `stocks`, `etps`, `crypto`) — Solo i filtri che si applicano a questo tipo di asset: `stocks`, `etps` o `crypto`.
- `limit` (facoltativo; intero; da `1` a `200`; predefinito `25`; unità: un conteggio) — Quanti filtri restituire in questa pagina.
- `offset` (facoltativo; intero; almeno `0`; predefinito `0`; unità: un conteggio) — Quanti filtri corrispondenti saltare, per leggere la pagina successiva.

## Che cosa restituisce Elenca i filtri dello screener?

L’oggetto `result` contiene i campi qui sotto. Ogni risultato riporta anche un `summary` testuale, i valori `assumed` e la `dataVersion`, come descrive [il riferimento](/it/docs/api-e-mcp/riferimento-dell-open-api-e-del-server-mcp-di-fincanva).

- `filters` (elenco) — I filtri corrispondenti, nell’ordine del catalogo.
- `filters[].id` (testo) — L’id pubblico e stabile del filtro: passalo a describe_screen_filter e alle righe dello screener.
- `filters[].name` (testo; almeno 1 caratteri) — Il nome del filtro come lo mostra lo screener.
- `filters[].level` (testo; uno tra `asset`, `sector`, `market`) — `asset`, `sector` o `market`.
- `filters[].category` (testo; uno tra `fundamental`, `technical`, `market_and_sector`) — `fundamental`, `technical` o `market_and_sector`.
- `filters[].subcategory` (testo; almeno 1 caratteri) — La sottocategoria del catalogo, come Valuation Ratios.
- `filters[].description` (testo; almeno 1 caratteri) — La descrizione del catalogo di che cosa misura il filtro.
- `filters[].appliesTo` (elenco) — I tipi di asset a cui il filtro si applica.
- `filters[].inputs` (elenco) — Gli input che il filtro accetta, per id di input: quanti mesi o bilanci prima viene letto il suo valore, o la finestra su cui è misurato.
- `filters[].relations` (elenco) — I tipi di confronto che il filtro supporta: `compare_to_value`, `between`, `highest_lowest`, `compare_to_aggregate`, `compare_to_own_past`, `special`.
- `filters[].defaultRelation` (testo; uno tra `greater_than`, `less_than`, `greater_or_equal`, `less_or_equal`, `between`, `highest`, `lowest`, `equal`, `price_above`, `price_below`, `crossing_above_within_days`, `crossing_below_within_days`, `strongly_overvalued`, `overvalued`, `in_range`, `undervalued`, `strongly_undervalued`, `fast_bull_crossover_within_days`, `fast_bear_crossover_within_days`, `slow_bull_crossover_within_days`, `slow_bear_crossover_within_days`, `fast_over_slow_bull_crossover_within_days`, `fast_over_slow_bear_crossover_within_days`) — La relazione che lo screener propone per prima per questo filtro.
- `total` (intero; almeno `0`; unità: un conteggio) — Quanti filtri corrispondono in tutto.
- `offset` (intero; almeno `0`; unità: un conteggio) — Quanti filtri corrispondenti sono stati saltati.
- `limit` (intero; almeno `1`; unità: un conteggio) — Il numero massimo di filtri che questa pagina poteva contenere.

## Com’è fatta una chiamata a Elenca i filtri dello screener?

### I primi due filtri value

Domanda: Quali filtri posso usare per trovare azioni a buon mercato?

```http
# Chiamante con il piano free
POST /api/v1/research/list_screen_filters
Authorization: Bearer <chiave API o token di accesso>
Content-Type: application/json

{
  "concept": "value",
  "limit": 2
}
```

Il risultato:

```json
{
  "filters": [
    {
      "id": "p_e_positive",
      "name": "P/E (Positive)",
      "level": "asset",
      "category": "fundamental",
      "subcategory": "Valuation Ratios",
      "description": "The Price to Earnings ratio indicates the dollar amount an investor can expect to invest in a company in order to receive $1 of that company’s earnings. Low P/E indicate that the current stock price is low relative to earnings. Negative P/E values are discarded to avoid problems when screening for low P/E values.",
      "appliesTo": [
        "stocks"
      ],
      "inputs": [
        "months_ago"
      ],
      "relations": [
        "compare_to_value",
        "between",
        "highest_lowest",
        "compare_to_aggregate"
      ],
      "defaultRelation": "less_than"
    },
    {
      "id": "p_e",
      "name": "P/E",
      "level": "asset",
      "category": "fundamental",
      "subcategory": "Valuation Ratios",
      "description": "The Price to Earnings ratio indicates the dollar amount an investor can expect to invest in a company in order to receive $1 of that company’s earnings.",
      "appliesTo": [
        "stocks"
      ],
      "inputs": [
        "months_ago"
      ],
      "relations": [
        "compare_to_value",
        "between",
        "highest_lowest",
        "compare_to_aggregate",
        "compare_to_own_past"
      ],
      "defaultRelation": "between"
    }
  ],
  "total": 9,
  "offset": 0,
  "limit": 2
}
```

Il riepilogo restituito:

> 9 filters match the concept value; showing the first 2: P/E (Positive) and P/E.

I valori assunti perché la richiesta non li indicava:

- `/offset` = `0` — no offset was given, so the list starts at the first match

## Dove si sbaglia più spesso con Elenca i filtri dello screener?

- Le righe di uno screener si applicano in ordine, quindi una riga highest o lowest N classifica solo ciò che le righe precedenti hanno lasciato passare.
- Un filtro che vale solo per le azioni — come la maggior parte dei filtri fondamentali — non seleziona nulla in un universo di ETP o di crypto.
- `total` conta ogni corrispondenza; scorrile con `offset` invece di alzare `limit` oltre ciò che ti serve.

## Quali codici di errore restituisce Elenca i filtri dello screener?

Elenca i filtri dello screener non ha codici di errore propri oltre a quelli comuni.

Ogni operazione può restituire anche i codici di errore comuni elencati nel [riferimento](/it/docs/api-e-mcp/riferimento-dell-open-api-e-del-server-mcp-di-fincanva#quali-codici-di-errore-può-restituire-unoperazione-di-fincanva).

## Quali piani includono Elenca i filtri dello screener?

Elenca i filtri dello screener appartiene alla famiglia di operazioni «Screening» e conta come una chiamata di ricerca nella quota mensile del tuo piano. Quali famiglie include il tuo piano, e quanto sono ampie le sue quote, lo trovi in [Cosa include ciascun piano](/it/docs/account-e-sicurezza/cosa-include-ciascun-piano).

Fincanva ha uno scopo solo educativo e illustrativo: non è una consulenza finanziaria personalizzata, e i risultati passati o simulati non indicano quelli futuri. [Leggi l'Addendum ai Termini](https://fincanva.com/it/terms/addendum#section-3)