Funções

Funções são identificadores que armazenam instruções dinâmicas utilizadas em operações e expressões lógicas. Diferente das variáveis, as funções aceitam parâmetros, o que permite modificar seu comportamento conforme os valores fornecidos. Elas oferecem maior flexibilidade na criação de regras e estratégias personalizadas.

Depuradores

Essas funções permitem executar comandos de depuração.

PLACEHOLDERS	RETORNOS
Log	Imprime um texto nas Logs do ScriptBot.
Print	Imprime um texto nas logs do Metatrader.
See	Retorna o valor informado e exibe esse valor no log para depuração.

Logicas

Essas funções permitem executar lógicas que facilitam o desenvolvimento de expressões e fluxo de validações.

PLACEHOLDERS	RETORNOS
Seq	Executa múltiplas expressões em sequência. 2.15+

Indicadores

Essas funções permitem acessar os valores dos buffers de um indicador, como preços, sinais, cores.

PLACEHOLDERS	ALIASES	RETORNOS
Indicator IND	IND	Retorna o valor do buffer de um indicador.
Indicator'X' IND'X'	IND'X'	Retorna o valor do buffer de um indicador.

Candles

Essas funções permitem acessar os valores das velas, como preços de abertura, fechamento etc.

PLACEHOLDERS	ALIASES	RETORNOS
Open O	O	Retorna o preço de abertura de uma vela.
Close C	C	Retorna o preço de fechamento de uma vela.
High H	H	Retorna o preço da máxima de uma vela.
Low L	L	Retorna o preço da mínima de uma vela.
Time T	T	Retorna o horário de abertura de uma vela.
Direction DIR	DIR	Retorna a direção de uma vela (-1 = Negativa, 0 = Neutra, 1 = Positiva).
Spread SPD	SPD	Retorna a quantidade de spread de uma vela.
Candle		Retorna o index da vela.
MaxHigh MaxH	MaxH	Retorna o preço máximo entre duas posições de velas.
MinLow MinL	MinL	Retorna o preço mínimo entre duas posições de velas.
TickVolume TICKV	TICKV	Retorna o volume de uma vela.
RealVolume REALV	REALV	Retorna o volume de uma vela usando os dados reais.

Mercado

Essas funções fornecem dados de mercado semelhantes aos preços das velas, mas com escopo mais abrangente para representar diferentes aspectos do mercado.

PLACEHOLDERS	ALIASES	RETORNOS
Last		Retorna o último preço de negociação.
LastHigh LastH	LastH	Retorna o maior preço do último negócio.
LastLow LastL	LastL	Retorna o menor preço do último negócio.
Ask		Retorna o preço de venda (ask).
AskHigh AskH	AskH	Retorna o maior preço de venda (ask).
AskLow AskL	AskL	Retorna o menor preço de venda (ask).
Bid		Retorna o preço de compra (bid).
BidHigh BidH	BidH	Retorna o maior preço de compra (bid).
BidLow BidL	BidL	Retorna o menor preço de compra (bid).
LastTime LastT	LastT	Retorna o horário do último negócio.
DayStartTime DayST	DayST	Retorna o horário de início do pregão no dia especificado.
DayEndTime DayET	DayET	Retorna o horário de encerramento do pregão no dia especificado.
DayStartCandle DaySC	DaySC	Retorna a vela (candle) de início do dia.
DayEndCandle DayEC	DayEC	Retorna a vela (candle) de fim do dia.
DayHigh DayH	DayH	Retorna o maior preço do dia.
DayLow DayL	DayL	Retorna o menor preço do dia.

Matemática

Estas são funções matemáticas utilizadas para realizar operações numéricas, como comparação de valores, cálculo de casas decimais e geração de resultados baseados em probabilidade.

