Custos diretos vs. indiretos
Os custos de uma API de corretora não se resumem a um único preço. Eles geralmente vêm em dois grupos:
- Custos diretos: cobranças explicitamente vinculadas ao uso da API ou da conexão (por exemplo, taxas de conta ou acesso, taxas por requisição/mensagem, hospedagem ou cobranças de conectividade).
- Custos indiretos: custos que surgem da forma como a API é usada na prática (por exemplo, atrasos que alteram os resultados de execução, novas tentativas extras que aumentam o volume de requisições ou tempo operacional gasto no tratamento de erros).
Uma maneira clara de pensar sobre eles é: custos diretos são cobrados; custos indiretos são incorridos por meio de desempenho e operações.
Mecânica: onde os custos aparecem no uso da API de corretora
Para entender como os custos podem afetar você, defina primeiro as partes móveis principais.
- Requisições e mensagens: cada chamada de API (ou mensagem) pode contar para a precificação baseada em uso.
- Sessão e conectividade: manter uma conexão, permanecer autenticado e lidar com reconexões pode criar atividade de rede adicional.
- Ações relacionadas à negociação vs. ações de dados: mesmo quando você separa requisições de “leitura” (dados de mercado, informações de conta) de requisições de “escrita” (colocar/cancelar ordens), ambas podem contribuir para o volume de uso e, portanto, para os custos.
Como isso se traduz em custos:
- Altas taxas de chamadas podem aumentar o uso cobrado se o provedor cobrar por requisição ou por mensagem.
- Fluxos de trabalho “conversadores” (por exemplo, polling frequente em vez de atualizações orientadas a eventos) podem inflar tanto o uso direto quanto a carga indireta.
- Tratamento de erros e novas tentativas podem multiplicar o tráfego; uma única tentativa falha pode causar múltiplos acompanhamentos.
Premissa para qualquer exemplo abaixo: você pode medir seu próprio volume de requisições de API e seus carimbos de data/hora, mas não assume nenhum dado de mercado em tempo real.
Evidência ou exemplo: como verificar quais custos se aplicam
Como os modelos de precificação variam, a verificação deve focar no que seu uso realmente fez e no que seu contrato diz.
-
Revise as definições de taxas e o que conta
- Procure descrições de unidades cobráveis (requisições, mensagens, sessões, largura de banda ou “chamadas de API”).
- Observe exclusões e casos especiais (por exemplo, se verificações de integridade, requisições com falha ou endpoints específicos contam).
-
Meça o volume de requisições a partir dos logs
- Exporte logs de API que incluam carimbos de data/hora das requisições, nomes de endpoints (ou categorias), status de resposta e quaisquer códigos de erro.
- Calcule totais por endpoint e por janela de tempo. Isso permite separar o uso normal de picos causados por novas tentativas.
-
Relacione o comportamento de execução ao seu tempo
- Mesmo sem dados de mercado, você ainda pode medir o tempo interno: tempo de “requisição enviada” até “resposta recebida” e o número de tentativas de cancelamento/substituição.
- Compare execuções com a mesma lógica, mas sob diferentes condições de rede (por exemplo, reexecutando em um ambiente controlado). O objetivo é ver como a latência e as novas tentativas mudam o número de ações da API.
Limitação material: você pode não conseguir atribuir resultados a um único componente, pois o comportamento da API, a rede e os processos da bolsa/plataforma podem interagir. Relações históricas não estabelecem efeitos futuros.
Limitações e riscos (pelo menos um modo de falha)
Vários modos de falha podem transformar custos “esperados” em custos reais mais altos:
- Tempestades de novas tentativas: se timeouts ou limites de taxa acionarem novas tentativas automáticas, o tráfego total pode aumentar drasticamente, elevando as cobranças baseadas em uso e a sobrecarga operacional.
- Caminhos de falha parcial: alguns fluxos de trabalho podem gerar requisições extras (por exemplo, consultar o status após uma resposta suspeita de ter sido perdida).
- Custos operacionais: o tempo de engenheiros e suporte gasto na depuração de problemas de integração é um custo indireto que pode ser negligenciado quando se olha apenas para a tabela de taxas.
Mecânica estável vs. condições variáveis:
- Mecânica estável: como o volume de requisições, novas tentativas e uso de endpoints se mapeiam para atividade mensurável.
- Condições variáveis: o valor real que você paga depende dos termos de precificação do provedor, e o impacto operacional depende do comportamento da rede e da confiabilidade do sistema.
Verificação ou próxima pergunta
Um próximo passo prático é construir uma pequena visão de “contabilidade de custos” que combine três itens:
- O que seu sistema chamou (endpoints/categorias e contagens)
- Quando ele chamou (carimbos de data/hora para detectar padrões de novas tentativas)
- O que o contrato cobra (as definições de unidades cobráveis)
Então você pode responder: “Quais ações específicas foram mais responsáveis pelo meu uso cobrado e quais falhas aumentaram o tráfego?”
Se quiser, compartilhe o modelo de precificação geral que você está considerando (por exemplo, por requisição vs. por conexão vs. limites em camadas) e descreva seu fluxo de trabalho típico em alto nível (somente leitura, envio de ordens, cancelamento/substituição). Posso ajudar a traduzir isso em uma lista de verificação focada em métricas observáveis.