Documentazione

Motore di Rischio & Riferimento Webhook

Come AlgoVesta verifica ogni segnale prima dell'esecuzione e il payload JSON esatto da inviare da TradingView o da qualsiasi sorgente webhook. I nomi dei campi sono letterali — copiali così come sono.

AlgoVesta esegue trade da tre canali di attivazione: un server MCP per gli assistenti AI, i segnali Telegram e i webhook TradingView. Qualunque canale si attivi, lo stesso motore di rischio lato server verifica l'ordine prima che raggiunga il tuo exchange o il tuo conto MetaTrader 5. Questa pagina è l'hub di riferimento tecnico per tutti e tre.

Tre modi per attivare un trade

Ogni canale termina nello stesso percorso di esecuzione: verifica, dimensionamento, ordine, quindi stop-loss e take-profit piazzati direttamente sull'exchange. Scegli il canale che corrisponde al tuo modo di lavorare.

Server MCP per assistenti AI

Collega Claude, ChatGPT, Cursor o qualsiasi client compatibile con MCP a venti strumenti di trading nativi tramite un unico collegamento autenticato. Ogni connessione parte con un saldo paper di 5.000 $, e le chiavi live vengono create separatamente con un secondo fattore. L'autenticazione avviene tramite OAuth 2.1 con PKCE (S256) oppure tramite un link segreto per utente.

Canali di segnali Telegram

Indirizza AlgoVesta verso i canali di segnali che già segui. I messaggi vengono analizzati per estrarre simbolo, direzione, entrata, stop-loss e obiettivi, quindi eseguiti sul tuo exchange o inoltrati a MetaTrader 5. I segnali che non possono essere interpretati in modo univoco vengono rifiutati anziché indovinati.

Webhook TradingView

Invia un alert da qualsiasi indicatore, disegno o strategia Pine al tuo URL webhook privato. Il corpo dell'alert deve essere JSON valido nel formato documentato sotto, e la fonte di ogni segnale auto-tradato viene verificata prima che venga aperto un ordine.

Motore di Rischio: come viene verificato un segnale

Un segnale non viene mai eseguito alla cieca. Prima di piazzare un ordine, passa attraverso un livello di verifica multi-modulo che lo confronta con le condizioni di mercato in tempo reale e i limiti che imposti. Se una regola rigida fallisce, il segnale viene rifiutato — non ridimensionato.

Scoring neuraleun punteggio di confidenza 0–100 da un modello.
Volume e order-flowpicchi di volume e squilibrio di scambi aggressivi (VPIN).
Regime di mercatoclassificazione trend vs range vs ritorno alla media.
Funding & liquidazionedinamica del tasso di funding e cluster di liquidazione.
Mappatura dello stop-lossevita di piazzare stop dentro cluster di liquidità noti.
Le tue regole rigidedirezione, orari di sessione, limiti di posizione e drawdown.

L'esatto set di moduli e le soglie evolvono con la messa a punto della piattaforma. Il principio è costante: le tue regole e i limiti di rischio vengono sempre applicati prima che un ordine raggiunga il tuo exchange.

Perdita giornaliera e protezione dal drawdown

Oltre ai controlli per segnale, due protezioni a livello di conto funzionano di continuo.

Limite di perdita giornalieraQuando la tua perdita realizzata del giorno raggiunge il limite impostato — una percentuale del saldo o un importo fisso — AlgoVesta entra in Modalità Sicura e smette di aprire nuove operazioni fino al giorno successivo.
Dimensionamento basato sul drawdownMan mano che il drawdown del conto cresce, la dimensione della posizione viene ridotta automaticamente a stadi (cauto → difensivo → sopravvivenza), così una serie di perdite riduce la tua esposizione invece di aggravarla.

Riferimento del payload webhook

Invia un HTTP POST con corpo JSON al tuo URL webhook AlgoVesta. Da TradingView, incollalo nella casella del messaggio dell'alert. I nomi dei campi devono corrispondere esattamente.

# POST https://api.algovesta.com/webhook/<your-token> { "symbol": "BTCUSDT", "side": "buy", "price": 64250.0, "stop_loss": 63800.0, "take_profit": 65100.0 }
CampoObbligatorioDescrizione
symbolCoppia di trading dell'exchange, es. BTCUSDT.
side / actionDirezione dell'ordine: buy o sell.
priceOpzionalePrezzo di riferimento d'ingresso; ometti per ingresso a mercato.
stop_lossOpzionalePrezzo dello stop-loss. Consigliato su ogni segnale.
take_profitOpzionalePrezzo del take-profit. Obiettivi multipli configurabili nell'app.
marketOpzionaleMercato di destinazione: crypto (predefinito) o forex. Inviato a MetaTrader 5 quando impostato su forex. Mai dedotto dal simbolo.
lotsOpzionaleSolo forex — dimensione della posizione in lotti. Omettilo per utilizzare la modalità lotto/rischio configurata.
leverageOpzionaleSolo crypto — vale il limite del tuo exchange per quel simbolo.
amount_usdOpzionaleSolo crypto — margine, non il nozionale. Nozionale = margine × leva.
risk_percentOpzionaleSolo crypto — % del saldo da rischiare (0,1–50).
quantityOpzionaleSolo crypto — quantità esatta di contratti. qty, size e contracts sono accettati come alias.
take_profitsOpzionaleObiettivi multipli: [{"price":…, "close_pct":…}]. Funzionano anche tp1tp5 con tpN_close.
trailingOpzionale{"trigger_pct":…, "distance_pct":…} — stop dinamico (trailing stop).
breakevenOpzionaletrue o {"trigger_pct":…} — sposta lo stop al livello di ingresso una volta in profitto.

