JSON do webhook TradingView: referência de um payload estável

Por que um esquema estável importa

Um webhook gera mais confiança quando a mensagem é explícita. Um payload JSON estável pode ser lido, registado e auditado meses depois. TheConnector usa JSON simples de propósito: sem linguagem proprietária e sem regras de análise ocultas.

Os campos essenciais

Um payload mínimo e útil descreve a ação e o destino.

{
  "action": "buy",
  "symbol": "EURUSD",
  "account": "MY_ACCOUNT",
  "platform": "mt5",
  "risk": "1",
  "sl": "20",
  "tp": "40"
}

Campo a campo

• action: buy, sell ou uma instrução de fecho
• symbol: o ticker do TradingView, mapeado para o símbolo do broker pela conta
• account: qual conta ligada deve receber
• platform: mt4, mt5 ou ctrader quando precisa de ser explícito
• risk: a sua unidade de risco, interpretada pelas regras da conta
• sl e tp: distâncias opcionais de stop loss e take profit

Enviar a partir do Pine Script

Construa o JSON como string e envie apenas numa condição confirmada.

//@version=5
indicator("Webhook payload", overlay=true)
longSignal = ta.crossover(ta.sma(close, 20), ta.sma(close, 50))
if longSignal and barstate.isconfirmed
    alert("{\"action\":\"buy\",\"symbol\":\"EURUSD\",\"account\":\"MY_ACCOUNT\",\"platform\":\"mt5\",\"risk\":1,\"sl\":20,\"tp\":40}", alert.freq_once_per_bar_close)

Mantenha a consistência

• Use sempre os mesmos nomes de campos
• Decida uma vez se os números vão entre aspas e mantenha
• Envie uma alerta por fecho de vela salvo se a estratégia exigir outra coisa
• Não coloque segredos no payload; a chave de acesso está na URL do webhook

Erros comuns

• JSON inválido, como uma aspa em falta ou uma vírgula final
• Um símbolo sem mapeamento de broker
• Um valor de risco incompatível com as regras da conta
• Várias alertas na mesma vela que ultrapassam a quota do plano

Risco e limites

TheConnector encaminha a instrução técnica que envia. Um payload válido não garante execução: broker, spread, slippage e conectividade continuam a aplicar-se. Estratégia e risco continuam com o utilizador, e nenhuma automação promete ganhos.