Non pubblicato — questa pagina è visibile solo in staging e non è sul sito pubblico.

Elenca i filtri dello screener

Q: 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, 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.

Q: 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? La risposta: 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

Q: 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.

Q: 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.

POST/api/v1/research/list_screen_filters

Cerca nel catalogo dei filtri dello screener — quello del motore, letto dal vivo — 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.

Autenticazione: REST: una chiave API o un token di accesso OAuth. MCP: un token di accesso OAuth.
Strumento MCP: list_screen_filters
Costo: una chiamata di ricerca

Parametri

Quali parametri accetta Elenca i filtri dello screener?

querytestoFacoltativo
1–80 caratteri
Parole da cercare, senza distinguere maiuscole e minuscole, nel nome e nella descrizione di ogni filtro.
concepttestoFacoltativo
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.
leveltestoFacoltativo
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.
categorytestoFacoltativo
uno tra fundamental, technical, options, short_selling, ownership, market_and_sector
fundamental, technical, options, short_selling, ownership o market_and_sector.
assetTypetestoFacoltativo
uno tra stocks, etps, crypto
Solo i filtri che si applicano a questo tipo di asset: stocks, etps o crypto.
limitinteroFacoltativoPredefinito 25
da 1 a 200 · unità: un conteggio
Quanti filtri restituire in questa pagina.
offsetinteroFacoltativoPredefinito 0
almeno 0 · unità: un conteggio
Quanti filtri corrispondenti saltare, per leggere la pagina successiva.

Mostra il codice

Richiesta

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}'

import os

import requests

response = requests.post(
    "https://app.fincanva.com/api/v1/research/list_screen_filters",
    headers={"Authorization": f"Bearer {os.environ['FINCANVA_API_KEY']}"},
    json={
        "concept": "value",
        "limit": 2,
    },
)
body = response.json()

const response = await fetch("https://app.fincanva.com/api/v1/research/list_screen_filters", {
  method: "POST",
  headers: { Authorization: `Bearer ${process.env.FINCANVA_API_KEY}`, "Content-Type": "application/json" },
  body: JSON.stringify({
    "concept": "value",
    "limit": 2
  }),
});
const body = await response.json();

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_screen_filters",
    "arguments": {
      "concept": "value",
      "limit": 2
    }
  }
}

Risposta

{
  "status": true,
  "data": {
    "result": {
      "filters": [
        { … },
        …
      ],
      "total": 9,
      "offset": 0,
      "limit": 2
    },
    "summary": "9 filters match the concept value;…",
    "assumed": [
      { … }
    ],
    "dataVersion": null
  }
}

{
  "type": "object",
  "properties": {
    "filters": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "pattern": "^[a-z][a-z0-9]*(?:_[a-z0-9]+)*$"
          },
          "name": {
            "type": "string",
            "minLength": 1
          },
          "level": {
            "type": "string",
            "enum": [
              "asset",
              "sector",
              "market"
            ]
          },
          "category": {
            "type": "string",
            "enum": [
              "fundamental",
              "technical",
              "options",
              "short_selling",
              "ownership",
              "market_and_sector"
            ]
          },
          "subcategory": {
            "anyOf": [
              {
                "type": "string",
                "minLength": 1
              },
              {
                "type": "null"
              }
            ]
          },
          "description": {
            "anyOf": [
              {
                "type": "string",
                "minLength": 1
              },
              {
                "type": "null"
              }
            ]
          },
          "appliesTo": {
            "minItems": 1,
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "stocks",
                "etps",
                "crypto"
              ]
            }
          },
          "inputs": {
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "months_ago",
                "reports_ago",
                "months",
                "days",
                "quarters",
                "bars",
                "std_devs"
              ]
            }
          },
          "relations": {
            "minItems": 1,
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "compare_to_value",
                "between",
                "highest_lowest",
                "compare_to_aggregate",
                "compare_to_own_past",
                "special"
              ]
            }
          },
          "defaultRelation": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "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"
                ]
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "required": [
          "id",
          "name",
          "level",
          "category",
          "subcategory",
          "description",
          "appliesTo",
          "inputs",
          "relations",
          "defaultRelation"
        ],
        "additionalProperties": false
      }
    },
    "total": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "offset": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "filters",
    "total",
    "offset",
    "limit"
  ],
  "additionalProperties": false
}

Risposta

unauthorized

