Calculadora de taxa cruzada

O que uma taxa de câmbio cruzada mede e como a triangulação funciona

Se ambas as cotações são expressas como unidades dessa moeda por uma unidade da base, uma unidade da moeda de origem vale um dividido por from_rate unidades da base, e esse montante em base compra to_rate dividido por from_rate unidades da moeda de destino. Se ambas as cotações são expressas em vez disso como unidades da base por uma unidade da moeda — a convenção de muitas telas de dólar por euro e dólar por iene —, a identidade se inverte: a taxa cruzada é from_rate dividido por to_rate.

Contrato de entrada, convenções de cotação e campos da resposta

Ambas as taxas e o valor devem ser estritamente maiores que zero: uma cotação nula ou negativa tornaria o par implícito indefinido ou inverteria a economia de uma troca, e um valor não positivo é rejeitado pelo mesmo domínio de sala de aula. Envie por POST um corpo JSON com dois números finitos obrigatórios: from_rate, a cotação da moeda de origem contra a base compartilhada, e to_rate, a cotação da moeda de destino contra essa mesma base. Opcionalmente envie amount como a quantidade de origem a converter (padrão um), quote como units_per_base ou base_per_unit (padrão units_per_base), e decimals como um inteiro de zero a doze (padrão seis) para controlar o arredondamento half-up em cada campo numérico. Campos ausentes, cadeias vazias, valores não finitos, um token de quote desconhecido e decimals não inteiros fora do intervalo permitido falham com invalid_input e não são cobrados. Aceitam-se aliases comuns: source_rate, rate_from ou from_vs_base para from_rate; dest_rate, target_rate, rate_to ou to_vs_base para to_rate; qty ou quantity para amount; quote_mode ou convention para quote. Em caso de sucesso o corpo devolve as entradas ecoadas, quote, cross_rate como unidades de destino por uma unidade de origem, inverse_rate como o recíproco, converted como amount vezes a taxa cruzada, base_value como o valor de origem expresso na base, e formula. Exemplo: from_rate 0.92, to_rate 150, amount 200, quote units_per_base produz um cruzamento perto de 163 unidades de destino por unidade de origem, porque 150 dividido por 0.92 é a identidade iene-por-euro quando as duas pernas são cotadas por dólar. Combine os números com o seu próprio feed ao vivo se precisar de um mid com carimbo de tempo; este endpoint calcula apenas o par implícito a partir das duas taxas que você já tem.

Onde uma API de taxa de câmbio cruzada justifica o seu lugar

Planejadores de viagem e roteiros de vários países usam uma calculadora de taxa de câmbio cruzada para que um orçamento escrito em euros possa ser reexpresso em ienes, pesos ou libras a partir de duas cotações contra o dólar, sem esperar um par dedicado que um cartão de embarque ou uma fatura de albergue nunca imprime. Mesas de viagem corporativa e ferramentas de despesas precisam de um oráculo determinístico que rejeite uma cotação nula em vez de inventar uma conversão oca que uma planilha defeituosa poderia tratar como paridade. Validação falha não consome saldo. Geradores de provas e listas de economia aberta pedem a identidade triangular nas duas convenções de cotação; fixar a aritmética em uma API parse pequena evita a deriva de planilhas no gabarito. 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 as requisições pequenas, fixe nos testes os campos arredondados cross_rate e converted, e você obtém pares implícitos reproduzíveis para lição de casa, plugins LMS e workers na borda sem montar um duto de FX ao vivo nem confundir esta identidade com uma taxa real de poder de compra.