Crypto

Dati di mercato, indicatori, profili e screening per le criptovalute tracciate.

get_crypto_market_data

Cosa fa. Analisi combinata di una crypto: snapshot + RSI/MACD/SMA/EMA + storico giornaliero + intraday.

Quando/come lo usa l’AI. Da usare per primo per qualsiasi analisi di prezzo/trend di una crypto.

Parametri. symbol (es. BTC, ETH, SOL).

Restituisce. Pacchetto completo: snapshot, indicatori, storico.

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_crypto_snapshot

Cosa fa. Snapshot di una crypto: prezzo, OHLCV 24h, variazioni % 24h/7d/30d, market cap e rank, volume, supply.

Quando/come lo usa l’AI. Quando serve solo lo snapshot; per l’analisi completa usa get_crypto_market_data.

Parametri. symbol.

Restituisce. Snapshot di mercato.

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_crypto_prices

Cosa fa. Storico OHLCV di una crypto (intervalli day/week/month/year).

Quando/come lo usa l’AI. Quando serve solo lo storico prezzi.

Parametri. symbol, range, interval.

Restituisce. Serie OHLCV.

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_crypto_prices_intraday

Cosa fa. Barre intraday di una crypto: 1h (fino 60 giorni) o 5m (fino 7 giorni).

Quando/come lo usa l’AI. Per precisione 5m o quando serve solo l’intraday.

Parametri. symbol, interval.

Restituisce. Barre intraday.

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_crypto_technical_indicators

Cosa fa. RSI, MACD, SMA, EMA per una crypto.

Quando/come lo usa l’AI. Quando bastano gli indicatori; con lo storico, preferisci get_crypto_market_data.

Parametri. symbol.

Restituisce. Indicatori tecnici.

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_crypto_metadata

Cosa fa. Profilo completo: descrizione, sito, whitepaper, categorie, social (Twitter/Reddit/Telegram), contratti per chain, algoritmo, proof type, supply, fonte dati.

Quando/come lo usa l’AI. Per il contesto fondamentale/on-chain di una moneta.

Parametri. symbol.

Restituisce. Profilo della crypto.

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.

list_cryptos

Cosa fa. Elenca le crypto tracciate con prezzi, variazioni 24h/7d/30d, top gainer/loser e BTC dominance.

Quando/come lo usa l’AI. Da usare per primo per le domande sul mercato crypto.

Parametri. Nessuno (numero opzionale).

Restituisce. Lista di mercato crypto.

Possibili errori / stati.

• Failed to list cryptocurrencies — errore lato API/DB nel recupero della lista.

preset_crypto_screener

Cosa fa. Screening crypto per profilo di rischio (low/mid/high) con filtri matematici lato server.

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

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

Restituisce. Crypto filtrate per profilo.

Possibili errori / stati.

• Unknown profile — usa low, mid o high.

add_crypto

Cosa fa. Aggiunge una crypto al monitoraggio. Usa il nome completo (“bitcoin”, “octra”), non il ticker.

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

Parametri. query (nome) oppure coingecko_id.

Restituisce. Stato dell’operazione.

Possibili errori / stati.

• not_found — non trovata: riprova con un nome più corto (meno parole) prima di arrenderti.
• candidates — più corrispondenze: scegli e richiama con coingecko_id.
• already_tracked — già presente. added — aggiunta con successo.
• Failed to add "…" — errore generico in aggiunta.