Variáveis

Variáveis são identificadores que armazenam dados dinâmicos utilizados em operações e expressões lógicas. Elas representam valores que podem mudar ao longo do tempo, mas não possuem parâmetros próprios que alterem seu comportamento.

Posições e Ordens:

Essas variáveis são definidas previamente e utilizadas como parâmetros fixos durante a execução de gatilhos ou eventos de posição.

PLACEHOLDERS	RETORNOS
_TICKET	Retorna o ticket do pedido.
_REQUEST	Retorna o ticket de solicitação do pedido.
_PARENT	Retorna o ticket da ordem-mãe, se houver.
_MAGIC	Retorna o magic number do pedido.
_SYMBOL	Retorna o ativo no qual o pedido foi criado.
_TIME	Retorna o horário de abertura do pedido.
_PRICE	Retorna o preço de abertura do pedido.
_SL	Retorna o preço do stop loss do pedido.
_TP	Retorna o preço do take profit do pedido.
_PROFIT	Retorna o lucro atual da posição.
_VOLUME	Retorna o volume atual do pedido.
_UPTIME	Retorna o tempo, em segundos, que o pedido está aberto.
_TYPE	Retorna o tipo do pedido (0 = Compra, 1 = Venda).
_COMMENT	Retorna o comentário associado ao pedido.
_FLAG_CHILD	Retorna se o pedido é uma ordem filha secundária.
_FLAG_CLIENT	Retorna se o pedido foi adicionado usando expressões lógicas.
_FLAG_SA	Retorna se o pedido foi adicionado pelo subsistema de Preço Médio Simples.

Dica

Nos Eventos, como no OnPositionModify(), as variáveis locais possuem duas versões: uma com o sufixo _OLD e outra sem sufixo.

As variáveis com o sufixo _OLD contêm o valor antes da modificação, enquanto as sem sufixo refletem o valor após a modificação.

Exemplos:
_SL_OLD: Retorna o valor antes da modificação.
_SL: Retorna o valor após a modificação.

Gatilhos:

Essas variáveis funcionam como parâmetros locais e imutáveis, configurados previamente à ativação de um gatilho.

PLACEHOLDERS	RETORNOS
_TRIG_TYPE	Retorna o tipo do gatilho. (0 = Compra, 1 = Venda)
_TRIG_IS_OPERATION	Retorna se o gatilho é uma operação boleana.
_TRIG_OPERATION	Retorna o resultado da operação. (0 = Falso, 1 = Verdadeiro)
_TRIG_PRICE	Retorna o preço do gatilho, caso ele seja um gatilho de preço.
_TRIG_WEIGHT_MIN	Retorna o peso mínimo do filtro.
_TRIG_WEIGHT_VALIDATE	Retorna o peso total validado do filtro.
_TRIG_VALIDS	Retorna a quantidade de filtros validados.
_TRIG_VALIDS_COM	Retorna a quantidade de filtros complementares validados.
_TRIG_VALIDS_REQ	Retorna a quantidade de filtros obrigatórios validados.

Conta:

Essas variáveis contêm dados da conta, incluindo saldo disponível, margens operacionais, limites de operação e informações da corretora.

PLACEHOLDERS	ALIASES	RETORNOS
BALANCE BAL	BAL	Retorna o saldo da conta.
CREDIT CRED	CRED	Retorna o crédito da conta.
EQUITY EQT	EQT	Retorna o patrimônio líquido da conta.
MARGIN		Retorna a margem da conta.
MARGIN_FREE MARGF	MARGF	Retorna a margem livre da conta.
MARGIN_LEVEL MARGL	MARGL	Retorna o nível de margem da conta.
MARGIN_INITIAL MARGI	MARGI	Retorna a margem inicial da conta.
MARGIN_MAINTENANCE MARGM	MARGM	Retorna a margem de manutenção da conta.
LOGIN		Retorna o número da conta.
NAME		Retorna o nome do titular da conta.
SERVER SRV	SRV	Retorna o servidor da conta.
CURRENCY CURR	CURR	Retorna a moeda da conta.
COMPANY COMP	COMP	Retorna a empresa/corretora da conta.
LIMIT_ORDER LIMITO	LIMITO	Retorna o limite máximo de ordens da conta.

