Negociação via API

O que significa negociação via API

Negociação via API significa enviar ordens, solicitar preços e ler dados da conta por meio da interface de programação de aplicações (API) de uma corretora, em vez de clicar em uma plataforma de negociação. Uma API, abreviatura de application programming interface, é uma forma definida de um programa conversar com outro. O seu próprio software se conecta aos servidores da corretora, autentica-se e depois emite comandos como enviar ordem, cancelar ordem, obter posições ou receber cotações em tempo real.

Quem a utiliza se divide em alguns grupos. Os operadores sistemáticos executam estratégias baseadas em regras que eles mesmos programaram. Analistas quantitativos e estudantes testam ideias com dados reais. Desenvolvedores criam painéis personalizados, rebalanceadores de carteira ou alertas. Algumas empresas usam uma API para ligar sistemas de risco ou diários de operações à conta. Usar uma API não torna uma estratégia melhor. Apenas muda a forma como as instruções chegam à corretora.

A negociação via API difere dos expert advisors (EA) e dos scripts de plataforma. Um expert advisor funciona dentro de uma plataforma como o MetaTrader e depende de que essa plataforma esteja aberta. Um cliente de API normalmente roda no seu próprio servidor ou computador, em qualquer linguagem que a corretora suporte, e conversa diretamente com a corretora.

Como funciona

As corretoras disponibilizam APIs em alguns estilos comuns, e muitas oferecem mais de um.

• REST. O seu programa envia uma requisição por HTTPS e recebe uma resposta. É adequado para enviar ordens, consultar saldos e baixar o histórico.
• WebSocket ou streaming. Uma conexão persistente envia preços ao vivo e atualizações de ordens sem necessidade de consultas repetidas.
• FIX. O protocolo Financial Information eXchange é um padrão do setor usado por instituições e por algumas corretoras de varejo, concebido para baixa latência e grande volume de mensagens.
• Bibliotecas do fornecedor. Algumas corretoras fornecem kits de desenvolvimento de software para linguagens como Python, Java ou C#.

Um fluxo de trabalho típico é o seguinte.

1. Gere as credenciais da API, normalmente uma chave e um segredo ou um token, nas configurações da sua conta.
2. Autentique cada sessão. Muitas corretoras permitem restringir a chave a permissões específicas, como somente leitura.
3. Assine os dados de mercado e leia o bid e o ask atuais.
4. Execute a sua lógica e envie uma mensagem de ordem com instrumento, direção, tamanho, tipo de ordem e preço.
5. Leia a confirmação ou a rejeição e acompanhe as execuções por meio das atualizações do status da ordem.
6. Trate erros, reconexões e limites de requisições.

Um exemplo prático

Estes números são ilustrativos. Um desenvolvedor cria um script que verifica o EUR/USD a cada minuto e rebalanceia uma posição para uma meta de 1 lote padrão, ou seja, 100.000 unidades da moeda base.

• A posição atual é de 0,60 lote, portanto o script precisa comprar 0,40 lote.
• Ele lê o preço ask, digamos 1,0852, e envia uma ordem limitada de compra de 0,40 lote a 1,0852.
• A corretora limita a chave a 60 requisições por minuto. O script envia uma requisição de preço e uma de ordem por ciclo, ou seja, usa 2 das 60 permitidas, deixando margem para novas tentativas.
• A ordem é executada parcialmente em 0,25 lote. O script recebe a atualização, registra os 0,15 lote restantes e decide se espera ou cancela.
• O valor nocional da parte executada é 0,25 × 100.000 × 1,0852 = 27.130 USD.

O código é simples. O esforço está nas partes pouco glamorosas, como execuções parciais, conexões perdidas e ordens duplicadas.

Por que isso importa

Uma API oferece consistência e velocidade, porque o software não hesita nem se esquece. Permite testar um conjunto de regras com dados históricos e depois executá-lo ao vivo com a mesma lógica. Também pode reduzir erros manuais quando você gerencia muitos instrumentos.

Mas transfere a responsabilidade para você. Um bug pode enviar centenas de ordens em um minuto. As corretoras diferem no que permitem. Algumas oferecem API em todas as contas, outras apenas em certos tipos de conta, e algumas exigem um saldo mínimo ou aprovação. Os limites de requisições, os tipos de ordem suportados, as tarifas de dados de mercado e os instrumentos disponíveis variam muito, e custos como spreads e comissões continuam a valer para cada operação automatizada.

Como usar na prática

• Consulte a documentação para desenvolvedores da corretora antes de abrir uma conta. Verifique as linguagens, os protocolos, os tipos de ordem e os exemplos de código suportados.
• Descubra se existe um ambiente de demonstração ou de negociação simulada para a API e use-o primeiro.
• Reveja os limites de requisições, os limites de conexões e eventuais taxas pelo acesso a dados ou à API.
• Crie chaves com as permissões mínimas necessárias e guarde-as em um gerenciador de segredos, nunca em repositórios públicos de código.
• Incorpore mecanismos de segurança. Limite o tamanho das ordens, limite a perda diária, adicione um botão de emergência (kill switch) e registre todas as mensagens.
• Teste a reconexão e o tratamento de erros desconectando de propósito.
• Monitore o processo. Execute-o em um servidor estável e configure alertas para falhas.

Erros comuns e ideias erradas

• Presumir que uma API o torna mais rápido do que outros operadores. Na maioria das configurações de varejo, a latência da rede e a execução da corretora são o que domina.
• Pular o ambiente de demonstração. Dinheiro real é um modo caro de descobrir um bug.
• Ignorar execuções parciais e rejeições, o que faz o seu código acreditar em uma posição que não existe.
• Colocar segredos diretamente no código. Chaves vazadas já foram usadas para enviar ordens indesejadas.
• Acreditar que um backtest equivale a resultados futuros. Os testes históricos muitas vezes deixam de fora a derrapagem (slippage), as variações do spread e os erros de dados.
• Esquecer que a corretora também pode alterar ou descontinuar uma versão da API.

Riscos e limitações

A automação amplifica tanto os erros quanto as ideias. Um laço defeituoso, um feed de preços desatualizado ou um erro de fuso horário podem gerar grandes perdas rapidamente, e produtos alavancados como os CFDs podem perder valor depressa. Interrupções na corretora ou no seu servidor podem deixar posições sem gestão. A segurança é uma preocupação real, pois uma chave roubada pode operar a sua conta. Os termos de serviço restringem às vezes certos comportamentos de alta frequência. Nada aqui é uma recomendação de estratégia, e dados passados não preveem o desempenho futuro.

Como a Brokeli encara o tema

Na nossa pesquisa, registramos se uma corretora publica uma API, quais protocolos suporta e eventuais condições associadas, como o tipo de conta ou o financiamento mínimo. Consideramos a qualidade da documentação e a existência de um ambiente de demonstração como sinais práticos, e mantemos esses fatos ligados ao snapshot de pesquisa publicado para essa corretora e esse país.