O que é uma corretora de API?
Uma corretora de API é um provedor de serviços financeiros (ou uma camada de serviço) que permite que você envie e gerencie ordens por meio de uma interface de programação de aplicações (API), em vez de um terminal web. Na prática, a API envia solicitações de ordens, o provedor (ou um local de execução upstream) as processa, e os resultados da execução são retornados ao seu sistema.
Um ponto-chave é separar a mecânica (como as ordens são enviadas, modificadas e confirmadas) das variáveis dependentes do mercado e do provedor (preços, liquidez, tempo de execução e custos). Muitos mal-entendidos acontecem quando esses dois aspectos são tratados como a mesma coisa.
Mal-entendidos comuns e suas consequências
1) Confundir “acesso via API” com “melhor execução automática”
Um erro é tratar a presença de uma API como prova de que a execução será ideal ou previsível. A API frequentemente muda como as ordens são enviadas, não a realidade subjacente de que as execuções dependem das condições de mercado e de como a corretora roteia as ordens.
Consequência: você pode esperar resultados mais suaves do que o ambiente pode oferecer e, então, se surpreender quando as execuções diferirem do seu modelo mental.
Verificação neutra: confirme o que a API e a documentação realmente prometem sobre confirmações de ordens versus resultados de execução. Se o sistema retornar um status “confirmada” que não é o mesmo que “executada”, trate-os como eventos diferentes.
2) Assumir que “um preço” significa o preço final executado
Outro erro comum é assumir que uma única cotação, preço de tela ou número “visto por último” equivale ao preço final de execução. A execução envolve tempo, regras de tipo de ordem e liquidez disponível.
Consequência: seus cálculos podem estar errados porque o número usado foi apenas uma estimativa de entrada, não o resultado final.
Suposições a declarar em qualquer exemplo: defina o momento em que você leu o preço de referência, o modelo de taxas esperado e o tipo de ordem (por exemplo, se a ordem é semelhante a uma ordem a mercado ou a uma ordem limitada). Sem isso, as comparações não são significativas.
3) Ignorar latência e tempo de sistema
Mesmo sem suposições de dados em tempo real, há uma questão mecânica geral: o tempo importa. Atraso de rede, filas e tempo de processamento podem afetar se sua ordem atende às condições que você pensou que teria.
Consequência: você pode ver execuções parciais, execuções atrasadas ou comportamento que parece inconsistente com suas entradas.
Verificação neutra: meça os carimbos de data/hora de ponta a ponta que você controla (hora da solicitação da API, hora da resposta e hora do evento de execução). Se o sistema fornecer identificadores de evento, reconcilie-os em ordem.
4) Subestimar custos e impactos de taxas
Algumas pessoas focam nos movimentos de preço e ignoram custos como comissões e spreads/markups embutidos na execução. Com negociação via API, o preço reportado e o custo total podem ser separados por taxas.
Consequência: suposições de lucratividade ou ponto de equilíbrio falham porque a base de custo total é maior do que o esperado.
Verificação neutra: verifique como a plataforma reporta taxas, onde elas aparecem nos extratos e como se relacionam com cada execução. Reconcilie seu registro interno de negociações com o resumo de execução do provedor.
5) Entender mal os estados de ordem e a conciliação
As APIs normalmente têm vários estados: solicitação aceita, pendente, parcialmente executada, executada, cancelada, rejeitada ou expirada. Um erro frequente é ler apenas o estado mais recente e perder o ciclo de vida anterior.
Consequência: logs e sua visão de portfólio podem divergir, levando a monitoramento incorreto, verificações de risco incorretas e confusão sobre o que realmente aconteceu.
Verificação neutra: use uma lista de verificação do ciclo de vida da ordem: (a) foi aceita, (b) foi confirmada, (c) executou parcial ou totalmente, (d) as modificações foram aplicadas e (e) terminou em um estado final. Compare seus registros internos com o log de eventos do provedor.
Limitações e riscos a ter em mente
A incerteza faz parte da mecânica. Os resultados variam com as condições de mercado, o tempo de execução e os custos totais, e relações históricas não garantem resultados futuros. Isso significa que você deve evitar tratar backtests, saídas de amostra ou comportamento de “caminho feliz” como prova de resultados consistentes.
Pelo menos um modo de falha material a observar é a lacuna de conciliação: quando seu sistema assume que uma ordem foi executada, mas o provedor reporta um estado final diferente (por exemplo, rejeitada, cancelada ou apenas parcialmente executada). Outro é a incompatibilidade de parâmetros: enviar atributos de ordem (tamanho, lado, tipo de ordem, time-in-force) que diferem do que você pretendia.
Verificação ou próxima pergunta: como verificar fatos sem suposições
Uma maneira neutra de verificar o que uma corretora de API realmente faz é confiar na documentação e em testes controlados e pequenos.