Mercado

Essas variáveis contêm dados do mercado, incluindo preços de entrada, ativos envolvidos e horários de negociação.

PLACEHOLDERS	ALIASES	RETORNOS
TOTAL_CANDLE TCANDLE	TCANDLE	Retorna o total de candles.
TIME_LEFT TLEFT	TLEFT	Retorna o tempo restante.
TIME_CURRENT TCURRENT	TCURRENT	Retorna o tempo atual.
TIME_LOCAL TLOCAL	TLOCAL	Retorna o tempo local.
TIME_SERVER TSERVER	TSERVER	Retorna o tempo do servidor.
DAY_OF_WEEK DAYW	DAYW	Retorna o dia da semana.
DAY_OF_YEAR DAYY	DAYY	Retorna o dia do ano.
MONTH		Retorna o mês atual.
YEAR		Retorna o ano atual.
LAST		Retorna o último preço comercializado.
LAST_HIGH LASTH	LASTH	Retorna a máxima do dia.
LAST_LOW LASTL	LASTL	Retorna a mínima do dia.
LAST_TIME LASTT	LASTT	Retorna o último tempo comercializado.
ASK		Retorna o preço de compra.
ASK_HIGH ASKH	ASKH	Retorna o preço máximo de compra.
ASK_LOW ASKL	ASKL	Retorna o preço mínimo de compra.
BID		Retorna o preço de venda.
BID_HIGH BIDH	BIDH	Retorna o preço máximo de venda.
BID_LOW BIDL	BIDL	Retorna o preço mínimo de venda.
SYMBOL		Retorna o ativo que o robô está operando.
MAGIC		Retorna o id (magic number) que o robô está operando.
REAL		Retorna o ativo real, o ativo que as ordens serão executadas.

Posições e Ordens abertas

Essas variáveis contém os dados de ordens e posições que ainda não foram encerradas, permitindo o acompanhamento em tempo real.

PLACEHOLDERS	ALIASES	RETORNOS
ALL_VOLUME_OPEN AVOLO	AVOLO	Retorna a soma do volume total das posições.
BUY_VOLUME_OPEN BVOLO	BVOLO	Retorna a soma do volume total das posições de compra.
SELL_VOLUME_OPEN SVOLO	SVOLO	Retorna a soma do volume total das posições de venda.
ALL_POS_OPEN APOSO	APOSO	Retorna a quantidade de posições abertas.
BUY_POS_OPEN BPOSO	BPOSO	Retorna a quantidade de posições abertas de compra.
SELL_POS_OPEN SPOSO	SPOSO	Retorna a quantidade de posições abertas de venda.
ALL_OPEN AOPEN	AOPEN	Retorna a quantidade de pedidos abertos, tanto de posições quanto de ordens.
BUY_OPEN BOPEN	BOPEN	Retorna a quantidade de pedidos abertos de compra.
SELL_OPEN SOPEN	SOPEN	Retorna a quantidade de pedidos abertos de venda.
ALL_PROFIT_OPEN APROFITO	APROFITO	Retorna a soma do lucro das posições abertas.
BUY_PROFIT_OPEN BPROFITO	BPROFITO	Retorna a soma do lucro das posições de compra abertas.
SELL_PROFIT_OPEN SPROFITO	SPROFITO	Retorna a soma do lucro das posições de venda abertas.
ALL_ORDER_OPEN AORDERO	AORDERO	Retorna a quantidade de ordens abertas.
BUY_ORDER_OPEN BORDERO	BORDERO	Retorna a quantidade de ordens de compra abertas.
SELL_ORDER_OPEN SORDERO	SORDERO	Retorna a quantidade de ordens de venda abertas.
ALL_AVG_PRICE AAVG	AAVG	Retorna o preço médio de todas as posições abertas. 2.05+
ALL_AVG_DIR AAVGDIR	AAVGDIR	Retorna a direção média das posições abertas. (-1 = Venda, 0 = Equilíbrio e 1 = Compra). 2.05+
BUY_AVG_PRICE BAVG	BAVG	Retorna o preço médio das posições de compra abertas. 2.05+
BUY_AVG_DIR BAVGDIR	BAVGDIR	Retorna a direção média das posições de compra abertas. 2.05+
SELL_AVG_PRICE SAVG	SAVG	Retorna o preço médio das posições de venda abertas. 2.05+
SELL_AVG_DIR SAVGDIR	SAVGDIR	Retorna a direção média das posições de venda abertas. 2.05+

