Portafoglio

Leggi e modifica il portafoglio dell’utente: posizioni, strategia, limiti di rischio e regole.

portfolio_get

Cosa fa. Legge il portafoglio dell’utente: posizioni, strategia, limiti di rischio e regole.

Quando/come lo usa l’AI. All’inizio di molte analisi, per contestualizzare rispetto alle posizioni possedute.

Parametri. Nessuno.

Restituisce. Portafoglio completo.

Possibili errori / stati.

• _error: Failed to read portfolio — errore in lettura (restituisce comunque un portafoglio vuoto).

portfolio_update

Cosa fa. Aggiunge/aggiorna/rimuove posizioni, o modifica strategia e limiti di rischio.

Quando/come lo usa l’AI. Quando registri operazioni o cambi le regole del portafoglio.

Parametri. Azione (add_position/update_position/remove_position/…) + campi.

Restituisce. Portafoglio aggiornato.

Possibili errori / stati.

• No user ID linked to this session… — serve un account Telegram collegato.
• add_position requires ticker, positive quantity, and positive avg_price.
• Cannot sell …: no position in portfolio / Insufficient shares….
• Position "…" not found in portfolio · Quantity/avg_price must be non-negative.