API2Trade — Central de ajuda
Busque ou navegue pelas categorias à esquerda para encontrar respostas. Cada pergunta tem a própria URL para compartilhar.
Busque ou navegue pelas categorias à esquerda para encontrar respostas. Cada pergunta tem a própria URL para compartilhar.
A API2Trade é um serviço de API REST hospedado que permite interagir com contas de trading de MT4 e MT5 de forma programática, sem manter um terminal MetaTrader aberto no seu computador.
Você conecta sua conta de trading uma única vez e, a partir daí, pode executar operações, consultar dados da conta e ler preços de mercado a partir de qualquer linguagem de programação usando requisições HTTP padrão.
Para todos os detalhes técnicos, consulte a documentação oficial.
Começar leva menos de 30 minutos:
/RegisterAccount.Veja o guia passo a passo na documentação de autenticação.
Qualquer linguagem capaz de fazer requisições HTTP funciona com a API2Trade. Por ser uma API REST sobre HTTPS, você pode usar Python, JavaScript/Node.js, Go, C#, Java, Ruby, PHP ou qualquer outra linguagem.
Também funciona com ferramentas no-code como Postman, Make (Integromat), n8n, Zapier ou qualquer coisa capaz de chamar um endpoint HTTP.
Sim. A API suporta contas do MetaTrader 4 (MT4) e do MetaTrader 5 (MT5). Você pode conectar e gerenciar contas das duas plataformas simultaneamente, conforme o seu plano de assinatura.
MT4 e MT5 têm algumas diferenças nos endpoints disponíveis (por exemplo, o MT5 oferece mais tipos de ordem e mais opções de histórico). Consulte a documentação para a referência completa de endpoints por plataforma.
Não. Esse é justamente o propósito deste serviço. A API2Trade roda inteiramente no servidor. Você conecta as credenciais da sua corretora uma vez e a API mantém a conexão com a corretora em seu nome.
Você não precisa instalar o MetaTrader, nem manter um terminal em execução, nem programar Expert Advisors em MQL.
A autenticação funciona de forma diferente conforme o seu plano:
Use sua chave de API no cabeçalho x-api-key e passe o UUID da conta como parâmetro de consulta id (ou accountId):
curl -X GET "https://api.api2trade.com/AccountSummary?id=YOUR_ACCOUNT_UUID" \
-H "x-api-key: YOUR_API_KEY"Você encontra sua chave de API na aba Configurações do seu painel.
Os usuários dos planos Pro recebem uma URL base dedicada junto com um usuário e uma senha. Todas as requisições são autenticadas via Basic Auth:
Authorization: Basic BASE64_ENCODED(USERNAME:PASSWORD)Sua chave de API está na aba Configurações do painel, em app.api2trade.com.
Boa prática: guarde-a como variável de ambiente (por exemplo MTAPI_KEY) e injete-a em tempo de execução.
Você pode conectar contas de duas formas:
Faça login em app.api2trade.com, vá até a seção Contas e adicione suas credenciais de MT4/MT5 (número de login, senha e nome do servidor da corretora). Depois de conectada, você recebe um UUID único para essa conta.
Use o endpoint /RegisterAccount. Os parâmetros exatos e o formato da resposta estão na documentação da API.
NomeDaCorretora-Live ou NomeDaCorretora-Demo.Use o endpoint /CheckConnect. Ele verifica o status da conexão do UUID de conta informado e tentará reconectar automaticamente se a conexão tiver caído.
Para detalhes sobre o formato da requisição e os valores de resposta, consulte a documentação.
Use o endpoint /DeleteAccount para desconectar e remover uma conta de trading conectada. Você também pode listar todas as contas conectadas no momento com o endpoint /GetAccounts.
Consulte a documentação da API para os parâmetros da requisição.
Depende do seu plano:
A API cobre todo o ciclo de negociação:
Para detalhes completos de endpoints, parâmetros e formatos de resposta, consulte a documentação da API.
Use o endpoint /OrderSend. Você informa o símbolo, o tipo de operação (Buy, Sell, Buy Limit, etc.), o volume e, opcionalmente, stop loss, take profit e um comentário.
MT4 e MT5 têm parâmetros de /OrderSend ligeiramente diferentes: o MT5 aceita campos adicionais como expirationType e stopLimitPrice.
Use os endpoints /OrderHistory ou /OrderHistoryPagination. Você pode filtrar por intervalo de datas, número de ticket e ordem de classificação. O MT5 oferece ainda /PendingOrderHistory e /HistoryDealsByPositionId para consultas mais detalhadas.
A referência completa de parâmetros está na documentação.
Sim. A API oferece uma conexão WebSocket (eventos) para streaming em tempo real. Isso permite receber atualizações ao vivo em vez de consultar repetidamente os endpoints REST.
Pelo stream WebSocket você pode receber cotações de mercado ao vivo e, no caso do MT4, respostas assíncronas a certas requisições como o histórico de preços.
Para preços bid/ask ao vivo você pode usar o endpoint REST /GetQuote (ou /GetQuoteMany para vários símbolos), ou assinar as cotações pelo stream WebSocket para receber atualizações contínuas em tempo real.
O endpoint /GetQuote aceita um parâmetro msNotOlder que controla se a API espera por um tick novo ou devolve o último tick conhecido.
Para dados históricos de candles OHLC, use /QuoteHistory (MT4) ou /PriceHistory (MT5). Consulte a documentação para as opções de tempo gráfico e os parâmetros.
Há três planos ativos (preços sem impostos):
Também há um plano anual disponível, com economia de até 25% conforme o plano. Todos os preços são confirmados na página de preços.
Não. No momento não oferecemos teste grátis. Se tiver dúvidas sobre como avaliar a API, fale com a gente pelo Telegram ou por e-mail em [email protected].
Se um teste chegar a ser acordado individualmente, os Termos exigem que o cancelamento seja enviado por e-mail para [email protected] antes de o teste expirar: a data e hora da compra são a referência, e o e-mail continua sendo necessário mesmo que um pagamento já tenha sido processado.
Sim. O plano Single Account inclui uma conexão a cada 30 dias. Se precisar de mais contas, cada conta adicional é cobrada a € 10 por conta por mês, com cobrança automática no fim de cada ciclo.
Se você precisa de muitas contas, migrar para um plano Pro (contas ilimitadas*) sai mais barato a partir de cerca de 50 contas.
O pagamento é processado pelo Stripe. As formas aceitas incluem cartão de crédito ou débito, criptomoedas e transferência bancária.
Ao fazer um pedido, você também aceita o Contrato de Serviços do Stripe.
Sim, você pode cancelar a qualquer momento. Os cancelamentos passam a valer no fim do ciclo de cobrança de 30 dias em curso: não há reembolso proporcional por dias não utilizados.
Para cancelar durante um teste: envie um e-mail para [email protected] antes de o teste expirar. Se o pagamento já tiver sido cobrado, ainda é necessário um cancelamento por e-mail para encerrar a assinatura.
O serviço é operado pela Apex Vanguard Dynamics LLC, uma sociedade de responsabilidade limitada (LLC) registrada nos Estados Unidos, com endereço registrado em 30 N Gould St Ste R, Sheridan, WY 82801, Estados Unidos.
E-mail de contato: [email protected] · Telefone: +1 (929) 333-6422
Para os dados jurídicos completos, consulte o aviso legal.
Os Termos e Condições são regidos pelas leis do Estado de Wyoming, Estados Unidos. Qualquer controvérsia fica sujeita à jurisdição exclusiva dos tribunais de Wyoming, e ambas as partes concordam em tentar resolvê-la primeiro por negociação de boa-fé.
Você pode ler os Termos e Condições completos no site.
Não. Os Termos de Serviço exigem expressamente que você mantenha suas credenciais de acesso e chaves de API em sigilo e não as compartilhe com terceiros sem consentimento prévio por escrito da API2Trade.
Se você está construindo um produto ou serviço sobre a API (por exemplo, para seus próprios clientes), deve implementar sua própria camada de autenticação e manter a chave da API2Trade apenas no servidor: nunca a exponha aos usuários finais.
Não. Os Termos de Serviço proíbem extrair (scraping) ou revender dados do serviço sem autorização expressa e por escrito da API2Trade. As assinaturas também não são transferíveis.
Se você tem um caso de negócio específico, escreva para [email protected].
Sim. Acordos de confidencialidade estão disponíveis sob solicitação e devem ser acordados mutuamente por escrito. Aplicam-se as condições padrão de NDA, salvo se negociado de outra forma.
Escreva para [email protected] para solicitar.
A API2Trade declara aplicar diversas medidas de segurança:
Para mais detalhes sobre as práticas de segurança, consulte a Política de Privacidade.
A API2Trade é operada por uma empresa dos Estados Unidos (veja Quem opera a API2Trade?) e declara conformidade com a legislação de proteção de dados aplicável, incluindo o GDPR quando aplicável a usuários da UE/EEE.
Dados pessoais coletados: informações da conta (nome, e-mail, dados de faturamento), dados de uso (logs da API, endereço IP, navegador e sistema operacional) e informações de pagamento processadas pelo Stripe.
A empresa declara que não vende nem compartilha dados pessoais com terceiros. Todos os detalhes estão na Política de Privacidade.
Segundo a Política de Privacidade, os seguintes dados podem ser coletados:
Os dados podem ser tratados no EEE ou em outros países com níveis adequados de proteção de dados (dados os 11 data centers globais).
Leia a Política de Privacidade completa para todas as informações.
Os motivos mais comuns de falha na conexão:
ICMarkets-Live02). Encontre-o no MetaTrader em Arquivo → Abrir uma conta.Use o endpoint /CheckConnect para verificar o status atual da conexão. Se o problema continuar, escreva para [email protected].
Erros de autenticação normalmente indicam que a chave de API está ausente, errada ou sendo enviada no formato incorreto. Verifique o seguinte:
x-api-key, e não Authorization: Bearer.api.api2trade.com).Consulte a documentação de autenticação para os formatos corretos de cada tipo de plano.
A API2Trade anuncia 99,95% de disponibilidade nos seus 11 data centers globais, com tempo médio de resposta de cerca de 47 ms.
Observe que, conforme os Termos de Serviço, o serviço é fornecido “no estado em que se encontra” e “conforme disponibilidade”: o funcionamento ininterrupto ou livre de erros não é garantido contratualmente. Para sistemas em produção, implemente sempre lógica de novas tentativas e tratamento de erros do seu lado.
As rejeições de ordens vêm do servidor de negociação da corretora, não da API2Trade. As causas mais comuns são:
EURUSD em vez de EURUSDm).Verifique a resposta de erro da API: ela inclui os campos message e code da corretora explicando o motivo da rejeição.