Funções
Ir para funçõesFunções são blocos de instruções que executam ações e recebem parâmetros, permitindo criar regras e estratégias flexíveis e personalizadas.
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
Seção intitulada “Depuradores”Essas funções permitem executar comandos de depuração.
| Placeholders | Retornos |
|---|---|
| Imprime um texto nas Logs do ScriptBot. |
| Imprime um texto nas logs do Metatrader. |
| Retorna o valor informado e exibe esse valor no log para depuração. |
Logicas
Seção intitulada “Logicas”Essas funções permitem executar lógicas que facilitam o desenvolvimento de expressões e fluxo de validações.
| Placeholders | Retornos |
|---|---|
| Executa múltiplas expressões em sequência. 2.15+
|
Indicadores
Seção intitulada “Indicadores”Essas funções permitem acessar os valores dos buffers de um indicador, como preços, sinais, cores.
| Placeholders | Aliases | Retornos |
|---|---|---|
| | Retorna o valor do buffer de um indicador. |
| | Retorna o valor do buffer de um indicador. |
Candles
Seção intitulada “Candles”Essas funções permitem acessar os valores das velas, como preços de abertura, fechamento etc.
Mercado
Seção intitulada “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 |
|---|---|---|
| Retorna o último preço de negociação. | |
| | Retorna o maior preço do último negócio. |
| | Retorna o menor preço do último negócio. |
| Retorna o preço de venda (ask). | |
| | Retorna o maior preço de venda (ask). |
| | Retorna o menor preço de venda (ask). |
| Retorna o preço de compra (bid). | |
| | Retorna o maior preço de compra (bid). |
| | Retorna o menor preço de compra (bid). |
| | Retorna o horário do último negócio. |
| | Retorna o horário de início do pregão no dia especificado. |
| | Retorna o horário de encerramento do pregão no dia especificado. |
| | Retorna a vela (candle) de início do dia. |
| | Retorna a vela (candle) de fim do dia. |
| | Retorna o maior preço do dia. |
| | Retorna o menor preço do dia. |
Matemática
Seção intitulada “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.
Estas funções estão relacionadas aos dados da conta e permitem tanto recuperar quanto atualizar essas informações.
| Placeholders | Aliases | Retornos |
|---|---|---|
| | Retorna o volume que a ordem será executada. |
| | Define o novo volume da ordem. |
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 |
|---|---|---|
| Verifica se o tempo corresponde aos critérios informados. | |
| | Retorna o horário atual do símbolo. |
| | Retorna o tempo restante da vela atual. |
| | Retorna o dia da semana. |
| | Retorna o dia do ano. |
| Retorna o mês atual. | |
| Retorna o ano atual. | |
| | Retorna o horário inicial de referência. |
| | Converte o horário em valor numérico baseado no método. |
Posições e Ordens abertas
Seção intitulada “Posições e Ordens abertas”Estas funções permitem obter informações sobre posições e ordens abertas, como quantidades, preços, volumes, etc.
Posições fechadas
Seção intitulada “Posições fechadas”Estas funções permitem obter informações sobre posições fechadas, como quantidades, preços, volumes, etc.
| Placeholders | Aliases | Retornos |
|---|---|---|
| | Retorna o ticket da posição fechada mais próxima do índice informado. |
| | Retorna o ticket da posição fechada no índice informado ou 0, caso não exista. 2.15+
|
| | Retorna o lucro/prejuízo de um negócio. |
| | Retorna o preço de abertura de um negócio. |
| | Retorna o valor da comissão de um negócio. |
| | Retorna o valor da taxa de um negócio. |
| | Retorna o preço do stop loss de um negócio. |
| | Retorna o preço do take profit de um negócio. |
| | Retorna o valor do swap de um negócio. |
| | Retorna o volume de um negócio. |
| | Retorna o número mágico de um negócio. |
| | Retorna o motivo da execução de um negócio. |
| | Retorna o ticket da ordem associada a um negócio. |
| | Retorna o ID de um negócio. |
| | Retorna o tipo de entrada de um negócio. |
| | Retorna se o negócio é uma saída. |
| | Retorna se o negócio é uma posição de entrada. |
| | Retorna a data/hora de execução de um negócio. |
| | Retorna o tempo de execução de negociações em milissegundos desde 01.01.1970 |
| | Retorna o tipo de um negócio. |
| | Retorna o comentário associado a um negócio. |
| | Retorna o ID externo de um negócio. |
| | Retorna o símbolo de um negócio. |
Conversores
Seção intitulada “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 |
|---|---|---|
| | Retorna o valor absoluto de um número. |
| | Retorna o valor negativo de um número. |
| Retorna o horário em forma de texto simples para data em segundos. | |
| | Retorna o horário modificado. |
| | Retorna o horário em forma de texto. |
| | Retorna uma nova string formatada. |
| Retorna o valor convertido para inteiro. |
Variáveis do usuário
Seção intitulada “Variáveis do usuário”Essas variáveis permitem que o usuário crie suas próprias variáveis personalizadas.
| Placeholders | Aliases | Retornos |
|---|---|---|
| | Remove todas as variáveis criadas pelo usuário. |
| | Remove todas as variáveis criadas pelo usuário. |
| | Remove todas as variáveis criadas pelo usuário. |
| | Cria uma variável caso ela não exista. |
| | Cria uma variável caso ela não exista. |
| | Cria uma variável caso ela não exista. |
| | Retorna o valor de uma variável criada pelo usuário. |
| Retorna o valor de uma variável criada pelo usuário. | |
| | Retorna o valor de uma variável criada pelo usuário. |
| | Remove uma variável caso ela exista. |
| | Remove uma variável caso ela exista. |
| | Remove uma variável caso ela exista. |
| | Substitui o valor de uma variável caso ela exista. |
| | Substitui o valor de uma variável caso ela exista. |
| | Substitui o valor de uma variável caso ela exista. |
| | Define o valor de uma variável ou cria uma nova. |
| Define o valor de uma variável ou cria uma nova. | |
| | Define o valor de uma variável ou cria uma nova. |
| | Adiciona um valor double a uma variável existente. |
| Adiciona um valor inteiro a uma variável existente. 2.06+
|
Variáveis globais
Seção intitulada “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 |
|---|---|---|
| | Obtém o valor de uma variável global do tipo double. 2.06+
|
| | Cria uma nova variável global do tipo double. 2.06+
|
| | Substitui o valor de uma variável global existente. 2.06+
|
| | Obtém o timestamp do último acesso de uma variável global. 2.06+
|
| | Define o valor de uma variável global (cria se não existir). 2.06+
|
| | Adiciona um valor a uma variável global existente. 2.06+
|
| | Remove uma variável global do tipo double. 2.06+
|
| | Limpa variáveis globais com um prefixo específico. 2.06+
|
Estas funções permitem abrir, gerenciar e fechar posições de trade, incluindo ordens.
Objetos
Seção intitulada “Objetos”Estas funções permitem criar e manipular objetos básicos do MetaTrader 5.
| Placeholders | Aliases | Retornos |
|---|---|---|
| | Cria uma linha horizontal no gráfico. 2.10+
|
| | Cria uma linha vertical no gráfico. 2.10+
|
| | Cria uma linha de tendência no gráfico. 2.10+
|
| | Remove um objeto do gráfico. 2.10+
|
| | Remove múltiplos objetos do gráfico. 2.10+
|
| | Verifica se um objeto existe no gráfico. 2.10+
|
| | Obtém o tempo associado a um objeto. 2.10+
|
| | Obtém o preço associado a um objeto. 2.10+
|
| | Define o tempo de um ponto de um objeto. 2.10+
|
| | Define o preço de um ponto de um objeto. 2.10+
|