Dati di mercato

Prezzi, performance, profili e liste degli strumenti tracciati nel database locale (azioni, ETF, futures, forex, fondi, indici). Sono le chiamate più frequenti: veloci, lette dal DB, senza routing LLM.

get_stock_price

Cosa fa. Prezzo corrente di un’azione: apertura, massimo, minimo, chiusura, volume e capitalizzazione.

Quando/come lo usa l’AI. Quando chiedi “quanto vale X adesso” o serve un singolo snapshot di prezzo.

Parametri. ticker (simbolo dell’azione).

Restituisce. Snapshot OHLCV + market cap.

Possibili errori / stati.

• Nessun errore esplicito: se il ticker non è tracciato o non ci sono dati nel range, la risposta è vuota. L’agente può allora chiamare add_ticker (o add_crypto/add_future/add_fund/add_forex) e riprovare.

get_stock_prices

Cosa fa. Storico OHLCV su un intervallo di date. Funziona per tutti gli asset del DB: azioni, ETF, futures (GC=F, CL=F, ES=F…), forex (EURUSD=X…), fondi (VFIAX…), indici (^GSPC…).

Quando/come lo usa l’AI. Per serie storiche, trend o dati da grafico su qualunque asset — anche commodity future e forex.

Parametri. ticker, start_date, end_date, interval (day/week/month).

Restituisce. Serie OHLCV nel periodo richiesto.

Possibili errori / stati.

• Nessun errore esplicito: se il ticker non è tracciato o non ci sono dati nel range, la risposta è vuota. L’agente può allora chiamare add_ticker (o add_crypto/add_future/add_fund/add_forex) e riprovare.
• La serie si adatta ai dati disponibili: per asset di recente quotazione, restituisce lo storico esistente (più corto), non un errore.

Nota. Per storico/tecnica di materie prime o forex usa questo, non get_commodity_prices/get_forex_rates (che danno solo lo snapshot corrente).

get_stock_prices_intraday

Cosa fa. Barre intraday recenti (5m, 15m, 30m, 1h) fino a 60 giorni mobili.

Quando/come lo usa l’AI. Analisi di sessione, gap, momentum a breve, conferma di trend orario.

Parametri. ticker, interval, limit.

Restituisce. Barre OHLCV intraday.

Possibili errori / stati.

• Copre solo gli orari di mercato: fuori sessione o oltre la finestra disponibile la risposta è vuota.

get_stock_performance

Cosa fa. Snapshot di performance: variazioni % giornaliere/settimanali/mensili/YTD/annuali, movimenti assoluti, prezzi di riferimento (1d/7d/30d/YTD/1y fa) e ultimo RSI.

Quando/come lo usa l’AI. Quando chiedi le performance o i movimenti % su un periodo. Funziona per azioni, ETF, futures, forex, fondi e indici.

Parametri. ticker.

Restituisce. Variazioni %, prezzi di riferimento, RSI.

Possibili errori / stati.

• Nessun errore esplicito: se il ticker non è tracciato o non ci sono dati nel range, la risposta è vuota. L’agente può allora chiamare add_ticker (o add_crypto/add_future/add_fund/add_forex) e riprovare.

get_company_news

Cosa fa. Ultime notizie su un titolo: titolo, fonte, data e URL.

Quando/come lo usa l’AI. Per aggiornarti o spiegare un movimento recente.

Parametri. ticker (+ giorni/numero opzionali).

Restituisce. Elenco di notizie recenti.

Possibili errori / stati.

• Vuoto se non ci sono notizie recenti per il ticker.

get_company_info

Cosa fa. Profilo dell’azienda dal DB locale: descrizione, settore, industria, Paese, sito ed numero di dipendenti.

Quando/come lo usa l’AI. Quando chiedi cosa fa un’azienda o il suo modello di business. Più veloce della ricerca web.

Parametri. ticker.

Restituisce. Profilo aziendale.

Possibili errori / stati.

• Vuoto per asset senza profilo societario (futures, forex, fondi, indici).

get_dividends

Cosa fa. Storico dei dividendi: data di stacco e importo per pagamento.

Quando/come lo usa l’AI. Analisi di rendimento, costanza e crescita del dividendo, investimento da reddito.

Parametri. ticker.

Restituisce. Pagamenti storici (ex-date, importo).

Possibili errori / stati.

• Vuoto se il titolo non distribuisce dividendi.

get_stock_splits

Cosa fa. Storico dei frazionamenti: data e rapporto (es. 2.0 per uno split 2:1, 0.5 per un reverse).

Quando/come lo usa l’AI. Per capire la storia del numero di azioni o spiegare discontinuità di prezzo.

Parametri. ticker.

Restituisce. Record di split.

Possibili errori / stati.

• Vuoto se non ci sono stati frazionamenti.

get_etf_profile

Cosa fa. Profilo di un ETF: famiglia, categoria, AUM, expense ratio, dividend yield, rendimenti (YTD, 3Y, 5Y).

Quando/come lo usa l’AI. Quando analizzi o confronti ETF, o chiedi costi/AUM/rendimenti.

Parametri. ticker.

Restituisce. Profilo dell’ETF.

Possibili errori / stati.

• Nessun errore esplicito: se il ticker non è tracciato o non ci sono dati nel range, la risposta è vuota. L’agente può allora chiamare add_ticker (o add_crypto/add_future/add_fund/add_forex) e riprovare.

get_all_etfs

Cosa fa. Elenca tutti gli ETF del database con profilo completo (AUM, expense ratio, rendimenti, categoria).

Quando/come lo usa l’AI. Da usare per primo per screening o scoperta di ETF.

Parametri. Nessuno (filtri opzionali).

Restituisce. Lista completa degli ETF con dati di profilo.

list_futures

Cosa fa. Elenca i futures tracciati (commodity/bond/financial) con categoria e performance.

Quando/come lo usa l’AI. Da usare per primo per la scoperta di futures.

Parametri. Nessuno.

Restituisce. Lista dei futures.

get_future_profile

Cosa fa. Profilo di un contratto future: categoria, scadenza, sottostante e unità di contratto.

Quando/come lo usa l’AI. Per i dettagli di un future specifico (es. GC=F, CL=F).

Parametri. ticker (deve finire in =F).

Restituisce. Profilo del contratto.

list_funds

Cosa fa. Elenca i fondi comuni tracciati con AUM, expense ratio, NAV e rendimenti.

Quando/come lo usa l’AI. Da usare per primo per la scoperta di fondi.

Parametri. Nessuno.

Restituisce. Lista dei fondi.

get_fund_profile

Cosa fa. Profilo di un fondo: famiglia, categoria, AUM, expense ratio, NAV, gestore, investimento minimo, rendimenti 1Y/3Y/5Y.

Quando/come lo usa l’AI. Per l’analisi o il confronto costi di un fondo.

Parametri. ticker (es. VFIAX, FXAIX).

Restituisce. Profilo del fondo.

list_forex_assets

Cosa fa. Elenca le coppie forex tracciate con valute base/quota e performance.

Quando/come lo usa l’AI. Per le coppie diverse dai 3 cambi principali.

Parametri. Nessuno.

Restituisce. Lista coppie forex.

Nota. Per i soli cambi principali (DXY/EUR/JPY) preferisci get_forex_rates.

list_indices

Cosa fa. Elenca gli indici di mercato tracciati (S&P 500, NASDAQ, DAX, Nikkei…) con livelli e variazioni %.

Quando/come lo usa l’AI. Per una panoramica degli indici.

Parametri. Nessuno.

Restituisce. Lista indici con livelli e %.