AlgoVesta › Glossário › Webhook

Sinal & Automação

Webhook

Um webhook é uma requisição HTTP automatizada que um aplicativo envia para uma URL em outro aplicativo no momento em que um evento acontece; em negociação, o TradingView envia um webhook para uma plataforma de automação quando um alerta de estratégia ou indicador é disparado, para que a ordem possa ser colocada sem que ninguém precise clicar em um botão.

Por que isso importa

Alertas por e-mail, notificação de aplicativo ou som ainda precisam de uma pessoa para agir sobre eles. Um webhook leva o corpo da mensagem do alerta diretamente até a plataforma de execução, o que é o que transforma uma estratégia do TradingView em uma automatizada. O corpo da mensagem está sob seu controle: pode ser um texto fixo como "BTCUSDT LONG" ou um payload JSON com marcadores de posição que o TradingView preenche no momento do alerta (símbolo, preço, ação, tamanho da posição). A plataforma do lado receptor interpreta esse corpo, verifica contra suas regras e coloca a operação.

Como a AlgoVesta lida com isso

Cada estratégia da AlgoVesta recebe sua própria URL de webhook contendo um token secreto; você a cola no campo "Webhook URL" do alerta do TradingView e coloca o modelo JSON do painel na caixa de mensagem. As requisições recebidas são aceitas para execução ao vivo apenas quando a fonte pode ser verificada, seja porque a requisição vem dos endereços IP publicados do TradingView, seja de um IP que você colocou na lista de permissões; qualquer outra coisa é registrada, mas não negociada. O payload é interpretado em símbolo, lado, indicação de entrada, stop-loss e take-profit, e então roteado para o destino que você escolheu para aquela estratégia: uma conta de exchange de cripto ou uma conta MetaTrader 5. Saídas de estratégia ("flat") fecham a posição aberta em vez de abrir o lado oposto, e a mesma lógica roda em modo paper para que você possa testar o alerta de ponta a ponta antes de ir ao vivo. Um sinal é recebido e interpretado em bem menos de 100 ms; em média, de ponta a ponta, a ordem chega ao local de negociação em cerca de 4,1 segundos em exchanges de cripto e cerca de 1,2 segundos no MT5. As etapas de configuração estão na página bot do TradingView e no guia de configuração de webhook.

Exemplo

Mensagem de alerta: {"symbol":"{{ticker}}","side":"buy","price":{{close}},"stop_loss":{{plot_0}},"take_profit":{{plot_1}}}. Quando a estratégia dispara no gráfico de ETHUSDT, o TradingView substitui os marcadores de posição e publica o JSON na URL da estratégia. A AlgoVesta abre a posição comprada com a margem configurada de $100, coloca o stop e o alvo a partir dos dois plots, e mostra a operação no painel em segundos.

Erros comuns

Na prática

Bot para TradingView →