Guia rápido da API REST do MT5
Escolha uma linguagem e execute o exemplo completo: crie uma nova conta demo, conecte-se, leia os dados da conta, abra uma posição demo de 0,01 lote em EURUSD, consulte a posição, feche-a, confirme o fechamento e desconecte-se. As operações usam apenas fundos virtuais. Sua própria chave de API consome créditos do serviço.
O ciclo completo da demonstração
/DemoAccount/OpenCrie uma conta demo da MetaQuotes. Mantenha em sigilo os dados de acesso recebidos. Esta etapa não deposita dinheiro em uma conta real de negociação.
/ConnectExConecte a conta demo e guarde o ID do terminal. A chave API identifica sua conta MRPC; o ID do terminal identifica esta conexão.
/AccountSummaryConsulte os dados da conta conectada. Uma resposta bem-sucedida confirma que a integração consegue obter dados; esta requisição não realiza operações.
/OrderSendCompra de 0,01 lote de EURUSD. Confira o código retornado pela corretora: HTTP 200 não confirma a execução por si só.
/OpenedOrderspositionInfos contém as posições abertas; openedOrders contém as ordens pendentes. Use o ticket da posição desta resposta para fechá-la.
/OrderClose → /OpenedOrdersFeche a posição informando o ticket e o volume. Depois consulte OpenedOrders novamente para confirmar o fechamento.
/DisconnectDesconecte mesmo se uma requisição anterior falhar. Os exemplos para download incluem a liberação de recursos e solicitam que o terminal expire após cinco minutos como medida adicional de proteção.
Autenticar e ler uma conta
Envie sua chave de API no cabeçalho APIKey. O ConnectEx retorna terminalInstanceGuid: use esse valor no cabeçalho id de AccountSummary e Disconnect. São identificadores diferentes. A requisição abaixo lê uma conta já conectada.
curl --request GET "https://mt5.mrpc.pro/AccountSummary" \
--header "APIKey: YOUR_API_KEY" \
--header "id: YOUR_TERMINAL_ID"
Desconecte após a requisição
Chame Disconnect em um bloco finally, inclusive quando uma leitura falhar. Como garantia de limpeza, a demo solicita a expiração do terminal em cinco minutos. Baixe acima o exemplo completo na sua linguagem de programação.
Diagnosticar uma conexão com falha
Confira a chave de API, o nome do servidor da corretora, o login e a senha. Se o ConnectEx falhar sem retornar um ID de terminal, não siga para o AccountSummary. Verifique seu saldo de serviços e os limites do modo de avaliação; não exponha credenciais em logs.
Rodar uma demo ao vivo →