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.

FUNÇÕES	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.

FUNÇÕES	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.

FUNÇÕES	ALIASES	RETORNOS
IND Indicator	IND	Retorna o valor do buffer de um indicador.
IND'X' Indicator'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.

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

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

FUNÇÕES	ALIASES	RETORNOS
Med Median	Med	Retorna a media entre dois valores.
TickTP TickToPoint	TickTP	Retorna o valor de tick convertido em pontos.
MoneyTP MoneyToPoint	MoneyTP	Retorna o valor na moeda convertida em pontos.
PipTP PipToPoint	PipTP	Retorna o valor do pip convertido em pontos.
Count CountStep	Count	Retorna a quantidade de passos que ocorreram.
CountGrad CountStepGradual	CountGrad	Retorna a quantidade de passos que ocorreram de forma gradual.
Divi Division	Divi	Retorna a divisão entre dois valores, permitindo que o denominador seja zero.
RDivi RestDivision	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.
PercentValue PercentOfValue	PercentValue	Retorna a quantidade percentual de um valor.
HitPercent		Retorna a quantidade percentual de acerto.
FixPrice CorrectPrice	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.
Chance IsChance	Chance	Retorna verdadeiro com base em uma chance percentual.
Decimal Decimals	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.

FUNÇÕES	ALIASES	RETORNOS
GetVol GetVolume	GetVol	Retorna o volume que a ordem será executada.
SetVol SetVolume	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.

FUNÇÕES	ALIASES	RETORNOS
IsTime		Verifica se o tempo corresponde aos critérios informados.
STime SymbolTime	STime	Retorna o horário atual do símbolo.
TLeft TimeLeft	TLeft	Retorna o tempo restante da vela atual.
DayW DayOfWeek	DayW	Retorna o dia da semana.
DayY DayOfYear	DayY	Retorna o dia do ano.
Month		Retorna o mês atual.
Year		Retorna o ano atual.
StartT StartTime	StartT	Retorna o horário inicial de referência.
ValueT ValueOfTime	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.

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

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

FUNÇÕES	ALIASES	RETORNOS
Pos ToPositive	Pos	Retorna o valor absoluto de um número.
Neg ToNegative	Neg	Retorna o valor negativo de um número.
ToTime		Retorna o horário em forma de texto simples para data em segundos.
TMod ToTimeModify	TMod	Retorna o horário modificado.
TFormat ToTimeFormat	TFormat	Retorna o horário em forma de texto.
Format ToFormat	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.

FUNÇÕES	ALIASES	RETORNOS
ClrDou ClearDouble	ClrDou	Remove todas as variáveis criadas pelo usuário.
ClrInt ClearInt	ClrInt	Remove todas as variáveis criadas pelo usuário.
ClrStr ClearString	ClrStr	Remove todas as variáveis criadas pelo usuário.
CreDou CreateDouble	CreDou	Cria uma variável caso ela não exista.
CreInt CreateInt	CreInt	Cria uma variável caso ela não exista.
CreStr CreateString	CreStr	Cria uma variável caso ela não exista.
GetDou GetDouble	GetDou	Retorna o valor de uma variável criada pelo usuário.
GetInt		Retorna o valor de uma variável criada pelo usuário.
GetStr GetString	GetStr	Retorna o valor de uma variável criada pelo usuário.
RemDou RemoveDouble	RemDou	Remove uma variável caso ela exista.
RemInt RemoveInt	RemInt	Remove uma variável caso ela exista.
RemStr RemoveString	RemStr	Remove uma variável caso ela exista.
RepDou ReplaceDouble	RepDou	Substitui o valor de uma variável caso ela exista.
RepInt ReplaceInt	RepInt	Substitui o valor de uma variável caso ela exista.
RepStr ReplaceString	RepStr	Substitui o valor de uma variável caso ela exista.
SetDou SetDouble	SetDou	Define o valor de uma variável ou cria uma nova.
SetInt		Define o valor de uma variável ou cria uma nova.
SetStr SetString	SetStr	Define o valor de uma variável ou cria uma nova.
AddDou AddDouble	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.

FUNÇÕES	ALIASES	RETORNOS
GetG GetGlobal	GetG	Obtém o valor de uma variável global do tipo double. 2.06+
CreG CreateGlobal	CreG	Cria uma nova variável global do tipo double. 2.06+
RepG ReplaceGlobal	RepG	Substitui o valor de uma variável global existente. 2.06+
GetGT GetGlobalTime	GetGT	Obtém o timestamp do último acesso de uma variável global. 2.06+
SetG SetGlobal	SetG	Define o valor de uma variável global (cria se não existir). 2.06+
AddG AddGlobal	AddG	Adiciona um valor a uma variável global existente. 2.06+
RemG RemoveGlobal	RemG	Remove uma variável global do tipo double. 2.06+
ClrG ClearGlobal	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.

FUNÇÕES	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.

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