Screening e ticker

Filtra i mercati per criteri o profilo di rischio, risolvi nomi in ticker e aggiungi nuovi strumenti al monitoraggio.

stock_screener

Cosa fa. Screening di azioni per criteri finanziari (P/E, crescita, margini…). Interpreta criteri in linguaggio naturale (routing LLM).

Quando/come lo usa l’AI. Quando descrivi a parole cosa cerchi tra le azioni.

Parametri. Criteri in linguaggio naturale.

Restituisce. Azioni che soddisfano i criteri.

Possibili errori / stati.

Failed to parse screening criteria — criteri non interpretabili.
Failed to fetch screener metrics — errore nel recupero delle metriche.

preset_screener

Cosa fa. Screening di azioni per profilo di rischio (low/mid/high) con filtri pre-costruiti. Istantaneo, senza routing LLM.

Quando/come lo usa l’AI. Per liste pronte per profilo.

Parametri. profile (low/mid/high), numero.

Restituisce. Azioni filtrate per profilo.

Possibili errori / stati.

Unknown profile: … Use 'low', 'mid', or 'high'.
Preset screener request failed — errore lato server.

preset_etf_screener

Cosa fa. Screening di ETF per profilo di rischio (low/mid/high) con filtri matematici. Deterministico.

Quando/come lo usa l’AI. Per liste pronte di ETF per profilo.

Parametri. profile, numero.

Restituisce. ETF filtrati per profilo.

Possibili errori / stati.

Failed to fetch ETF profiles — errore nel recupero dei profili.

list_database_tickers

Cosa fa. Elenca le azioni nel database con settore, capitalizzazione e prezzo. Supporta filtri per settore e fascia di market cap.

Quando/come lo usa l’AI. Per esplorare l’universo monitorato o filtrare per settore/dimensione.

Parametri. Filtri opzionali (settore, market cap).

Restituisce. Lista di azioni con metadati.

Possibili errori / stati.

Failed to list database tickers — errore lato DB.

get_available_stock_tickers

Cosa fa. Restituisce l’elenco di tutti i ticker azionari disponibili nel database.

Quando/come lo usa l’AI. Per sapere quali simboli sono utilizzabili con gli altri tool.

Parametri. Nessuno.

Restituisce. Lista dei ticker disponibili.

resolve_ticker

Cosa fa. Risolve un nome di società o un ticker ambiguo nel simbolo corretto (es. “TeamViewer” → “TMV.DE”).

Quando/come lo usa l’AI. Quando fornisci un nome anziché un ticker, o il ticker è ambiguo.

Parametri. Nome o ticker.

Restituisce. Il simbolo corretto.

add_ticker

Cosa fa. Aggiunge un’azione alla lista di monitoraggio e attende la sincronizzazione dei dati (fino a 60s).

Quando/come lo usa l’AI. Quando i tool finance restituiscono dati vuoti per un ticker che dovrebbe esistere.

Parametri. ticker.

Restituisce. Stato della sincronizzazione.

Possibili errori / stati.

already_ready — già presente e con dati pronti.
sync_complete — sync completata, dati disponibili.
sync_in_progress — in sincronizzazione: riprova tra poco.
sync_error — sync fallita: prova a rimuovere e riaggiungere il ticker.
Failed to add … — verifica/aggiunta fallita.

add_future

Cosa fa. Aggiunge un contratto future al monitoraggio (ticker che termina con =F, es. GC=F, CL=F, ES=F).

Quando/come lo usa l’AI. Quando un future non è ancora tracciato.

Parametri. ticker (…=F).

Restituisce. Stato della sincronizzazione.

Possibili errori / stati.

Stati already_tracked/sync_complete/sync_in_progress/sync_error.
Failed to add future "…".

add_fund

Cosa fa. Aggiunge un fondo comune al monitoraggio (es. VFIAX, FXAIX). Il worker fa il backfill in modo asincrono.

Quando/come lo usa l’AI. Quando un fondo non è ancora tracciato.

Parametri. ticker.

Restituisce. Stato della sincronizzazione.

Possibili errori / stati.

Stati already_tracked/sync_complete/sync_in_progress/sync_error.
Failed to add fund "…".

add_forex

Cosa fa. Aggiunge una coppia forex al monitoraggio (formato XXXYYY=X, es. EURUSD=X, GBPUSD=X).

Quando/come lo usa l’AI. Quando una coppia forex non è ancora tracciata.

Parametri. ticker (…=X).

Restituisce. Stato della sincronizzazione.

Possibili errori / stati.

Stati already_tracked/sync_complete/sync_in_progress/sync_error.
Failed to add forex pair "…".