Payload webhook TradingView

Objetivo

Esta página documenta o contrato público do WebhookIngress para alertas TradingView. Não é o payload de ordens manuais do dashboard.

Caminho de acesso

• Na área cliente: Minhas contas > abrir uma conta de trading > copiar a chave de acesso.
• No TradingView: Alerta > Notificações > colar https://webhook.theconnector.fr/YOUR_ACCESS_KEY em Webhook URL.
• No campo Message do TradingView, colar o JSON.

JSON mínimo

{
  "action": "buy",
  "symbol": "EURUSD",
  "risk": 1,
  "sl": 20,
  "tp": 40
}

Campos lidos pelo WebhookIngress

• action é obrigatório. Aliases: side, type, command, msgtype.
• symbol é obrigatório para comandos de trading. Aliases: pair, ticker, instrument, market, asset.
• risk é enviado como risco numérico. Para lotes exatos, use volume, lot, lots ou fixedVolume.
• sl e tp são os nomes atuais de stop loss / take profit. Aliases: stoploss, stop_loss, takeprofit, take_profit.
• price só é usado para ordens pendentes: buystop, buylimit, sellstop, selllimit.
• ticket, orderId, order_id, positionId ou position_id só servem quando há uma ordem ou posição conhecida.
• account / accountCode e platform são opcionais com a URL da conta; servem apenas em rotas partilhadas.
• streamId ou id pode ser enviado para acompanhamento. Se faltar, o servidor cria um id.
• tag (alias comment) nomeia a estratégia a que o alerta pertence. Numa entrada é escrito no comentário da posição no corretor; num fecho limita o fecho às posições que têm esse nome, por isso várias estratégias podem partilhar uma conta e um símbolo. Passa a minúsculas e é cortado a 12 caracteres, e é respeitado a partir do robô 0.0.21 — abaixo dessa versão, um fecho com nome é recusado em vez de ser executado sobre a posição de outra estratégia. Se enviares o teu próprio streamId, ele substitui o gerado e o nome nunca chega ao comentário da posição: omite streamId quando usares nomes.
• clientRequestedAtUtc, requestedAtUtc ou requestedAt podem ser enviados como data UTC informativa.

Alternativa numa linha

JSON é recomendado, mas WebhookIngress também aceita texto separado por vírgulas:

buy,EURUSD,risk=1,sl=20,tp=40

O que não enviar

Não dependa de ttl_ms, vol_lots, sl_pips ou tp_pips: o parser atual do WebhookIngress não lê estes nomes. Use o modo de preço da conta para interpretar sl, tp e price.

Scripts de terceiros existentes

Não presuma que uma mensagem criada para outro conector é compatível sem alterações. Pode manter a lógica da estratégia, mas confirme e adapte os campos TradingView acima.