Seu primeiro fluxo de trabalho no MT4.
Conecte, consulte a conta, abra e feche uma operação demo e desconecte.
Passo a passo por escrito
- 0:00
Seu primeiro fluxo de trabalho no MT4.
Este tutorial mostra como conectar ao MT4, consultar sua conta, abrir e fechar uma operação de demonstração e desconectar o terminal.
- 0:15
Abra o console MT4.
Abra mt4 ponto mrpc ponto pro. O console abre automaticamente. A página de primeiros passos oferece um guia, busca de métodos, tutoriais e recursos para desenvolvedores. Neste exemplo, selecione ConnectEx no menu lateral.
- 0:41
Escolha sua chave de API.
A chave de API identifica seu acesso ao MetaRPC. Use TRIAL para uma sessão de teste ou informe sua chave na barra superior. Testes têm limites de capacidade e uso. Mantenha sua chave em segredo. Ela é diferente do identificador do terminal recebido após a conexão.
- 1:07
Conecte a conta demo.
Em ConnectEx, informe o login da conta demo, a senha de negociação e o nome exato do servidor da corretora. Aqui usamos FreshForex Demo. Deixe o campo opcional id vazio. Clique em Executar solicitação e aguarde. Os dados da conta estão ocultos nesta gravação.
- 1:33
Guarde o identificador do terminal.
Leia a resposta. O código de status HTTP duzentos indica que a API respondeu. Verifique primeiro error. Na conexão bem-sucedida, data.terminalInstanceGuid contém o identificador do terminal. O console o salva na barra superior e o envia no cabeçalho id das próximas solicitações. Ele não substitui a chave de API.
- 2:01
Consulte a conta.
Execute AccountSummary. Confira saldo, patrimônio, moeda e modo da conta. Esta gravação usa uma conta demo com negociação habilitada. Antes de enviar uma ordem, confirme que está na conta desejada.
- 2:23
Prepare uma pequena operação demo.
Selecione OrderSend e informe um símbolo disponível na sua conta. Usamos BTCUSD, a operação OC_OP_BUY e zero vírgula zero um lote. O símbolo e o volume mínimo variam entre corretoras. Confira as propriedades do símbolo.
- 2:49
Envie uma vez e confira a resposta.
Clique uma vez em Executar solicitação. Nesta resposta bem-sucedida do MT4, data.ticket identifica a nova operação. Data.volume é zero vírgula zero um, e data.price informa o preço de abertura. Guarde o ticket. Se houver erro, leia os detalhes antes de continuar.
- 3:15
Confira a posição aberta.
Execute OpenedOrders. Em data.orderInfos, encontre o ticket recebido de OrderSend. Confira símbolo, tipo de ordem, lotes e preço de abertura. Neste exemplo há uma posição de compra em BTCUSD. Ela também aparece na tabela de posições.
- 3:41
Feche a posição do exemplo.
Selecione OrderCloseDelete. Informe o ticket recebido de OrderSend e zero vírgula zero um lote para fechar todo o volume. Deixe o preço de fechamento vazio para usar a cotação atual. Confira ticket e volume, depois execute a solicitação.
- 4:06
Confira o resultado do fechamento.
A resposta não tem erro e apresenta o modo OCD_MARKET_ORDER. Esse é o resultado do fechamento de uma ordem a mercado. Consulte OpenedOrders novamente para verificar se restou volume. Isso também é útil em fechamentos parciais. Aqui solicitamos o fechamento total.
- 4:32
Verifique se não restaram ordens.
Ao executar OpenedOrders de novo, recebemos uma lista orderInfos vazia. Não restam posições abertas nem ordens pendentes nesta conta demo. Uma lista vazia é um resultado válido. A operação que criamos foi fechada.
- 4:56
Desconecte ao terminar.
Execute Disconnect com o identificador do terminal atual. Confira se não há erro. O terminal está desconectado. Desconectar não fecha posições; por isso fechamos a operação e consultamos OpenedOrders primeiro.
- 5:17
Use os mesmos passos no seu código.
Você concluiu o fluxo de trabalho do console MT4. Use os exemplos de código como ponto de partida, mantenha sua chave privada e confira cada resposta. Para resolver problemas, abra o guia de resultados do método ou o tutorial de erros do MT4.