Resposta direta
Para acesso via API, você deve verificar (1) o que o provedor publica como custos de negociação e acesso, e (2) o que pode mudar entre uma cotação que você vê e o custo final que você incorre quando as ordens são executadas. A ideia central é separar regras de precificação estáveis e publicadas (taxas, tabelas de comissões, regras de financiamento) dos resultados de execução variáveis, impulsionados pelas condições de mercado, liquidez e pela forma como o provedor roteia as ordens.
Mecanismo ou definição
Acesso via API significa que seu sistema de negociação envia ordens e recebe informações de preços por meio de uma interface de programação de aplicativos. Nessa configuração, “spread” geralmente se refere à diferença entre os preços de compra e venda no feed de dados ou no fluxo de cotações. “Taxas” são as cobranças que podem ser aplicadas a você pelo uso do serviço, tais como:
- Comissão ou taxa de negociação: um custo publicado que depende do volume, do tipo de ordem ou do plano da conta.
- Taxas de acesso ou de plataforma/API: cobranças por conectividade, assinaturas ou uso (se houver).
- Custos não relacionados à negociação vinculados a posições: por exemplo, custos que dependem do tempo de manutenção da posição (frequentemente descritos como financiamento ou rollover).
Uma distinção fundamental é entre regras de precificação publicadas e custos de execução realizados. As regras publicadas são estáveis o suficiente para serem lidas na documentação (por exemplo, “a comissão é X por unidade”). Os custos realizados dependem de se sua ordem executa no preço esperado, de quanto da sua ordem é preenchido e de como o spread de compra/venda efetivo usado na execução se relaciona com as cotações que você observou.
Evidência ou exemplo
Uma forma prática de verificar taxas e spreads é construir um modelo de custo simples baseado em premissas e, em seguida, mapear cada termo para algo que você possa verificar a partir da documentação e das execuções observadas.
Premissas de exemplo (declare-as claramente):
- Tamanho da ordem (unidades ou lotes).
- Se sua estratégia usa ordens a mercado, ordens limitadas ou ambas.
- A janela de tempo para execução e o regime de liquidez esperado (sem usar dados em tempo real).
- Se as cotações da API são indicativas ou garantidas como executáveis.
Em seguida, separe os custos em componentes:
- Componente de spread: estime um custo usando o spread disponível no feed no momento em que você executaria.
- Componente de taxa: adicione a comissão documentada por volume executado.
- Componente de tempo de posição (se houver manutenção): inclua quaisquer regras publicadas de financiamento/rollover se seu plano mantiver posições.
- Componente de implementação: adicione uma margem para diferenças de execução (por exemplo, preenchimentos parciais ou movimento de preço durante o roteamento da ordem).
A limitação é que o spread que você calcula a partir dos dados de cotação pode não ser igual ao spread efetivo embutido em suas execuções. Essa lacuna é exatamente o motivo pelo qual você deve verificar comparando as fórmulas de precificação documentadas com as execuções observadas em um teste controlado, mantendo as premissas constantes.
Limitações e riscos
Modos de falha materiais a considerar:
- Incompatibilidade entre cotação e execução: O spread de compra/venda que você consome da API pode ser indicativo. O preço executado pode diferir devido a latência, mudanças de mercado ou roteamento de ordens.
- Preenchimentos parciais e efeitos de slippage: Se sua ordem for apenas parcialmente preenchida, o preço efetivo médio ao longo de toda a execução pode diferir do spread em um único momento de cotação.
- Sensibilidade a momento e liquidez: A qualidade da execução pode mudar rapidamente quando a liquidez do mercado diminui ou a volatilidade aumenta.
- Gatilhos de taxas ambíguos: Algumas taxas podem depender de condições (faixas de volume, tipo de ordem, status da conta ou se determinados eventos de ordem ocorrem). Se você não mapear os gatilhos com precisão, seu modelo de custo pode estar errado.
Além disso, relações históricas não garantem resultados futuros, portanto, evite assumir que um padrão de spread passado ou um comportamento de taxas anterior se manterá.
Verificação ou próxima pergunta
Para verificar o que importa para acesso via API, você pode usar uma lista de verificação em duas camadas:
- Camada de documentação (regras estáveis): localize as tabelas de taxas publicadas e quaisquer regras para cobranças de negociação e custos não relacionados à negociação. Confirme as unidades das taxas (por lote, por unidade, por negociação) e as condições que ativam cada taxa.
- Camada de execução (resultados variáveis): em um ambiente de teste ou em uma configuração controlada, compare os resultados de execução observados (preço médio de preenchimento e totais de taxas) com suas premissas de planilha.
Próxima pergunta a se fazer: As definições de precificação e cotação publicadas pela API explicam claramente o que é executável versus indicativo, e quais tipos de evento acionam cada taxa? Se esse mapeamento não estiver claro, você não pode converter de forma confiável spreads de cotação em custo total realizado.