Calculadora de paridade do poder de compra

Contrato de entrada, convenção de cotação e valoração de mercado opcional

Ambos os preços devem ser estritamente maiores que zero: um preço de cesta nulo ou negativo tornaria a taxa implícita indefinida ou sem sentido, e uma taxa de mercado não positiva é rejeitada pelo mesmo domínio de sala de aula. Envie por POST um corpo JSON com dois números finitos obrigatórios: domestic_price (preço da cesta interna P) e foreign_price (preço da cesta externa P*). De forma opcional envie market_rate como a cotação nominal observada na mesma direção —moeda interna por uma unidade externa— e decimals como inteiro de zero a doze (padrão seis) para controlar o arredondamento half-up em cada campo calculado. Campos ausentes, cadeias vazias, valores não finitos e decimals não inteiros fora do intervalo permitido falham com invalid_input e não são cobrados. Aceitam-se aliases habituais: p_home, p_domestic, home_price, local_price ou p para domestic_price; p_foreign, p_star, abroad_price ou p_star_foreign para foreign_price; e, spot, nominal, fx_rate, exchange_rate ou nominal_rate para market_rate. Em caso de sucesso o corpo devolve os preços ecoados (arredondados), ppp_rate como interno sobre externo, inverse_ppp_rate como externo sobre interno, e formula. Quando market_rate está presente o corpo inclui também essa cotação, valuation_percent como (ppp_rate menos market_rate) sobre market_rate vezes cem —o sinal padrão do Big Mac Index, negativo quando a moeda interna está barata em relação à cesta— e valuation_band como domestic_undervalued, at_ppp ou domestic_overvalued. Exemplo: interno cinquenta, externo cinco produz ppp_rate dez e inverse_ppp_rate zero ponto um; acrescente market_rate vinte e valuation_percent é menos cinquenta com domestic_undervalued. Omita market_rate e essas três chaves de valoração são omitidas, nunca null.

Onde uma API de taxa de câmbio PPC justifica o uso

Cursos de economia aberta de princípios e intermediários usam uma calculadora de paridade do poder de compra para que os alunos convertam qualquer par válido de preços de cesta na taxa de câmbio implícita sem tomar emprestada uma cotação de mercado que nunca lhes foi dada e sem confundir a identidade com a taxa de câmbio real e vezes P-star sobre P. 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 um número de paridade oco que um corretor defeituoso poderia tratar como um-para-um. Validação falha não consome saldo. Cadernos de comércio e macro costumam reconstruir tabelas didáticas no estilo Big Mac ou ICP a partir de preços locais publicados; fixar a aritmética numa API parse pequena evita a deriva da planilha na coluna de taxa implícita e torna reproduzível em CI o desvio de valoração opcional. 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 e sem rede de saída. Mantenha os pedidos pequenos, fixe nos testes o ppp_rate arredondado e, quando enviar uma cotação de mercado, valuation_percent, e você obtém números de paridade implícita reproduzíveis para lição de casa, plugins LMS e workers na borda sem montar um pipeline próprio de pesquisa de preços em vários países.