Motor de Risco e Referência de Webhook
Como a AlgoVesta verifica cada sinal antes da execução, e o payload JSON exato para enviar do TradingView ou qualquer fonte webhook. Os nomes dos campos são literais — copie-os como estão.
A AlgoVesta executa operações a partir de três canais de acionamento: um servidor MCP para assistentes de IA, sinais do Telegram e webhooks do TradingView. Seja qual for o canal acionado, o mesmo mecanismo de risco do lado do servidor verifica a ordem antes que ela chegue à sua exchange ou conta MetaTrader 5. Esta página é o hub de referência técnica para os três.
Três formas de acionar uma operação
Todos os canais terminam no mesmo caminho de execução: verificação, dimensionamento, ordem e, em seguida, stop-loss e take-profit colocados diretamente na corretora. Escolha o canal que combina com a forma como você já trabalha.
Servidor MCP para assistentes de IA
Conecte o Claude, o ChatGPT, o Cursor ou qualquer cliente compatível com MCP a vinte ferramentas de negociação nativas por meio de um único link autenticado. Toda conexão começa com um saldo simulado de $5,000, e as chaves ao vivo são criadas separadamente com um segundo fator. A autenticação é feita via OAuth 2.1 com PKCE (S256) ou por um link secreto por usuário.
Canais de sinais do Telegram
Aponte a AlgoVesta para os canais de sinais que você já acompanha. As mensagens são interpretadas em símbolo, direção, entrada, stop-loss e alvos, e então executadas na sua exchange ou encaminhadas ao MetaTrader 5. Sinais que não podem ser interpretados sem ambiguidade são rejeitados em vez de adivinhados.
Webhooks do TradingView
Envie um alerta de qualquer indicador, desenho ou estratégia Pine para a sua URL de webhook privada. O corpo do alerta deve ser um JSON válido no formato documentado abaixo, e a origem de cada sinal negociado automaticamente é verificada antes de uma ordem ser aberta.
Motor de Risco: como um sinal é verificado
Um sinal nunca é executado às cegas. Antes de qualquer ordem, ele passa por uma camada de verificação multimódulo que o confronta com as condições de mercado ao vivo e os limites que você define. Se uma regra rígida falhar, o sinal é rejeitado — não reduzido.
O conjunto exato de módulos e limiares evolui conforme a plataforma é ajustada. O princípio é constante: suas regras e limites de risco são sempre aplicados antes de uma ordem chegar à sua corretora.
Perda diária e proteção de drawdown
Além das verificações por sinal, duas salvaguardas de nível de conta funcionam continuamente.
Referência do payload webhook
Envie um HTTP POST com corpo JSON para sua URL de webhook da AlgoVesta. No TradingView, cole isto na caixa de mensagem do alerta. Os nomes dos campos devem corresponder exatamente.
| Campo | Obrigatório | Descrição |
|---|---|---|
symbol | Sim | Par de negociação da exchange, ex. BTCUSDT. |
side / action | Sim | Direção da ordem: buy ou sell. |
price | Opcional | Preço de referência de entrada; omita para entrada a mercado. |
stop_loss | Opcional | Preço de stop-loss. Recomendado em cada sinal. |
take_profit | Opcional | Preço de take-profit. Múltiplos alvos configuráveis no app. |
market | Opcional | Mercado-alvo: crypto (padrão) ou forex. Enviado ao MetaTrader 5 quando definido como forex. Nunca é inferido a partir do símbolo. |
lots | Opcional | Apenas forex — tamanho da posição em lotes. Deixe em branco para usar seu modo de lote/risco configurado. |
leverage | Opcional | Apenas crypto — vale o limite da sua corretora para aquele símbolo. |
amount_usd | Opcional | Apenas crypto — margem, não o valor nocional. Nocional = margem × alavancagem. |
risk_percent | Opcional | Apenas crypto — % do saldo a arriscar (0,1–50). |
quantity | Opcional | Apenas crypto — quantidade exata de contratos. qty, size e contracts são aceitos como apelidos (aliases). |
take_profits | Opcional | Múltiplos alvos: [{"price":…, "close_pct":…}]. tp1…tp5 com tpN_close também funciona. |
trailing | Opcional | {"trigger_pct":…, "distance_pct":…} — stop móvel (trailing stop). |
breakeven | Opcional | true ou {"trigger_pct":…} — move o stop para o preço de entrada assim que estiver no lucro. |
Prefixos de corretora são removidos, então BINANCE:BTCUSDT funciona igual a BTCUSDT. No campo de direção, direction e type são aceitos como apelidos de action, e close é um valor válido.
O tamanho da posição, a alavancagem e o risco por sinal podem vir do seu painel ou do payload — um valor no payload tem prioridade. É por isso que a URL do webhook é um segredo: adicione uma lista de permissões de IP para que a AlgoVesta só negocie automaticamente sinais cuja origem consiga verificar.
Fechando uma posição
Envie "action": "close" junto com o símbolo. A posição inteira nesse símbolo é fechada — fechamentos parciais não são suportados; se você solicitar um, a posição inteira é fechada e o painel informa isso.
Alertas de estratégia Pine — as saídas são automáticas
Se você criar o alerta a partir de uma strategy() Pine com “Order fills only”, não envie action sozinho: {{strategy.order.action}} também retorna sell em uma saída, o que abriria uma posição vendida em vez de fechar. Inclua os campos de estado da posição e a AlgoVesta calcula a entrada, a saída e a reversão para você.
| Posição após a execução | O que a AlgoVesta faz |
|---|---|
flat (or position_size = 0) | Fecha a posição. Nenhuma ordem reversa é aberta. |
| Oposto ao estado anterior | Reversão — fecha primeiro, depois abre a nova direção. Se o fechamento falhar, nada é aberto. |
| Mesma direção de antes | Tratado como uma entrada nessa direção. |
A mensagem deve ser JSON. O TradingView envia o corpo do alerta como texto simples quando não é um JSON válido — sua mensagem padrão (por ex., “BTCUSDT Crossing 1.00”) não carrega direção e é rejeitada. Nunca adivinhamos com base em texto ambíguo; rejeitar um sinal é mais seguro do que abrir uma ordem na direção errada. Observe também que o TradingView interrompe os alertas automaticamente após 15 disparos em 3 minutos.
Defina direção, take-profit / stop-loss (único ou multinível), alavancagem, tamanho de posição, trailing e breakeven com botões simples. A AlgoVesta gera a mensagem de alerta exata do TradingView — copie e cole no seu alerta.
Veja como funciona o construtor visual → Configuração de alerta passo a passo →Perguntas frequentes
Três: o servidor MCP usado por assistentes de IA, os canais de sinais do Telegram e os webhooks do TradingView. Uma operação também pode ser aberta manualmente pelo seu painel. Todos os canais seguem o mesmo caminho de execução e as mesmas verificações de risco.
Sim. O TradingView envia o corpo do alerta como texto simples quando ele não é um JSON válido, e a mensagem de alerta padrão não indica direção, por isso é rejeitada. Use o formato de payload documentado na referência de payload do webhook acima, ou monte-o visualmente e cole o resultado no seu alerta.
Sim — as mesmas verificações do lado do servidor são executadas em todos os canais. Sua política de risco, a exigência de stop-loss e seus limites de posição e drawdown são aplicados antes que uma ordem chegue a uma corretora, seja essa ordem originada de um assistente de IA, de um sinal do Telegram ou de um alerta do TradingView. Nenhum prompt ou mensagem pode afrouxá-los.
A referência para desenvolvedores do MCP documenta as 20 ferramentas, os três escopos, a autenticação por OAuth 2.1 e link secreto, os limites de taxa, os códigos de erro e as 16 exchanges suportadas, além do MetaTrader 5.
Sim. Toda conexão MCP começa com um saldo simulado (paper) de $5,000 com preços reais de mercado, e as automações do TradingView e do Telegram também têm um modo demo que simula todo o fluxo do sinal até a ordem. A negociação ao vivo sempre exige uma chave ou conexão separada, criada explicitamente.