PLACEHOLDERS	ALIASES	RETORNOS
Median Med	Med	Retorna a media entre dois valores.
TickToPoint TickTP	TickTP	Retorna o valor de tick convertido em pontos.
MoneyToPoint MoneyTP	MoneyTP	Retorna o valor na moeda convertida em pontos.
PipToPoint PipTP	PipTP	Retorna o valor do pip convertido em pontos.
CountStep Count	Count	Retorna a quantidade de passos que ocorreram.
CountStepGradual CountGrad	CountGrad	Retorna a quantidade de passos que ocorreram de forma gradual.
Division Divi	Divi	Retorna a divisão entre dois valores, permitindo que o denominador seja zero.
RestDivision RDivi	RDivi	Retorna o resto da divisão entre dois valores, permitindo que o denominador seja zero.
Percent		Retorna a variação percentual de value até target, com value sendo o valor base.
PercentOfValue PercentValue	PercentValue	Retorna a quantidade percentual de um valor.
HitPercent		Retorna a quantidade percentual de acerto.
CorrectPrice FixPrice	FixPrice	Retorna o valor correto de um preço.
Random		Retorna um valor inteiro aleatório entre dois valores.
Round		Retorna o valor arredondado.
RoundUp		Retorna o valor arredondado para cima.
RoundDown		Retorna o valor arredondado para baixo.
Max		Retorna o maior valor entre dois números.
Min		Retorna o menor valor entre dois números.
IsChance Chance	Chance	Retorna verdadeiro com base em uma chance percentual.
Decimals Decimal	Decimal	Retorna o número de casas decimais de um valor.

Conta

Estas funções estão relacionadas aos dados da conta e permitem tanto recuperar quanto atualizar essas informações.

PLACEHOLDERS	ALIASES	RETORNOS
GetVolume GetVol	GetVol	Retorna o volume que a ordem será executada.
SetVolume SetVol	SetVol	Define o novo volume da ordem.

Tempo

Estas funções auxiliam em operações relacionadas a datas e horários, como conversões, cálculos, formatações e retornos.

PLACEHOLDERS	ALIASES	RETORNOS
IsTime		Verifica se o tempo corresponde aos critérios informados.
SymbolTime STime	STime	Retorna o horário atual do símbolo.
TimeLeft TLeft	TLeft	Retorna o tempo restante da vela atual.
DayOfWeek DayW	DayW	Retorna o dia da semana.
DayOfYear DayY	DayY	Retorna o dia do ano.
Month		Retorna o mês atual.
Year		Retorna o ano atual.
StartTime StartT	StartT	Retorna o horário inicial de referência.
ValueOfTime ValueT	ValueT	Converte o horário em valor numérico baseado no método.

Posições e Ordens abertas

Estas funções permitem obter informações sobre posições e ordens abertas, como quantidades, preços, volumes, etc.