Posições e Ordens fechadas

Essas variáveis contém os dados de ordens e posições que foram encerradas.

PLACEHOLDERS	ALIASES	RETORNOS
ALL_VOLUME AVOL	AVOL	Retorna a soma total do volume.
BUY_VOLUME BVOL	BVOL	Retorna a soma do volume de compra.
SELL_VOLUME SVOL	SVOL	Retorna a soma do volume de venda.
ALL_PROFIT APROFIT	APROFIT	Retorna o total do lucro.
BUY_PROFIT BPROFIT	BPROFIT	Retorna o total do lucro de compra.
SELL_PROFIT SPROFIT	SPROFIT	Retorna o total do lucro de venda.
ALL_GAIN_PROFIT AGAINP	AGAINP	Retorna o total de profit ganho ignorando as perdas.
BUY_GAIN_PROFIT BGAINP	BGAINP	Retorna o total de profit ganho em compras ignorando as perdas.
SELL_GAIN_PROFIT SGAINP	SGAINP	Retorna o total de profit ganho em vendas ignorando as perdas.
ALL_LOSS_PROFIT ALOSSP	ALOSSP	Retorna o total de profit perdido ignorando os ganhos.
BUY_LOSS_PROFIT BLOSSP	BLOSSP	Retorna o total de profit perdido em compras ignorando os ganhos.
SELL_LOSS_PROFIT SLOSSP	SLOSSP	Retorna o total de profit perdido em vendas ignorando os ganhos.
ALL_POS APOS	APOS	Retorna o total de posições.
BUY_POS BPOS	BPOS	Retorna o total de posições de compra.
SELL_POS SPOS	SPOS	Retorna o total de posições de venda.
ALL_GAIN AGAIN	AGAIN	Retorna o total de vitorias.
BUY_GAIN BGAIN	BGAIN	Retorna o total de vitorias de compra.
SELL_GAIN SGAIN	SGAIN	Retorna o total de vitorias de venda.
ALL_LOSS ALOSS	ALOSS	Retorna o total de derrotas.
BUY_LOSS BLOSS	BLOSS	Retorna o total de derrotas de compra.
SELL_LOSS SLOSS	SLOSS	Retorna o total de derrotas de venda.
ALL_COMMISSION ACOMM	ACOMM	Retorna o total de comissões.
BUY_COMMISSION BCOMM	BCOMM	Retorna o total de comissões de compra.
SELL_COMMISSION SCOMM	SCOMM	Retorna o total de comissões de venda.
ALL_SWAP ASWAP	ASWAP	Retorna o total de trocas.
BUY_SWAP BSWAP	BSWAP	Retorna o total de trocas de compra.
SELL_SWAP SSWAP	SSWAP	Retorna o total de trocas de venda.
TICKET		Retorna o ticket da ultima posição.
TICKET_BUY TICKETB	TICKETB	Retorna o ticket da ultima compra.
TICKET_SELL TICKETS	TICKETS	Retorna o ticket da ultima venda.
GAIN_TICKET GTICKET	GTICKET	Retorna o ticket da ultima posição com ganho.
GAIN_TICKET_BUY GTICKETB	GTICKETB	Retorna o ticket da ultima compra com ganho.
GAIN_TICKET_SELL GTICKETS	GTICKETS	Retorna o ticket da ultima venda com ganho.
LOSS_TICKET LTICKET	LTICKET	Retorna o ticket da ultima posição com perda.
LOSS_TICKET_BUY LTICKETB	LTICKETB	Retorna o ticket da ultima compra com perda.
LOSS_TICKET_SELL LTICKETS	LTICKETS	Retorna o ticket da ultima venda com perda.

