Referência de sintaxe de comandos

Objetivo

Esta referência lista os comandos e aliases aceites pelo WebhookIngress. Descreve a entrada webhook TradingView, não ordens manuais do dashboard.

Comandos de mercado e pendentes

buy também aceita long.
sell também aceita short.
buystop também aceita buy_stop.
buylimit também aceita buy_limit.
sellstop também aceita sell_stop.
selllimit também aceita sell_limit.
Uma ordem pendente pode levar expiration, o seu tempo de vida em minutos (robô 0.0.30 ou posterior): veja a página do formato do webhook.

Fechar, cancelar e modificar

closelong também aceita close_long.
closeshort também aceita close_short.
closelongshort também aceita close_long_short.
cancellong também aceita cancel_long.
cancelshort também aceita cancel_short.
newsltplong aceita newsltp_long, breakevenlong, breakeven_long, break_even_long.
newsltpshort aceita newsltp_short, breakevenshort, breakeven_short, break_even_short.

Comandos alargados

Os scripts que já usam estes comandos e nomes de parâmetros funcionam aqui sem alterações. Os nomes sl_pips, sl_price, sl_pct, tp_pips, tp_price, tp_pct, entry_pips, entry_price e vol_lots são traduzidos automaticamente, e cada comando aceita também a sua forma com underscore (close_all, newsltp_buy_stop, ...). Uma exceção: um alerta que mistura unidades de preço (sl_pips com tp_price, por exemplo) passa a ser recusado.

Sair e entrar num único alerta: closelongopenlong, closelongopenshort, closeshortopenlong, closeshortopenshort, closelongshortopenlong, closelongshortopenshort, cancellongbuystop, cancellongbuylimit, cancelshortsellstop, cancelshortselllimit.
Fechar tudo: closeall fecha todas as posições e elimina todas as ordens pendentes, em todos os símbolos. closealleaoff faz o mesmo e depois coloca o robô em pausa.
Fecho parcial: closelongpct, closeshortpct. A percentagem vem da definição de conta Fecho parcial (%) — estes alertas não a transportam. Um volume no alerta tem prioridade.
SL/TP numa ordem pendente: newsltpbuystop, newsltpbuylimit, newsltpsellstop, newsltpselllimit. Nunca movem o preço de entrada.
Pausar / retomar por alerta: eaoff, eaon. O alcance é toda a conta.
Trailing numa única posição: trailingoff, trailingon, com o ticket da ordem. O stop já colocado não se move; o robô apenas deixa de o acompanhar.
Dimensionamento escrito no alerta: vol_dollar (montante arriscado, na moeda da conta), vol_pct_bal_loss (% do saldo), vol_pct_eq_loss (% do capital), vol_pct_bal_margin (% do saldo usado como margem — um limite de exposição, que ignora a distância do stop). O alerta tem prioridade sobre as definições de risco da conta.
Proteção escrita no alerta: spread limita o spread aceite na entrada, em pips. betrigger / beoffset levam o stop ao break-even; trailtrig / traildist / trailstep acompanham-no — os cinco em pips, apenas nessa posição. atrtimeframe / atrperiod / atrmultiplier / atrshift / atrtrigger acompanham-no a um múltiplo do ATR. Funcionam mesmo com o trailing da conta desligado.
Versão do robô: dimensionamento e proteção por alerta exigem o robô 0.0.21 ou posterior. Robôs anteriores ignoram-nos e executam o alerta com as definições da conta.

Várias estratégias no mesmo símbolo

Duas estratégias a operar o mesmo par vivem numa só conta, por isso um closelong sem nome fecha a primeira compra que encontra — talvez a da outra estratégia. Dê um nome a cada estratégia com tag (alias comment) para as separar: na entrada o robô escreve esse nome no comentário da posição no corretor, e um fecho com nome só toca nas posições que o levam.

Coloque o mesmo nome em todos os alertas de uma estratégia, de entrada e de saída. Um fecho cujo nome nunca apareceu numa entrada não fecha nada.
Os nomes passam a minúsculas e são cortados a 12 caracteres; tudo o que não sejam letras, dígitos, - e _ é removido. Strat A e strata são portanto o mesmo nome — escolhe nomes curtos e distintos.
Um fecho com nome requer o robô 0.0.21 ou mais recente. Num robô mais antigo o alerta é recusado em vez de ser executado sobre a posição de outra estratégia.
O nome acompanha a replicação: as posições replicadas num Destino levam o nome da Origem.
Não envies o seu próprio streamId junto com um nome — substitui o gerado e o nome deixa de chegar ao comentário da posição.
Sem nome nada muda: um fecho continua a pegar na primeira posição no sentido pedido.

Alerta de entrada da estratégia trend:

json

{"action":"buy","symbol":"USDJPY","risk":1,"tag":"trend"}

O seu alerta de saída, que não toca na outra estratégia:

json

{"action":"closelong","symbol":"USDJPY","tag":"trend"}

Exemplo mercado

json

{
  "action": "buy",
  "symbol": "EURUSD",
  "risk": 1,
  "sl": 0.2,
  "tp": 0.4,
  "priceMode": "percent"
}

priceMode indica a unidade de sl, tp e price no próprio alerta: price, pips ou percent. Aqui o stop fica a 0,2 % da entrada e o objetivo a 0,4 %, seja qual for o modo de preço da conta; sem priceMode, aplica-se o modo de preço da conta.

A mesma mensagem, gerada pelo painel — nada para escrever à mão

Exemplo pendente

json

{
  "action": "buystop",
  "symbol": "EURUSD",
  "price": 1.0875,
  "risk": 1,
  "sl": 1.0840,
  "tp": 1.0940,
  "priceMode": "price"
}

Exemplo fechar

json

{
  "action": "closelong",
  "symbol": "EURUSD",
  "ticket": "123456789"
}

Notas do parser

A chave fica no Webhook URL: https://webhook.theconnector.fr/YOUR_ACCESS_KEY.
risk é numérico; lotes exatos usam volume, lot, lots ou fixedVolume.
price só é necessário para pendentes.
ttl_ms não é lido pelo parser atual. Cada preço mantém a unidade em que está escrito — um sufixo (sl_pips, tp_price…) apenas para esse valor, caso contrário priceMode, caso contrário o modo de preço da conta — e um alerta cujos preços pedem duas unidades (sl_pips com tp_price, por exemplo) é recusado, nunca enviado sem o seu stop-loss ou take-profit: ponha um sufixo em todos os preços, ou em nenhum.
Uma ordem atrasada expira; não é repetida.