PLACEHOLDERS	ALIASES	RETORNOS
AllVolumeOpen AVolO	AVolO	Retorna o volume total de todas as posições e ordens abertas. 2.05+
BuyVolumeOpen BVolO	BVolO	Retorna o volume total das posições e ordens de compra abertas. 2.05+
SellVolumeOpen SVolO	SVolO	Retorna o volume total das posições e ordens de venda abertas. 2.05+
AllPosVolumeOpen APVolO	APVolO	Retorna o volume total de todas as posições abertas. 2.05+
BuyPosVolumeOpen BPVolO	BPVolO	Retorna o volume total das posições de compra abertas. 2.05+
SellPosVolumeOpen SPVolO	SPVolO	Retorna o volume total das posições de venda abertas. 2.05+
AllOrderVolumeOpen AOVolO	AOVolO	Retorna o volume total de todas as ordens pendentes. 2.05+
BuyOrderVolumeOpen BOVolO	BOVolO	Retorna o volume total das ordens de compra pendentes. 2.05+
SellOrderVolumeOpen SOVolO	SOVolO	Retorna o volume total das ordens de venda pendentes. 2.05+
AllOpen AOpen	AOpen	Retorna a quantidade total de posições e ordens abertas. 2.05+
BuyOpen BOpen	BOpen	Retorna a quantidade total de posições e ordens de compra abertas. 2.05+
SellOpen SOpen	SOpen	Retorna a quantidade total de posições e ordens de venda abertas. 2.05+
AllPosOpen APosO	APosO	Retorna a quantidade total de posições abertas. 2.05+
BuyPosOpen BPosO	BPosO	Retorna a quantidade total de posições de compra abertas. 2.05+
SellPosOpen SPosO	SPosO	Retorna a quantidade total de posições de venda abertas. 2.05+
AllOrderOpen AOrderO	AOrderO	Retorna a quantidade total de ordens pendentes. 2.05+
BuyOrderOpen BOrderO	BOrderO	Retorna a quantidade total de ordens de compra pendentes. 2.05+
SellOrderOpen SOrderO	SOrderO	Retorna a quantidade total de ordens de venda pendentes. 2.05+
AllProfitOpen AProfitO	AProfitO	Retorna o lucro/prejuízo total de todas as posições abertas. 2.05+
BuyProfitOpen BProfitO	BProfitO	Retorna o lucro/prejuízo total das posições de compra abertas. 2.05+
SellProfitOpen SProfitO	SProfitO	Retorna o lucro/prejuízo total das posições de venda abertas. 2.05+
AvgPrice PAvgP	PAvgP	Retorna o preço médio das posições abertas. 2.05+
AvgDir PAvgDir	PAvgDir	Retorna a direção média das posições abertas. 2.05+
AllAvgPrice AAvgPrice	AAvgPrice	Retorna o preço médio de todas as posições abertas. 2.05+
BuyAvgPrice BAvgPrice	BAvgPrice	Retorna o preço médio das posições de compra abertas. 2.05+
SellAvgPrice SAvgPrice	SAvgPrice	Retorna o preço médio das posições de venda abertas. 2.05+
AllAvgDir AAvgDir	AAvgDir	Retorna a direção média de todas as posições abertas. 2.05+
BuyAvgDir BAvgDir	BAvgDir	Retorna a direção média das posições de compra abertas. 2.05+
SellAvgDir SAvgDir	SAvgDir	Retorna a direção média das posições de venda abertas. 2.05+
PosTicket PTicket	PTicket	Retorna o ticket da posição aberta mais próxima do índice informado.
PosTicketExact PTicketE	PTicketE	Retorna o ticket da posição aberta no índice informado ou 0, caso não exista. 2.15+
PosDouble		Retorna o valor de uma propriedade numérica (double) de uma posição.
PosInt		Retorna o valor de uma propriedade inteira de uma posição.
PosString		Retorna o valor de uma propriedade textual de uma posição.
PosCurrent PCurrent	PCurrent	Retorna o preço atual de uma posição aberta.
PosOpen PO	PO	Retorna o preço de abertura de uma posição.
PosProfit PProfit	PProfit	Retorna o lucro atual de uma posição.
PosStop PSL	PSL	Retorna o preço do Stop Loss de uma posição.
PosSwap PSWAP	PSWAP	Retorna o valor do swap acumulado de uma posição.
PosTake PTP	PTP	Retorna o preço do Take Profit de uma posição.
PosVolume PVol	PVol	Retorna o volume de uma posição.
PosIdentifier PIdent	PIdent	Retorna o identificador único de uma posição.
PosMagic PMagic	PMagic	Retorna o número mágico de uma posição.
PosReason PReason	PReason	Retorna o motivo de abertura de uma posição.
PosTime PT	PT	Retorna o horário de abertura de uma posição.
PosTimeMsc PTMsc	PTMsc	Retorna o horário de abertura de uma posição em milissegundos.
PosTimeUpdate PTUpdate	PTUpdate	Retorna o horário da última atualização de uma posição.
PosTimeUpdateMsc PTUpdateMsc	PTUpdateMsc	Retorna o horário da última atualização de uma posição em milissegundos.
PosType PType	PType	Retorna o tipo de uma posição (compra/venda).
PosSymbol PSymbol	PSymbol	Retorna o símbolo do ativo de uma posição.
PosComment PComment	PComment	Retorna o comentário associado a uma posição.
PosExternal PExternal	PExternal	Retorna o ID externo de uma posição.
OrderTicket OTicket	OTicket	Retorna o ticket da ordem aberta mais próxima do índice informado.
OrderTicketExact OTicketE	OTicketE	Retorna o ticket da ordem aberta no índice informado ou 0, caso não exista. 2.15+
OrderDouble		Retorna o valor de uma propriedade numérica (double) de uma ordem.
OrderInt		Retorna o valor de uma propriedade inteira de uma ordem.
OrderString		Retorna o valor de uma propriedade textual de uma ordem.
OrderVolumeInit OVolInit	OVolInit	Retorna o volume inicial de uma ordem pendente.
OrderVolume OVol	OVol	Retorna o volume atual de uma ordem.
OrderOpen OO	OO	Retorna o preço de abertura de uma ordem.
OrderStop OSL	OSL	Retorna o preço do Stop Loss de uma ordem.
OrderTake OTP	OTP	Retorna o preço do Take Profit de uma ordem.
OrderCurrent OCurrent	OCurrent	Retorna o preço atual de uma ordem pendente.
OrderStopLimit OSLLimit	OSLLimit	Retorna o preço de ativação para ordens Stop Limit.
OrderSetup OSetup	OSetup	Retorna a data/hora de criação da ordem.
OrderType OType	OType	Retorna o tipo de uma ordem.
OrderState OState	OState	Retorna o estado atual de uma ordem.
OrderTimeExpiration OTExpira	OTExpira	Retorna a data/hora de expiração de uma ordem.
OrderDone ODone	ODone	Retorna a data/hora de execução ou cancelamento de uma ordem.
OrderSetupMsc OSetupMsc	OSetupMsc	Retorna a data/hora de criação da ordem em milissegundos.
OrderDoneMsc ODoneMsc	ODoneMsc	Retorna a data/hora de execução ou cancelamento em milissegundos.
OrderFilling OFilling	OFilling	Retorna a política de preenchimento de uma ordem.
OrderTime OT	OT	Retorna a data/hora da última modificação da ordem.
OrderMagic OMagic	OMagic	Retorna o número mágico de uma ordem.
OrderReason OReason	OReason	Retorna o motivo de criação da ordem.
OrderId OId	OId	Retorna o ID da ordem no sistema.
OrderById OById	OById	Retorna o ticket da ordem pelo ID do sistema.
OrderSymbol OSymbol	OSymbol	Retorna o símbolo do ativo de uma ordem.
OrderComment OComment	OComment	Retorna o comentário associado a uma ordem.

