Elenca i filtri dello screener

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.
• 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.

• 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?

# 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:

{
  "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.

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.