Calculadora da taxa de câmbio real

Contrato de entrada, campos de resposta e regras de validação

Opcionalmente envie decimals como inteiro de zero a doze (padrão seis) para controlar o arredondamento half-up em cada campo calculado. Os três níveis devem ser estritamente maiores que zero: um preço nulo ou negativo tornaria a razão indefinida ou sem sentido para a comparação de poder de compra, e uma taxa nominal não positiva é rejeitada pelo mesmo domínio de sala de aula. Envie por POST um corpo JSON com três números finitos obrigatórios: nominal_rate (moeda interna por uma unidade externa), domestic_price (nível de preços do país P) e foreign_price (nível de preços do exterior P*). Campos ausentes, strings vazias, valores não finitos e decimals não inteiros fora do intervalo permitido falham com invalid_input e não são faturados. Aliases comuns são aceitos: e, spot, nominal, fx_rate ou exchange_rate para nominal_rate; p_home, p_domestic, home_price ou p para domestic_price; p_foreign, p_star, abroad_price ou p_star_foreign para foreign_price. Em caso de sucesso o corpo devolve as entradas ecoadas (arredondadas), price_ratio como exterior sobre interior, real_exchange_rate como nominal vezes essa razão, ppp_gap_percent como (price_ratio menos um) vezes cem, price_level_band como rótulo grosso de sala (domestic_prices_higher, equal_price_levels ou foreign_prices_higher), e formula. Exemplo: nominal vinte, interior cem e exterior cento e vinte produz price_ratio um ponto dois, taxa de câmbio real vinte e quatro, ppp_gap_percent vinte e foreign_prices_higher. Combine os números com sua própria tabela plurianual se precisar da apreciação real período a período como variação percentual da taxa real; este endpoint calcula apenas o nível para um triplo único e não re-basa séries históricas nem converte o IPC em deflatores do PIB.

Onde uma API de taxa de câmbio real agrega valor

Cursos de economia aberta de princípios e intermediários usam uma calculadora da taxa de câmbio real para que o alunado converta qualquer taxa nominal válida e dois níveis de preços na medida canônica de preços relativos sem confundir convenções de cotação nem misturar apenas o IPC com o câmbio à vista. Geradores de provas e plugins de LMS precisam de um oráculo determinístico que rejeite preços nulos ou negativos em vez de inventar uma taxa real vazia que um corretor defeituoso poderia tratar como paridade. Validação falha não consome saldo. Cadernos de comércio e macro costumam recalcular tabelas do manual a partir do IPC publicado e cotações de mercado; fixar a aritmética em uma API parse diminuta evita a deriva de planilhas na coluna de comparação. Como a implementação é parse pura de nível A, cada chamada bem-sucedida custa o preço-base publicado US$ 0,002 sem tokens de modelo nem rede de saída. Mantenha as requisições pequenas, fixe nos testes os campos arredondados real_exchange_rate e ppp_gap_percent, e você obtém números reproduzíveis de poder de compra relativo para lição de casa, plugins LMS e workers na borda sem montar um pipeline completo de contas nacionais multi-país.