I prefissi dell'exchange vengono rimossi, quindi BINANCE:BTCUSDT funziona come BTCUSDT. Per il campo direzione, direction e type sono accettati come alias di action, e close è un valore valido.

La dimensione della posizione, la leva e il rischio per segnale possono provenire dalla tua dashboard o dal payload — un valore presente nel payload ha priorità. Per questo l'URL del webhook è un segreto: aggiungi una whitelist IP in modo che AlgoVesta esegua automaticamente solo i segnali la cui fonte può essere verificata.

Chiudere una posizione

Invia "action": "close" con il simbolo. L'intera posizione su quel simbolo viene chiusa — le chiusure parziali non sono supportate; se ne richiedi una, l'intera posizione viene chiusa e il pannello lo segnala.

{ "symbol": "BTCUSDT", "action": "close" }

Avvisi di strategia Pine — le uscite sono automatiche

Se crei l'avviso da una strategy() Pine con “Order fills only”, non inviare action da solo: {{strategy.order.action}} restituisce sell anche in caso di uscita, il che aprirebbe una posizione short invece di chiudere. Includi i campi di stato della posizione e AlgoVesta calcolerà per te ingresso, uscita e inversione.

{ "symbol": "{{ticker}}", "action": "{{strategy.order.action}}", "market_position": "{{strategy.market_position}}", "prev_market_position": "{{strategy.prev_market_position}}", "position_size": "{{strategy.position_size}}" }
Posizione dopo l'esecuzioneCosa fa AlgoVesta
flat (or position_size = 0)Chiude la posizione. Non viene aperto alcun ordine inverso.
Opposto dello stato precedenteInversione — chiude prima, poi apre la nuova direzione. Se la chiusura fallisce, non viene aperto nulla.
Stessa direzione di primaTrattato come un ingresso in quella direzione.

Il messaggio deve essere in formato JSON. TradingView invia il corpo dell'avviso come testo semplice quando non è JSON valido — il suo messaggio predefinito (ad es. “BTCUSDT Crossing 1.00”) non contiene alcuna direzione e viene rifiutato. Non indoviniamo mai su testo ambiguo; rifiutare un segnale è più sicuro che aprire un ordine nella direzione sbagliata. Nota anche che TradingView interrompe automaticamente gli avvisi dopo 15 attivazioni in 3 minuti.

Senza codice
Non scrivere il JSON a mano — costruiscilo visivamente

Imposta direzione, take-profit / stop-loss (singolo o multilivello), leva, dimensione della posizione, trailing e breakeven con semplici interruttori. AlgoVesta genera l'esatto messaggio di alert di TradingView — copialo e incollalo nel tuo alert.

Scopri come funziona il builder visuale → Configurazione dell'alert passo passo →

Domande frequenti

Quali canali possono attivare un trade su AlgoVesta?

Tre: il server MCP usato dagli assistenti AI, i canali di segnali Telegram e i webhook TradingView. Un trade può anche essere aperto manualmente dalla tua dashboard. Ogni canale passa per lo stesso percorso di esecuzione e gli stessi controlli di rischio.

Il formato JSON del webhook è obbligatorio per TradingView?

Sì. TradingView invia il corpo dell'alert come testo semplice quando non è JSON valido, e il suo messaggio di alert predefinito non contiene alcuna direzione, quindi viene rifiutato. Usa il formato del payload documentato sopra nella guida di riferimento al payload del webhook, oppure costruiscilo visivamente e incolla il risultato nel tuo alert.

Il motore di rischio si applica anche agli ordini MCP e Telegram?

Sì — gli stessi controlli lato server vengono eseguiti su ogni canale. La tua politica di rischio, il requisito di stop-loss e i tuoi limiti di posizione e drawdown vengono applicati prima che un ordine raggiunga un exchange, sia che l'ordine provenga da un assistente AI, da un segnale Telegram o da un alert TradingView. Nessun prompt o messaggio può allentarli.

Dove trovo il riferimento completo agli strumenti MCP?

La guida di riferimento per sviluppatori MCP documenta tutti i 20 strumenti, i tre scope, l'autenticazione OAuth 2.1 e tramite link segreto, i limiti di frequenza, i codici di errore e i 16 exchange supportati oltre a MetaTrader 5.

Posso fare test senza denaro reale?

Sì. Ogni connessione MCP parte con un saldo paper virtuale di 5.000 $ a prezzi di mercato reali, e sia l'automazione TradingView sia quella Telegram dispongono di una modalità demo che simula l'intero flusso dal segnale all'ordine. Il trading live richiede sempre una chiave o una connessione separata creata esplicitamente.