X-Trade Brokers Dom Maklerski S.A. XTB Expert Builder Manual Michał Zabielski, traduzido por Paulo Santos 2010-02-15
Índice Instalação... 2 Notificação legal... 5 Ajustes/Preferências iniciais... 6 Linguagem... 6 Directório da plataforma... 6 Permissões no Vista/Windows 7... 7 Ecrã principal... 8 Barra de ferramentas... 8 Painel esquerdo... 8 Painel de ferramentas... 9 Painel das variáveis... 10 Movendo os blocos... 11 Ligando os blocos... 12 Para ligar os blocos é necessário seguir os seguintes passos:... 12 Principais elementos de um Expert Advisor... 14 Bloco START... 14 Controlar a posição... 15 Abrindo o trade... 15 Fechando o trade... 16 Blocos lógicos... 17 Bloco AND / E... 17 Bloco OR / Ou... 17 Bloco NOT / Não... 17 Bloco CONDITION / Condição... 18 A importância do parâmetro Shift... 19 Exemplos... 20 Como escrever uma estratégia simples?... 20 Como usar o parâmetro Shift?... 20 Correndo a estratégia... 24 1
Instalação A instalação do XTB Expert Builder é um processo simples. Basta clicar duas vezes sobre o ficheiro de instalação e seguir as instruções: 1) Escolher a linguagem de instalação. O instalador possui versões em muitas linguagens diferentes. Escolher a linguagem de instalação vai ajudá-lo a instalar o programa de forma muito mais confortável. 2) Ler o acordo de licença Se todas as regras estabelecidas no acordo de licença são aceitáveis para si, então aceite este acordo clicando na opção apropriada. De notar que se não concordar, o programa não pode ser instalado. 2
3) Escolher o directório de instalação. Pode escolher o directório de instalação. Qualquer localização servirá, mas recomenda-se que use o directório sugerido pelo instalador. 4) Criar um ícone para o seu desktop Para ser mais fácil aceder ao XTB Expert Builder pode escolher que este crie um ícone para ficar no seu desktop. Isto fará com que iniciar o programa seja mais fácil e prático. 3
5) Terminar a instalação e correr o programa. O programa foi instalado com sucesso e está pronto para ser utilizado. Pode escolher iniciar o XTB Expert Builder imediatamente após a instalação. Obviamente também poderá utilizar o menu ou o ícone no desktop para o iniciar. Parabéns! Está pronto para descobrir quão fácil pode ser fazer o seu próprio Expert Advisor. 4
Notificação legal É muito importante que compreenda quão poderosa a ferramenta XTB Expert Builder pode ser, visto que poderá actuar no mercado real. Devido a isso, o acordo de licença irá aparecer cada vez que iniciar o programa ou compilar uma sua estratégia. 5
Ajustes/Preferências iniciais Quando se inicia o XTB Expert Builder pela primeira vez, existem duas preferências que têm que ser configuradas. Ambas estão disponíveis no ecrã inicial do acordo de licença, no botão Options. Estas duas preferências são a linguagem e o directório da plataforma XTB-Trader. Linguagem Pode escolher a linguagem que melhor se lhe adequa a partir do menu apresentado. Directório da plataforma Esta é a configuração mais importante. É crucial que escolha o directório da sua plataforma XTB- Trader. Sem esta configuração, o seu esquema de blocos nunca poderá ser transformado num Expert Advisor funcionar. Por defeito a plataforma XTB-Trader estará instalada em C:\Program Files\XTB- Trader 4. Pode clicar no botão, navegar até ao directório da plataforma XTB-Trader, selecioná-la e premir OK. 6
Permissões no Vista/Windows 7 Algumas vezes surgem uma série de erros quando se escolhe a directoria de destino da plataforma. Isto deve-se a outras aplicações não terem permissões para introduzir Expert Advisors na directoria da plataforma XTB-Trader. A solução é alterar as permissões da directoria da plataforma XTB-Trader, para o que é necessário fazer o seguinte: Clicar com o botão direito do rato na directoria da XTB-Trader e escolher Propriedades. Clicar em Segurança. Clicar em Editar. Seleccione o grupo de usuários a partir da lista. Clicar na opção de Controlo total na coluna Permitir. Premir Aplicar. Tentar novamente, no Expert Builder, seleccionar a directoria de destino da plataforma XTB- Trader. Se esta solução não funcionar por alguma razão, será necessário consultar o seu administrador de sistema para alterar as permissões do dito directório, ou re-instalar a plataforma XTB-Trader no seu directório de Documentos, e de seguida configurar o XTB Expert Builder com esse directório da plataforma. 7
Ecrã principal Barra de ferramentas A barra de ferramentas é um atalho para operações disponíveis no menu principal. As operações disponíveis na barra de ferramentas são: New criar um novo esquema de estratégia Open abrir um ficheiro com um esquema de estratégia antes criado e gravado. Estes ficheiros possuem a extensão.xtb. Save para gravar um esquema de estratégia num ficheiro. Compile compila o esquema actual para produzir um Expert Advisor funcionar. Para que funcione, é necessário que o directório da plataforma tenha sido correctamente configurado. Painel esquerdo Neste painel escolhemos se queremos criar novos blocos ou modificar as variáveis globais da estratégia: Variables Abre o painel das variáveis globais Tools Abre o painel de ferramentas (blocos) 8
Painel de ferramentas O painel de ferramentas providencia todo o tipo de blocos necessário para construir uma estratégia. Para escolher um elemento, basta clicar nele e arrastá-lo para o seu destino no esquema da estratégia. Os elementos serão descritos mais tarde neste manual. 9
Painel das variáveis O painel das variáveis contém as variáveis que poderão depois ser alteradas ou optimizadas aquando da execução do Expert Advisor na plataforma XTB-Trader. Podem ser coisas como o nível de stop loss, ou o período de uma média móvel. O processo de optimização de um Expert Advisor só é possível graças à existência de variáveis, que constituem parâmetros de um Expert Advisor que podem ser alterados, influenciando o seu comportamento. Este processo pode transformar uma estratégia perdedora numa estratégia ganhadora. Tudo depende da possibilidade de alterar os valores das variáveis. Para acrescentar uma nova variável, basta escrever o seu nome na coluna da esquerda, e o seu valor inicial na da direita (este valor pode depois ser alterado ou optimizado na plataforma XTB-Trader). O nome da variável só pode conter letras (não são permitidos espaços ou números). O nome da variável está limitado a 30 caracteres. O programa impedirá a introdução de nomes inválidos. Uma vez criada uma variável, ela estará disponível para ser utilizada nos blocos onde estejamos a utilizar valores decimais, tais como blocos de Condição (Condition) ou Abertura/Fecho (Open/Close). 10
Movendo os blocos Os blocos podem ser movidos simplesmente clicando neles e arrastando-os. De notar que o mesmo gesto (clicar e mover) serve para mover os blocos e para os ligar. Se clicar na borda de um bloco que já esteja no esquema e o mover, então o bloco mover-se-á. Por outro lado, se clicar no centro do bloco e mover o cursor, irá aparecer uma linha e pode ligar esse bloco a outro. O processo de ligação é descrito no próximo capitulo. 11
Ligando os blocos Os blocos têm que ser conectados correctamente para desenhar a lógica do Expert Advisor. Existem algumas regras a respeitar na ligação dos blocos. Algumas das ligações entre os blocos serão proibidas pela simples razão de não possuírem sentido lógico para o programa. As regras de ligação são descritas seguidamente: As setas podem sair dos blocos Start/Início, mas não podem chegar a ele no sentido oposto (saem do bloco Start mas não podem apontar para ele). As setas que saem do bloco Start/Início podem ligar-se somente a blocos de Open/Abrir e Close/Fechar de ordens. Os blocos Open/Abrir e Close/Fechar de ordens, além de poderem ligar-se ao bloco Start/Início, podem também ligar-se a outros blocos lógicos (Condition/Condição, And/E, Or/Ou, Not/Não). And/E, Or/Ou e Not/Não podem ser ligados a Open/Abrir e Close/Fechar de ordens, bem como a qualquer outro bloco lógico. O bloco Condition/Condição só pode ser o ponto de destino de uma seta. Logo não pode ser oponto de partida de uma seta. Significa assim que as condições estarão assim sempre no final do esquema de diagramas. Para ligar os blocos é necessário seguir os seguintes passos: Situe-se no centro do bloco, no qual terá origem a seta. Clique e arraste, e aí aparecerá um rectângulo verde tal como na imagem abaixo. Arraste a seta até ao bloco de destino. O rectângulo verde deverá agora aparecer no bloco de destino, tal como ilustrado na imagem abaixo. ATENÇÃO: se uma ligação for impossível, o rectângulo aparecerá roxo, e posteriormente, emitirá uma mensagem sobre uma qualquer solução possível. 12
Ao largar o botão do rato, uma nova ligação deverá surgir. 13
Principais elementos de um Expert Advisor Bloco START O bloco START é responsável pelos principais parâmetros da nossa estratégia, tais como: Lots a dimensão de cada trade efectuado pela estratégia. Size Automanagement quando se activa esta opção, desactiva-se o parâmetro antes indicado (Lots), na hora de lançar uma ordem o Expert Advisor irá calcular o seu volume. Esta opção determina que o volume usado será calculado como sendo uma função da margem livre. Por exemplo, se indicar 0.2 na Free Margin Fraction isso significará que se dispõe de 10.000 de margem livre, serão empregues aproximadamente 2.000 a abrir a operação seguinte, o que no caso do EURUSD, significaria que 2.000 corresponderiam à margem requerida para abrir 2 LOTES. Free Margin Fraction descrito acima. Trading mode- Escolhe o modo de funcionamento do Expert Advisor. Existem os seguintes modos disponíveis: o Trade o Expert Advisor executará ordens automaticamente. o Alert o Expert Advisor não executará ordens automaticamente, somente enviará mails (para o endereço especificado nas preferências, na plataforma XTB-Trader) ao utilizador. o Both o Expert Advisor fará ambos: transaccionará e alertará o utilizador. Trailing Stop se seleccionado como verdadeiro, então o modo de trailing stop será activado, e todas as ordens colocadas pela estratégia terão um trailing stop aplicado, com o número de pontos definido no campo Trailing Points. Trailing Points descrito acima. Arrow color Cor da seta que aparecerá quando forem realizadas operações. MAGIC É um número especial que identifica as ordens executadas pela nossa estratégia. Se o número é diferente de zero, então a estratégia encerrará apenas as ordens originadas com esse número. Se existirem várias estratégias com um mesmo número mágico activadas simultaneamente, é possível que cada uma possa fechar posições da outra. É aconselhável modificar este número de cada vez que se desenha uma nova estratégia. 14
Controlar a posição Para abrir ou fechar trades, são necessários os blocos apropriados. Esses blocos são os blocos Open e Close. Depois de parameterizá-los, tem que se adicionar a lógica que dirá à estratégia quando é que uma ordem deverá ser aberta, e quando é que deverá ser fechada. Isto é feito ligando os blocos de Open e Close a blocos lógicos. Abrindo o trade O bloco OPEN serve para abrir um trade. Pode escolher o tipo de trade (uma posição longa ou curta), o nível de stop loss para a ordem em pontos, e o nível de Takeprofit em pontos. Também se pode escrever um comentário que aparecerá na lista de ordens. É importante saber que uma estratégia feita no Expert Builder pode ter apenas uma ordem aberta em cada momento. Isto significa que para abrir a próxima ordem a anterior terá que ser fechada (a estratégia pode abrir uma ordem, fechar e abrir outra) 15
Fechando o trade No bloco CLOSE tudo o que é necessário é escolher que tipo de ordem (longa ou curta) quer fechar com a lógica associada. 16
Blocos lógicos Os blocos lógicos são o cérebro de cada estratégia. O fulcro da lógica estará nos blocos Condition/Condição mas para compor a lógica segundo a qual se enviarão os sinais serão necessários outros blocos lógicos. Cada bloco envia sinais verdadeiros ou falsos para cima, através das setas pelas quais estão ligados. O sinal provém do bloco Condition/Condição na parte de baixo da estrutura do diagrama, até aos blocos de Open/Abrir e Close/Fechar de ordens. Se chega um sinal verdadeiro aos blocos Open/Close o Expert Advisor abrirá ou fechará uma ordem, respectivamente. Bloco AND / E Este bloco ligado a outros dois blocos faz uma conjunção. Significa que todas as condições ligadas ao And têm que ser verdadeiras, para que o bloco AND seja verdadeiro. Bloco OR / Ou Este bloco ligado a outros dois blocos lógicos, faz uma alternativa. Significa que basta que uma das condições ligadas a este bloco seja verdadeira, para o bloco OU emita um sinal verdadeiro. Bloco NOT / Não Este bloco pode ser ligado a outro bloco lógico, e inverte o seu sinal. Isto significa que se receber um sinal verdadeiro, emitirá um sinal falso, e vice-versa. 17
Bloco CONDITION / Condição O bloco CONDITION é o mais importante dos blocos lógicos. Ele está no fundo da estrutura de blocos e é a sua fundação, sendo o bloco START o topo da estrutura. Estas condições serão o coração da estratégia. Cada bloco CONDITION contém informação relativa a dois indicadores técnicos que devolvem algum tipo de valores numéricos. Os dois indicadores podem assim ser comparados, por exemplo, na imagem abaixo comparam-se duas médias móveis. Neste exemplo o sinal verdadeiro é enviado quando estas duas médias móveis são perfeitamente iguais. Pode verificar se: == - Os indicadores da direita e da esquerda são iguais!= - Os indicadores são diferentes > - O indicador da esquerda é mais elevado do que o da direita < - O indicador da direita é mais elevado que o da esquerda >= - O indicador da esquerda é mais elevadou ou igual ao da direita <= - O indicador da direita é mais elevado ou igual ao da esquerda Existem muitos indicadores técnicos incluídos na plataforma XTB-Trader. Para verificar as propriedades de cada um pode consultar este site: http://docs.mql4.com/indicators 18
A importância do parâmetro Shift O significado do parâmetro shift é muito simples. É o número da barra (vela) na qual o indicador correspondente será calculado. Isto implica que existe uma forma de contabilizar as barras. A barra actual (aquela que está a mostrar o preço actual em tempo real e que ainda não está fechada) tem o parâmetro shift = 0. Se o indicador fosse calculado nesse instante nessa barra, então o shift deveria ser igual a zero. Porém, a maioria das estratégias vão basear-se em barras já completas (fechadas). A última barra que não sofrerá alterações e já está fechada, será a 1. Isso significa que o indicador deve ser calculado nessa barra e que o shift deve ser igual a um. A imagem acima mostra como é que o parâmetro shift trabalha. Claro que cada barra verá o seu número alterado assim que uma barra nova for adicionada ao gráfico. 19
Exemplos Como escrever uma estratégia simples? Este exemplo mostra como se ligam os blocos. Preste atenção onde está a ponta de cada seta. Esta estratégia diz para: 1) Abrir a ordem descrita no bloco OPEN quando a condição (1) E a condição (2) forem VERDADEIRAS. 2) Fechar a ordem descrita no bloco CLOSE quando a condição (3) for VERDADEIRA OU a condição (4) for NÃO VERDADEIRA. Obviamente, as condições têm que se estabelecidas pelo utilizador, nos blocos CONDITION (as médias móveis são o melhor para a primeira tentativa). Como usar o parâmetro Shift? Imagine que quer criar uma estratégia baseada no cruzamento de médias móveis. A questão importante será, qual a direcção do cruzamento. A estratégia deverá ser capaz de descobrir se a média móvel rápida cruzou a lenta de baixo para cima, ou de cima para baixo. 20
Existem dois cruzamentos de médias móveis na imagem acima. O cruzamento significa que se está a alterar a relação entre dois indicadores. Antes do cruzamento o valor de uma média móvel era superior ao da outra, e após o cruzamento, é inferior. É igualmente importante qual é a média móvel que tinha o valor superior antes e depois do cruzamento. No exemplo da imagem, um cruzamento pode ser responsável para abrir uma posição, e o segundo (oposto) para fechar essa posição antes aberta. Mas como traduzir esse cruzamento para a lógica do XTB Expert Builder? Muito simples. É necessário comparar o valor dos dois indicadores em dois pontos do tempo. Num ponto do tempo (barra) o valor de um indicador será mais elevado que o do outro, e no ponto seguinte do tempo (barra) a relação entre os indicadores será a oposta. Se isso acontecer, então claramente teremos observado um cruzamento. 21
Esta imagem mostra como será a lógica para o cruzamento. Para o fecho da posição a lógica será a mesma, mas trocando qual a média móvel que tem que ser maior e menor antes e depois do cruzamento. A primeira condição é activada quando na segunda barra já fechada (shift 2) a média móvel mais rápida está mais baixa do que a média móvel mais lenta. 22
A segunda condição é activada quando na última barra fechada (shift 1) a média móvel mais rápida está acima da média móvel mais lenta. Assim, quando combinamos estas duas condições com um bloco AND (tal como na imagem do esquema), então conseguimos cumprir a tarefa de criar lógica para apurar o cruzamento das médias num sentido. Basta invertermos os operadores < e >, e teremos a lógica para um cruzamento no outro sentido. Obviamente é também possível apurar cruzamentos de muitos outros indicadores. 23
Correndo a estratégia 1) Clicar no botão Compile na barra de ferramentas. 2) Se tudo estiver correcto, então a mensagem abaixo deverá aparecer: 3) Re-inicie a plataforma XTB-Trader, e verifique na secção Experts Advisors na janela Navegador. Se ainda não tiver gravado a estratégia, poderá aparecer com o titulo untitled. 4) Corra o seu Expert Advisor, ou teste-o no Examinador de estratégias. Para mais informações sobre como correr Expert Advisors, consulte a secção de formação em http://www.xtb.pt/?p=694#3 24