Dica

As variáveis de Ordens e Posições fechadas possuem quatro versões, que indicam diferentes períodos de tempo:

• _WEEK: soma total da semana
• _MONTH: soma total do mês
• _YEAR: soma total do ano
• (sem sufixo): soma total do dia

Para utilizá-las, basta adicionar o sufixo correspondente ao final da variável.
Exemplos: ALL_VOLUME_WEEK, ALL_GAIN_YEAR.

No caso dos aliases, os sufixos são aplicados em formato reduzido:
Exemplos: AVOLW (ALL_VOLUME_WEEK), AGAINY (ALL_GAIN_YEAR)
Sufixos disponíveis: W (semana), M (mês), Y (ano).

Sinais

Essas variáveis guardam as informações dos sinais, que são definidos com base nos gatilhos de entrada e confirmação.

PLACEHOLDERS	ALIASES	RETORNOS
SIG_TOTAL SIGTT	SIGTT	Retorna a soma de todos os sinais do dia.
SIG_BUY SIGB	SIGB	Retorna a soma de sinais de compra.
SIG_SELL SIGS	SIGS	Retorna a soma de sinais de venda.
SIG_LAST SIGL	SIGL	Retorna o tipo do último sinal. (-1 = Nenhum, 0 = Compra, 1 = Venda)
SIG_TIME SIGT	SIGT	Retorna a hora do último sinal.
SIG_TIME_BUY SIGTB	SIGTB	Retorna a hora do último sinal de compra.
SIG_TIME_SELL SIGTS	SIGTS	Retorna a hora do último sinal de venda.
SIG_PRICE SIGP	SIGP	Retorna o preço do último sinal.
SIG_PRICE_BUY SIGPB	SIGPB	Retorna o preço do último sinal de compra.
SIG_PRICE_SELL SIGPS	SIGPS	Retorna o preço do último sinal de venda.
SIG_TOTAL_CONFIRM SIGTC	SIGTC	Retorna a soma de sinais confirmados.
SIG_LAST_CONFIRM SIGLC	SIGLC	Retorna o tipo do último sinal confirmado. (-1 = Nenhum, 0 = Compra, 1 = Venda)
SIG_BUY_CONFIRM SIGBC	SIGBC	Retorna a soma de sinais de compra confirmados.
SIG_SELL_CONFIRM SIGSC	SIGSC	Retorna a soma de sinais de venda confirmados.
SIG_TIME_LAST_CONFIRM SIGTLC	SIGTLC	Retorna a hora do último sinal confirmado.
SIG_TIME_BUY_CONFIRM SIGTBC	SIGTBC	Retorna a hora do último sinal de compra confirmado.
SIG_TIME_SELL_CONFIRM SIGTSC	SIGTSC	Retorna a hora do último sinal de venda confirmado.
SIG_PRICE_LAST_CONFIRM SIGPLC	SIGPLC	Retorna o preço do último sinal confirmado.
SIG_PRICE_BUY_CONFIRM SIGPBC	SIGPBC	Retorna o preço do último sinal de compra confirmado.
SIG_PRICE_SELL_CONFIRM SIGPSC	SIGPSC	Retorna o preço do último sinal de venda confirmado.