Webhook do TradingView → corretora: automação ponta a ponta.

Você desenhou uma estratégia em Pine Script e quer que ela opere sozinha. Mas o TradingView não executa ordens na sua corretora diretamente (salvo integrações nativas). A ponte é o webhook: o alerta dispara, manda uma mensagem pra um servidor seu, e esse servidor executa a ordem via API da corretora. Este guia monta esse pipeline inteiro — e é honesto sobre onde ele pode falhar.

01A arquitetura ponta a ponta

São quatro elos. Entender o fluxo é essencial antes de escrever uma linha:

02Passo 1: o alerta no TradingView

No seu Pine Script, você usa alert() com uma mensagem em JSON (pra o servidor interpretar). Depois, ao criar o alerta na interface, você cola a URL do seu webhook no campo "URL do Webhook".

// no Pine Script — mensagem estruturada em JSON
if ta.crossover(ma_rapida, ma_lenta)
    alert('{"segredo":"MEU_SEGREDO","acao":"COMPRA","ativo":"BTCUSDT","qtd":0.01}',
          alert.freq_once_per_bar_close)

O segredo é vital — é o que impede que qualquer um que descubra sua URL dispare ordens falsas. Veremos a validação no servidor.

03Passo 2: o servidor receptor

Um servidor simples em Python com FastAPI que recebe o webhook, valida o segredo e processa:

# servidor.py
from fastapi import FastAPI, Request, HTTPException
import os

app = FastAPI()
SEGREDO = os.getenv("WEBHOOK_SECRET")   # nunca hardcode

@app.post("/webhook")
async def webhook(request: Request):
    dados = await request.json()

    # 1. valida o segredo — barra requisições falsas
    if dados.get("segredo") != SEGREDO:
        raise HTTPException(status_code=403, detail="Não autorizado")

    # 2. interpreta o sinal
    acao  = dados.get("acao")
    ativo = dados.get("ativo")
    qtd   = dados.get("qtd")

    # 3. executa na corretora (função do seu módulo de execução)
    if acao == "COMPRA":
        executar_compra(ativo, qtd)
    elif acao == "VENDA":
        executar_venda(ativo, qtd)

    return {"status": "ok", "acao": acao}

A função executar_compra usa a API da corretora — exatamente o código que mostramos no tutorial da Binance ou na API do MT5. O webhook só substitui a parte que "decide" — agora quem decide é o Pine Script.

04Passo 3: onde hospedar o servidor

O servidor precisa de URL pública e estar sempre no ar. Opções:

• VPS (a mesma do robô) — controle total, IP fixo pra você poder filtrar. Veja nosso guia de VPS.
• Plataformas de deploy (Render, Railway, Fly.io) — sobem o servidor rápido, têm plano gratuito limitado. Bom pra testar.
• Túnel local (ngrok) — só pra testes, expõe seu PC local temporariamente. Nunca pra produção.

05Webhook vs. integração nativa

Antes de montar todo esse pipeline, considere a alternativa: algumas corretoras têm integração nativa com o TradingView — você manda ordem direto do gráfico, sem servidor intermediário. A Pepperstone é um exemplo. Compare:

• Webhook + servidor: flexível (funciona com qualquer corretora que tenha API), mas adiciona pontos de falha (servidor, latência, segurança) e exige manutenção.
• Integração nativa: mais simples e confiável (sem servidor seu no meio), mas limitada às corretoras que oferecem e ao que a integração permite.

06Os riscos honestos da automação por webhook

Práticas que reduzem o risco: logar toda requisição recebida e toda ordem enviada; implementar idempotência (cada alerta tem um ID, ignore repetidos); ter um "kill switch" (forma de desligar tudo rápido); e — sempre — testar o pipeline inteiro em conta demo por semanas antes de qualquer real.

07Perguntas frequentes