{
  "type": "object",
  "required": [
    "status",
    "message",
    "code"
  ],
  "properties": {
    "status": {
      "const": false
    },
    "message": {
      "type": "string",
      "description": "Written for an AI or a developer to act on."
    },
    "code": {
      "type": "string",
      "enum": [
        "unauthorized"
      ]
    },
    "details": {
      "description": "What the code needs to be acted on, such as the fields of an invalid input."
    }
  }
}

Risposta

plan_limit

{
  "type": "object",
  "required": [
    "status",
    "message",
    "code"
  ],
  "properties": {
    "status": {
      "const": false
    },
    "message": {
      "type": "string",
      "description": "Written for an AI or a developer to act on."
    },
    "code": {
      "type": "string",
      "enum": [
        "plan_limit"
      ]
    },
    "details": {
      "description": "What the code needs to be acted on, such as the fields of an invalid input."
    }
  }
}

Risposta

invalid_input

{
  "type": "object",
  "required": [
    "status",
    "message",
    "code"
  ],
  "properties": {
    "status": {
      "const": false
    },
    "message": {
      "type": "string",
      "description": "Written for an AI or a developer to act on."
    },
    "code": {
      "type": "string",
      "enum": [
        "invalid_input"
      ]
    },
    "details": {
      "description": "What the code needs to be acted on, such as the fields of an invalid input."
    }
  }
}

Risposta

quota_exhausted · rate_limited

{
  "type": "object",
  "required": [
    "status",
    "message",
    "code"
  ],
  "properties": {
    "status": {
      "const": false
    },
    "message": {
      "type": "string",
      "description": "Written for an AI or a developer to act on."
    },
    "code": {
      "type": "string",
      "enum": [
        "quota_exhausted",
        "rate_limited"
      ]
    },
    "details": {
      "description": "What the code needs to be acted on, such as the fields of an invalid input."
    }
  }
}

Risposta

engine_failed

{
  "type": "object",
  "required": [
    "status",
    "message",
    "code"
  ],
  "properties": {
    "status": {
      "const": false
    },
    "message": {
      "type": "string",
      "description": "Written for an AI or a developer to act on."
    },
    "code": {
      "type": "string",
      "enum": [
        "engine_failed"
      ]
    },
    "details": {
      "description": "What the code needs to be acted on, such as the fields of an invalid input."
    }
  }
}

Risposta completa →

Risposta

Che cosa restituisce Elenca i filtri dello screener?

filterselenco
I filtri corrispondenti, nell’ordine del catalogo.
Mostra i 10 campi
- idtesto
  L’id pubblico e stabile del filtro: passalo a describe_screen_filter e alle righe dello screener.
- nametesto
  almeno 1 caratteri
  Il nome del filtro come lo mostra lo screener.
- leveltesto
  uno tra asset, sector, market
  asset, sector o market.
- categorytesto
  uno tra fundamental, technical, options, short_selling, ownership, market_and_sector
  fundamental, technical, options, short_selling, ownership o market_and_sector.
- subcategorytesto
  almeno 1 caratteri · può essere null
  La sottocategoria del catalogo, come Valuation Ratios; null quando il catalogo non ne indica una.
- descriptiontesto
  almeno 1 caratteri · può essere null
  La descrizione del catalogo di che cosa misura il filtro; null quando il catalogo non ne dà una.
- appliesToelenco
  I tipi di asset a cui il filtro si applica.
- inputselenco
  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.
- relationselenco
  I tipi di confronto che il filtro supporta: compare_to_value, between, highest_lowest, compare_to_aggregate, compare_to_own_past, special.
- defaultRelationtesto
  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.
totalintero
almeno 0 · unità: un conteggio
Quanti filtri corrispondono in tutto.
offsetintero
almeno 0 · unità: un conteggio
Quanti filtri corrispondenti sono stati saltati.
limitintero
almeno 1 · unità: un conteggio
Il numero massimo di filtri che questa pagina poteva contenere.

Ogni risposta arriva dentro la struttura del risultato comune a tutte le operazioni.

Errori

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. Riprova tra un minuto.

Comuni a tutte le operazioni

unauthorized HTTP 401
plan_limit HTTP 403
invalid_input HTTP 422
quota_exhausted HTTP 429
rate_limited HTTP 429

Tutti i codici di errore

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.

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

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

I primi due filtri value

Quali filtri posso usare per trovare azioni a buon mercato?

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

Risposta completa · 200

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

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 piani includono Elenca i filtri dello screener?

Famiglia: Screening · Costo in quota: una chiamata di ricerca — Disponibilità

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

DOCS · EN — IT