Posições fechadas

Estas funções permitem obter informações sobre posições fechadas, como quantidades, preços, volumes, etc.

PLACEHOLDERS	ALIASES	RETORNOS
DealTicket DTicket	DTicket	Retorna o ticket da posição fechada mais próxima do índice informado.
DealTicketExact DTicketE	DTicketE	Retorna o ticket da posição fechada no índice informado ou 0, caso não exista. 2.15+
DealProfit DProfit	DProfit	Retorna o lucro/prejuízo de um negócio.
DealOpen DO	DO	Retorna o preço de abertura de um negócio.
DealCommission DComm	DComm	Retorna o valor da comissão de um negócio.
DealFee DFee	DFee	Retorna o valor da taxa de um negócio.
DealStop DSL	DSL	Retorna o preço do stop loss de um negócio.
DealTake DTP	DTP	Retorna o preço do take profit de um negócio.
DealSwap DSwap	DSwap	Retorna o valor do swap de um negócio.
DealVolume DVol	DVol	Retorna o volume de um negócio.
DealMagic DMagic	DMagic	Retorna o número mágico de um negócio.
DealReason DReason	DReason	Retorna o motivo da execução de um negócio.
DealOrder DOrder	DOrder	Retorna o ticket da ordem associada a um negócio.
DealId DId	DId	Retorna o ID de um negócio.
DealEntry DEntry	DEntry	Retorna o tipo de entrada de um negócio.
DealOut DOut	DOut	Retorna se o negócio é uma saída.
DealIn DIn	DIn	Retorna se o negócio é uma posição de entrada.
DealTime DT	DT	Retorna a data/hora de execução de um negócio.
DealTimeMsc DTMsc	DTMsc	Retorna o tempo de execução de negociações em milissegundos desde 01.01.1970
DealType DType	DType	Retorna o tipo de um negócio.
DealComment DComment	DComment	Retorna o comentário associado a um negócio.
DealExternal DExternal	DExternal	Retorna o ID externo de um negócio.
DealSymbol DSymbol	DSymbol	Retorna o símbolo de um negócio.

