In this Article
A conversão de moedas parece um problema resolvido, com uma API à frente. As complicações aparecem na primeira vez que as equipes financeira e de produto discordam sobre um número, e a causa quase sempre é que usam taxas diferentes e ambas acreditam que a sua é a taxa.
Este guia separa os quatro tipos de taxa, explica de onde vem cada um e apresenta uma regra para escolher uma taxa que você possa justificar depois.
Fatos principais
- Não existe uma única taxa de câmbio. As moedas são negociadas no mercado de balcão, portanto cada taxa publicada é a visão de uma fonte em um momento específico.
- Quatro tipos de taxa são confundidos com frequência, e usar o tipo errado é a causa mais comum de diferenças de conciliação em um sistema financeiro.
- As taxas de referência dos bancos centrais são publicadas uma vez por dia e são estáveis e citáveis, o que as torna a escolha certa para contabilidade e a errada para precificação.
- A taxa paga pelo cliente inclui um spread, portanto uma taxa de mercado médio nunca corresponde ao extrato do cartão, e apresentá-la como preço gera chamados de suporte.
- Sempre armazene a taxa, a fonte e o carimbo de data e hora junto de cada valor convertido, ou a conversão não poderá ser reproduzida depois.
Por que não existe uma única taxa de câmbio?
Porque as principais moedas são negociadas no mercado de balcão entre instituições, e não em uma única bolsa central. Não há sino de fechamento nem cotação oficial, então cada valor publicado é a agregação de uma fonte específica em um instante específico.
Isso tem uma consequência direta para o software: duas APIs consultadas com um segundo de diferença podem retornar números diferentes de forma justificada, e nenhuma delas está com defeito. O problema de conciliação que isso cria não se resolve encontrando uma fonte melhor. Resolve-se decidindo qual fonte é a autoridade para cada finalidade e registrando essa decisão com cada valor armazenado.
Quais tipos de taxa existem?
Quatro, com finalidades diferentes, e qualquer API de taxas de câmbio retorna uma delas. Chamamos isso de modelo de taxas em 4 partes.
| Tipo | O que é | Use para |
|---|---|---|
| 1. Mercado médio | Ponto médio entre compra e venda nos principais mercados | Exibição, análises, comparação interna |
| 2. Referência de banco central | Uma referência diária publicada, fixada em horário definido | Contabilidade, impostos, contratos, qualquer coisa auditável |
| 3. Taxa de transação | O que um provedor de pagamentos ou uma rede de cartões realmente aplica, incluindo spread | Conciliação com liquidações reais |
| 4. Taxa garantida | Uma taxa fixada por um período por um provedor, com uma margem por essa garantia | Precificação no checkout quando o total não pode mudar |
O erro clássico é exibir uma taxa de mercado médio no checkout e liquidar com uma taxa de transação. O cliente vê um número e é cobrado por outro, e a diferença é totalmente previsível e totalmente evitável.
Como uma taxa deve ser escolhida e armazenada?
| Finalidade | Use esta taxa quando | Evite quando |
|---|---|---|
| Relatórios financeiros | Referência de banco central, datada | Você precisar de precisão intradiária, que as referências não oferecem |
| Precificação de produto exibida aos usuários | Taxa garantida ou de transação, com o spread informado | Usar a taxa de mercado médio, que não corresponderá à cobrança |
| Análises e dashboards | Mercado médio, de forma consistente, uma fonte | Misturar fontes entre gráficos, o que cria variação falsa |
| Comparação histórica | A taxa armazenada naquele momento | Reconverter o histórico à taxa de hoje, o que reescreve o passado |
Uma regra de armazenamento cobre a maior parte dos problemas: junto de cada valor convertido, mantenha o valor original, a moeda, a taxa, a fonte e o carimbo de data e hora. Sistemas que armazenam somente o valor convertido não conseguem responder por que um número mudou, e essa pergunta sempre chega em algum momento.
Onde a coleta se encaixa e quais são os limites?
Use fontes oficiais para taxas de referência. Os bancos centrais as publicam abertamente e em formato legível por máquina. Fazer scraping de um site financeiro para obter um número que um banco central publica como uma API só traz desvantagens: pior confiabilidade, pior procedência e uma questão de termos que você não precisava ter.
Dados de mercado envolvem licenciamento. Taxas institucionais ao vivo são um produto licenciado com termos de redistribuição, da mesma forma que dados do mercado de ações. Um feed gratuito para exibição raramente é licenciado para revenda ou uso voltado ao cliente.
Pares de criptomoedas são um problema diferente. Eles são negociados em muitos mercados a preços realmente diferentes, portanto uma única taxa é uma escolha editorial sobre quais mercados incluir e como ponderá-los. Diga qual escolha você fez.
Onde uma solicitação fixada em um país ajuda é em um caso restrito: alguns portais oficiais e sites financeiros regionais restringem ou localizam o acesso pela origem. A solução residencial da DataImpulse cobre isso por $1 por GB em 195 países. A própria taxa deve vir do publicador oficial.
Relacionado: licenciamento de dados de mercado, web scraping é legal.
Perguntas frequentes
Por que duas APIs de moedas retornam taxas diferentes?
Porque as principais moedas são negociadas no mercado de balcão sem uma bolsa central, então cada taxa publicada é a agregação de uma fonte em um instante. Duas APIs consultadas com um segundo de diferença podem divergir de forma justificada, por isso a fonte autorizada deve ser escolhida por finalidade e registrada.
Qual taxa de câmbio devo usar para contabilidade?
Uma taxa de referência de banco central, armazenada com sua data. Ela é publicada uma vez por dia em um horário fixo, é estável e citável, e é o que os auditores esperam. É a escolha errada para a precificação no checkout, pois não corresponderá ao que o cliente realmente paga.
Por que o banco do meu cliente cobra um valor diferente?
Porque a taxa de mercado médio não tem spread, mas uma transação real tem. Redes de cartões e provedores de pagamento aplicam a própria taxa mais uma margem, portanto exibir a taxa de mercado médio no checkout garante uma diferença entre os valores exibido e cobrado.
Devo fazer scraping de taxas de câmbio em sites financeiros?
Não. Os bancos centrais publicam taxas de referência abertamente em formato legível por máquina, e as taxas institucionais de mercado são produtos licenciados com termos de redistribuição. O scraping oferece pior procedência e confiabilidade para dados que já estão disponíveis de forma adequada.
O que devo armazenar com um valor convertido?
O valor original e a moeda, a taxa aplicada, a fonte dessa taxa e o carimbo de data e hora. Sem os cinco elementos, um valor histórico não pode ser reproduzido nem explicado, e reconverter o histórico armazenado com uma taxa atual reescreve silenciosamente relatórios anteriores.
Acesse publicadores oficiais da região certa
Alguns portais financeiros oficiais e regionais localizam ou restringem o acesso pela origem. Os proxies residenciais DataImpulse oferecem saídas fixadas em um país por $1 por GB em 195 países. Crie uma conta e verifique uma fonte a partir da própria região dela.
Relacionado: APIs de dados do mercado de ações · portais de dados públicos · web scraping é legal.
Última atualização: 17 de setembro de 2026.