Metodologia de câmbio

O cluster de câmbio oferece 50 pares de câmbio ao vivo com base nas taxas de mercado médio publicadas pelo Banco Central Europeu. O caminho dos dados é intencionalmente simples: o BCE publica taxas de referência diárias; a API Frankfurter de código aberto as republica como JSON; armazenamos o resultado em cache com ISR do Next.js por uma hora. Sem spread proprietário, sem agregação entre provedores.

A fonte de dados: taxas diárias de referência do BCE

O Banco Central Europeu publica taxas de câmbio de referência do euro em relação a ~32 moedas a cada dia bancário às 16h00 CET. São taxas de mercado médio derivadas de uma concertação entre bancos centrais da UE; não são transacionáveis, mas são o benchmark de referência canônico.

Para pares não EUR (USD → GBP, JPY → TRY) triangulamos via EUR: USD/EUR × EUR/GBP resulta em USD/GBP. A triangulação é algebricamente exata e é o que o Frankfurter calcula internamente.

A estratégia de cache

As taxas de câmbio são atualizadas no máximo uma vez por dia (o BCE não publica taxas nos fins de semana), então um cache de 1 hora é generoso. Usamos regeneração estática incremental do Next.js:

• Primeiro pedido para uma página de câmbio: servidor busca do Frankfurter, renderiza, armazena em cache.
• Pedidos seguintes dentro de 1 hora: HTML em cache, abaixo de 100ms.
• Após 1 hora: o próximo pedido recebe imediatamente a página antiga, disparando uma atualização em segundo plano.

Spread vs a taxa que você realmente obterá

A taxa de mercado médio é a taxa que dois bancos usariam para transacionar. Você — um cliente de varejo — não obterá essa taxa. Seu custo real inclui um spread por cima:

• Redes de cartão (Visa, Mastercard): tipicamente 0,2-1% acima do mercado médio.
• Bancos emissores adicionando seu próprio spread: comum nos EUA; 1-3% adicionais por cima da taxa de rede.
• Taxas de conversão de moeda em caixas eletrônicos e terminais POS (DCC): spread de 3-8%. Sempre recuse se solicitado a pagar em sua moeda doméstica no exterior.
• Provedores especializados de câmbio (Wise, Revolut): 0,3-1% acima do mercado médio, sem DCC. Mais próximos da taxa de referência entre as opções de varejo.
• Bancos tradicionais para transferências: spread de 2-5%. O pior entre as opções comuns de varejo.

Detalhes do algoritmo: resolução e triangulação de taxas

1. Normalizar ambas as moedas para códigos ISO 4217 de três letras e validar contra a lista suportada (~32 moedas — cada código da série de referência do BCE).
2. Buscar o conjunto de taxas mais recente baseado em EUR do cache do Frankfurter (TTL de 1 hora via ISR). O payload é um mapa { "USD": 1.0865, "GBP": 0.8479, ... } todos cotados como 1 EUR = X alvo.
3. Triangular se nenhum lado é EUR. Para JPY → TRY: taxa_JPY_TRY = taxa_EUR_TRY / taxa_EUR_JPY.
4. Calcular a conversão. saída = entrada × taxa_de_para. O display arredonda para 4 casas decimais para saídas no estilo FX.
5. Carimbar os metadados da resposta com rateDate (a data de publicação do BCE) e source(“BCE via Frankfurter”).

Pressupostos e limitações

• Apenas triangulação com pivot EUR. Se ambas as moedas não são EUR e a série do BCE não cobre uma delas em uma determinada data, o conversor retorna a taxa do dia útil anterior mais próximo.
• Dados apenas em dias úteis. O BCE não publica nos fins de semana ou feriados TARGET. Pedidos de fim de semana retornam a taxa de sexta-feira; o camporateDate sinaliza isso.
• Sem dados de mercado em tempo real tick a tick. A taxa de referência do BCE é um fixing diário de mercado médio, não uma cotação em streaming.
• Sem modelagem de spread. A taxa exibida é de mercado médio com spread bid/ask zero. Conversão de varejo real tipicamente paga 0,3-4% acima do mercado médio.
• Sem criptomoedas. BTC, ETH e stablecoins ficam em /crypto/ e usam uma metodologia e fonte de dados diferente.
• Taxas históricas limitadas à cobertura do BCE (1999-presente). Conversão de moedas pré-euro (DEM, FRF, ITL) requer uma tabela separada de taxas de conversão fixas.