Conversores

Estas funções de conversão permitem transformar valores entre diversos formatos, como converter números positivos em negativos e transformar strings em datas, entre outras operações.

PLACEHOLDERS	ALIASES	RETORNOS
ToPositive Pos	Pos	Retorna o valor absoluto de um número.
ToNegative Neg	Neg	Retorna o valor negativo de um número.
ToTime		Retorna o horário em forma de texto simples para data em segundos.
ToTimeModify TMod	TMod	Retorna o horário modificado.
ToTimeFormat TFormat	TFormat	Retorna o horário em forma de texto.
ToFormat Format	Format	Retorna uma nova string formatada.
ToInt		Retorna o valor convertido para inteiro.

Variáveis do usuário

Essas variáveis permitem que o usuário crie suas próprias variáveis personalizadas.

PLACEHOLDERS	ALIASES	RETORNOS
ClearDouble ClrDou	ClrDou	Remove todas as variáveis criadas pelo usuário.
ClearInt ClrInt	ClrInt	Remove todas as variáveis criadas pelo usuário.
ClearString ClrStr	ClrStr	Remove todas as variáveis criadas pelo usuário.
CreateDouble CreDou	CreDou	Cria uma variável caso ela não exista.
CreateInt CreInt	CreInt	Cria uma variável caso ela não exista.
CreateString CreStr	CreStr	Cria uma variável caso ela não exista.
GetDouble GetDou	GetDou	Retorna o valor de uma variável criada pelo usuário.
GetInt		Retorna o valor de uma variável criada pelo usuário.
GetString GetStr	GetStr	Retorna o valor de uma variável criada pelo usuário.
RemoveDouble RemDou	RemDou	Remove uma variável caso ela exista.
RemoveInt RemInt	RemInt	Remove uma variável caso ela exista.
RemoveString RemStr	RemStr	Remove uma variável caso ela exista.
ReplaceDouble RepDou	RepDou	Substitui o valor de uma variável caso ela exista.
ReplaceInt RepInt	RepInt	Substitui o valor de uma variável caso ela exista.
ReplaceString RepStr	RepStr	Substitui o valor de uma variável caso ela exista.
SetDouble SetDou	SetDou	Define o valor de uma variável ou cria uma nova.
SetInt		Define o valor de uma variável ou cria uma nova.
SetString SetStr	SetStr	Define o valor de uma variável ou cria uma nova.
AddDouble AddDou	AddDou	Adiciona um valor double a uma variável existente.
AddInt		Adiciona um valor inteiro a uma variável existente. 2.06+

Variáveis globais

Essas variáveis armazenam valores globais que são compartilhados entre todos os terminais do MetaTrader 5.
Lembre-se: por serem globais, qualquer programa pode alterar seus valores, o que pode gerar conflitos.
As variáveis permanecem disponíveis por até quatro semanas; caso não sejam utilizadas nesse período, o sistema as removerá automaticamente.

