A porta de entrada para o mercado
As APIs de corretoras são o meio pelo qual o seu código conversa com as corretoras. Elas são a interface crítica que transforma suas decisões de trading em posições de verdade.
REST vs WebSocket
APIs REST: modelo de requisição e resposta. Usadas para enviar ordens, checar saldos e consultar posições. Entre as limitações estão os limites de requisições (rate limits) e a falta de atualizações em tempo real.
APIs WebSocket: conexão persistente em que a corretora envia os dados para você. Usadas para fluxos de preços, atualizações das ordens no livro de ofertas e notificações de operações.
A maioria dos sistemas de trading usa as duas: WebSocket para dados em tempo real, REST para gerenciar ordens.
Autenticação
Para operações de trading, as corretoras exigem autenticação com uma chave de API (identificador público) e uma chave secreta de API (chave privada usada na assinatura). A maioria das corretoras usa assinatura HMAC-SHA256.
Boas práticas de segurança:
- Nunca faça commit de segredos no git
- Use variáveis de ambiente ou gerenciadores de segredos
- Crie chaves de API separadas para cada sistema
- Ative a lista de IPs permitidos sempre que possível
Limites de requisições
Toda corretora limita a frequência com que você pode chamar a API dela. Passou do limite, você recebe erros ou bloqueios temporários.
Implemente o tratamento dos limites de requisições desde o início: acompanhe o seu consumo, aplique backoff ao se aproximar dos limites, coloque as requisições em fila para distribuí-las no tempo e dê prioridade às requisições de trading sobre as de dados.
Tipos de ordem em detalhe
Ordem a mercado: execução imediata ao preço atual de mercado. Simples, mas sem garantia de preço.
Ordem limitada: execução somente no preço definido ou melhor. Pode nem chegar a ser executada.
Ordem stop loss: dispara uma ordem a mercado quando o preço de stop é atingido.
Opções de validade (time-in-force): GTC (válida até ser cancelada), IOC (executar na hora ou cancelar), FOK (execução total ou nada), GTX (Post Only).
Tratamento de erros
Chamadas de API falham com frequência. Trate erros de rede (timeout, conexão recusada), erros da corretora (assinatura inválida, limite de requisições atingido, saldo insuficiente) e nunca presuma nada - verifique cada operação.
O estado mais perigoso: ordem enviada, nenhuma resposta recebida. Ela foi executada ou não? Você precisa verificar.
Diferenças entre corretoras
Cada corretora é diferente. Os nomes dos parâmetros variam, os modos de posição são diferentes (unidirecional vs hedge) e os tipos de margem também (Cross vs isolada). É por isso que existem bibliotecas como o CCXT - elas normalizam essas diferenças.
Boas práticas com WebSocket
A conexão WebSocket vai cair. Seu código precisa detectar a desconexão na hora, tentar reconectar com backoff, se inscrever de novo nos canais e solicitar os dados perdidos, se estiverem disponíveis.
Testes sem dinheiro real
Nunca teste primeiro com dinheiro real. Use as testnets das corretoras (Binance, Bybit e OKX, todas têm a sua), o trading demo (paper trading) com dados reais e o modo dry run, que só registra as ordens no log em vez de enviá-las.
CCXT: o adaptador universal
O CCXT oferece uma interface unificada para mais de 100 corretoras e cuida da autenticação, da assinatura das requisições, do controle dos limites de requisições e da interpretação das respostas. Recomendamos usar o CCXT como base e acrescentar chamadas diretas à API para os recursos aos quais ele não dá um bom suporte.
Lição principal
As APIs de corretoras são a base do trading automatizado e a origem da maioria dos bugs em produção. Domine a autenticação, os limites de requisições, o tratamento de erros e a gestão das conexões WebSocket.