--- 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/sviluppatori/riferimento/list-screen-filters" last_updated: "2026-10-05" md_url: "https://fincanva.com/it/sviluppatori/riferimento/list-screen-filters.md" --- # Elenca i filtri dello screener Cerca nel [catalogo dei filtri](/it/glossario/tassonomia-dei-filtri) dello [screener](/it/glossario/screener) — quello del motore, letto dal vivo — per parole nel nome o nella descrizione di un [filtro](/it/glossario/filtro), per concetto d’investimento (value, momentum, quality e altri), per livello (asset, sector, market), per categoria o per [tipo di asset](/it/glossario/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/sviluppatori/riferimento/describe-screen-filter). - 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](/it/glossario/strumento) stesso, `sector` per l’aggregato del suo settore, `market` per quello dell’intero mercato. - `category` (facoltativo; testo; uno tra `fundamental`, `technical`, `options`, `short_selling`, `ownership`, `market_and_sector`) — `fundamental`, `technical`, `options`, `short_selling`, `ownership` 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`; unità: un conteggio; predefinito `25`) — Quanti filtri restituire in questa pagina. - `offset` (facoltativo; intero; almeno `0`; unità: un conteggio; predefinito `0`) — 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 [la struttura del risultato](/it/sviluppatori/concetti/la-struttura-del-risultato). - `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`, `options`, `short_selling`, `ownership`, `market_and_sector`) — `fundamental`, `technical`, `options`, `short_selling`, `ownership` o `market_and_sector`. - `filters[].subcategory` (testo; almeno 1 caratteri; può essere null) — La sottocategoria del catalogo, come Valuation Ratios; null quando il catalogo non ne indica una. - `filters[].description` (testo; almeno 1 caratteri; può essere null) — La descrizione del catalogo di che cosa misura il filtro; null quando il catalogo non ne dà una. - `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`; può essere null) — La relazione che lo screener propone per prima per questo filtro; null quando il catalogo non ne propone una. - `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? ```bash # Chiamante con il piano free curl -X POST https://app.fincanva.com/api/v1/research/list_screen_filters \ -H "Authorization: Bearer $FINCANVA_API_KEY" \ -H "Content-Type: application/json" \ -d '{"concept":"value","limit":2}' ``` La risposta: ```json { "status": true, "data": { "result": { "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 }, "summary": "9 filters match the concept value; showing the first 2: P/E (Positive) and P/E.", "assumed": [ { "field": "/offset", "value": 0, "reason": "no offset was given, so the list starts at the first match" } ], "dataVersion": null } } ``` 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](/it/glossario/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? - `engine_failed` (HTTP 502) — Fincanva non è riuscito a leggere dal suo motore il catalogo dei filtri dello screener, e non ne aveva uno da prima. Soluzione: Riprova tra un minuto. Ogni operazione può restituire anche i codici di errore comuni elencati in [Errori](/it/sviluppatori/open-api/gli-errori-dell-open-api-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 piani includono il server MCP e l’Open API, e quanto sono ampie le loro quote, lo trovi in [Piani, quote e limiti](/it/sviluppatori/primi-passi/piani-quote-e-limiti). 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)