PLACEHOLDERS	ALIASES	RETORNOS
GetGlobal GetG	GetG	Obtém o valor de uma variável global do tipo double. 2.06+
CreateGlobal CreG	CreG	Cria uma nova variável global do tipo double. 2.06+
ReplaceGlobal RepG	RepG	Substitui o valor de uma variável global existente. 2.06+
GetGlobalTime GetGT	GetGT	Obtém o timestamp do último acesso de uma variável global. 2.06+
SetGlobal SetG	SetG	Define o valor de uma variável global (cria se não existir). 2.06+
AddGlobal AddG	AddG	Adiciona um valor a uma variável global existente. 2.06+
RemoveGlobal RemG	RemG	Remove uma variável global do tipo double. 2.06+
ClearGlobal ClrG	ClrG	Limpa variáveis globais com um prefixo específico. 2.06+

Trades

Estas funções permitem abrir, gerenciar e fechar posições de trade, incluindo ordens.

PLACEHOLDERS	RETORNOS
BuyAuto	Abre uma posição de compra no mercado.
SellAuto	Abre uma posição de venda no mercado.
Buy	Abre uma posição de compra no mercado atual.
Sell	Abre uma posição de venda no mercado atual.
BuyOrder	Coloca uma ordem pendente de compra.
SellOrder	Coloca uma ordem pendente de venda.
PosClose	Fecha uma posição aberta completamente.
PosClosePartial	Fecha parcialmente uma posição aberta.
OrderClose	Cancela uma ordem pendente.
PosCloseAll	Fecha todas as posições abertas.
PosBuyCloseAll	Fecha todas as posições de compra abertas.
PosSellCloseAll	Fecha todas as posições de venda abertas.
OrderCloseAll	Fecha todas as ordens abertas. 2.08+
OrderBuyCloseAll	Fecha todas as ordens de compra abertas. 2.08+
OrderSellCloseAll	Fecha todas as ordens de venda abertas. 2.08+
PosModify	Modifica os níveis de take profit e stop loss de uma posição aberta.
PosModifyTake	Modifica apenas o take profit de uma posição aberta.
PosModifyStop	Modifica apenas o stop loss de uma posição aberta.
OrderModify	Modifica os níveis de take profit e stop loss de uma ordem aberta.
OrderModifyTake	Modifica apenas o take profit de uma ordem aberta.
OrderModifyStop	Modifica apenas o stop loss de uma ordem aberta.
OrderModifyPrice	Modifica apenas o preço de uma ordem aberta.
Modify	Modifica os níveis de take profit e stop loss de uma posição ou ordem aberta.
ModifyTake	Modifica apenas o take profit de uma posição ou ordem aberta.
ModifyStop	Modifica apenas o stop loss de uma posição ou ordem aberta.

Objetos básicos

Estas funções permitem criar e manipular objetos básicos do MetaTrader 5.

PLACEHOLDERS	ALIASES	RETORNOS
ObjHLine ObjHL	ObjHL	Cria uma linha horizontal no gráfico. 2.10+
ObjVLine ObjVL	ObjVL	Cria uma linha vertical no gráfico. 2.10+
ObjTrendLine ObjTL	ObjTL	Cria uma linha de tendência no gráfico. 2.10+
ObjRemove ObjRem	ObjRem	Remove um objeto do gráfico. 2.10+
ObjClear ObjClr	ObjClr	Remove múltiplos objetos do gráfico. 2.10+
ObjExist ObjEx	ObjEx	Verifica se um objeto existe no gráfico. 2.10+
ObjGetTime ObjGT	ObjGT	Obtém o tempo associado a um objeto. 2.10+
ObjGetPrice ObjGP	ObjGP	Obtém o preço associado a um objeto. 2.10+
ObjSetTime ObjST	ObjST	Define o tempo de um ponto de um objeto. 2.10+
ObjSetPrice ObjSP	ObjSP	Define o preço de um ponto de um objeto. 2.10+