ForHosting KIT · Ferramentas para dev

Calculadora de taxa de câmbio cruzada por moeda comum

Uma taxa de câmbio cruzada relaciona duas moedas cotadas contra a mesma terceira moeda.

● BetaGrátis · no seu navegador
Use pelo WebAPIE-mailTelegramApp em breve

Informe os códigos da moeda-base e da moeda de cotação, identifique a moeda comum e indique quantas unidades dela equivalem a uma unidade de cada moeda. A calculadora divide cotações compatíveis para obter quantas unidades da moeda de cotação correspondem a uma unidade da moeda-base, além da taxa inversa. Ela valida os códigos e rejeita taxas iguais a zero antes da divisão. O uso automatizado da API custa US$ 0,002 por solicitação.

Leia as duas taxas de entrada na mesma direção

Um cálculo cruzado confiável começa pela direção da cotação. Esta calculadora espera a mesma convenção nas duas taxas: unidades da moeda comum para uma unidade da moeda indicada. Por exemplo, se a moeda-base for EUR, a moeda de cotação for GBP e a moeda comum for USD, base_rate significa USD por EUR e quote_rate significa USD por GBP. Não informe uma taxa em USD por EUR e outra em GBP por USD, pois elas apontam em sentidos opostos e não podem ser divididas diretamente. Os códigos são convertidos para maiúsculas, mas precisam conter exatamente três letras. A moeda comum deve ser diferente das duas moedas cruzadas, que também devem ser distintas entre si. Assim, cross_rate sempre informa unidades da moeda de cotação por uma unidade da moeda-base, enquanto inverse_rate informa a direção inversa. Antes de calcular, anote as unidades ao lado de cada taxa; denominadores iguais mostram que as cotações são compatíveis.

Entenda a divisão e a taxa inversa

Quando as duas cotações têm a moeda comum no numerador, essa unidade é cancelada na divisão. A calculadora divide base_rate por quote_rate. Se um EUR valer 1.08 USD e um GBP valer 1.26 USD, dividir 1.08 USD por EUR por 1.26 USD por GBP cancela USD e deixa GBP por EUR. A taxa inversa é calculada separadamente como quote_rate dividido por base_rate, resultando em EUR por GBP. Exibir as duas direções ajuda a evitar um erro operacional frequente: aplicar ao contrário uma taxa correta em uma fatura, um livro contábil ou uma planilha. A fórmula exibida registra a ordem das moedas, preservando a interpretação do valor quando ele é copiado. O arredondamento serve apenas para estabilizar os dígitos significativos no JSON; não define uma precisão de mercado. Para liquidação ou contabilidade, aplique depois a política de casas decimais e arredondamento exigida pela sua instituição.

Valide os dados de origem antes de usar o resultado

Uma taxa cruzada só é tão atual e confiável quanto suas duas cotações de origem. Esta capacidade não acessa a rede nem afirma que os valores informados sejam preços de mercado ao vivo. Em processos financeiros, use taxas do mesmo provedor, horário de avaliação, convenção de mercado e categoria. Misturar uma taxa de venda ao varejo com uma taxa média interbancária pode produzir um cruzamento matematicamente válido, porém comercialmente enganoso. Os dois valores devem ser números finitos maiores que zero. O zero gera um erro de entrada específico; valores negativos ou não numéricos também são rejeitados. Como o cálculo é determinístico, a mesma entrada JSON sempre produz a mesma saída. Se a auditoria for importante, guarde as duas cotações originais, a fonte e o horário junto ao resultado. Lembre-se ainda de que uma taxa teórica pode diferir de uma oferta executável devido a spreads, tarifas, liquidez, valores mínimos e arredondamento, que não fazem parte desta calculadora.

Criar uma taxa cruzada em uma planilha

Confira a taxa entre duas moedas quando a planilha já contém a cotação compatível de cada uma contra uma moeda comum.

Conciliar registros em várias moedas

Obtenha um fator de conversão coerente para comparar valores contábeis vindos da mesma tabela de taxas da moeda de relatório.

Verificar uma conversão cotada

Compare a taxa cruzada de uma instituição ou sistema com o valor matemático implícito antes de considerar spreads e tarifas.

Quanto custa a solicitação à API?

Cada solicitação à API custa US$ 0,002. O cálculo também está disponível no navegador para o uso gratuito compatível.

Qual direção as taxas devem seguir?

As duas devem indicar unidades da moeda comum por uma unidade da moeda-base ou da moeda de cotação correspondente.

Por que taxas iguais a zero são rejeitadas?

Uma taxa zero não tem significado neste cálculo e faria uma das direções exigir divisão por zero.

A ferramenta busca preços cambiais em tempo real?

Não. Ela usa somente as taxas fornecidas por você e não faz solicitações de rede.

O que significa cross_rate?

É o número de unidades da moeda de cotação equivalente a uma unidade da moeda-base.

Tarifas ou spreads de compra e venda estão incluídos?

Não. O resultado é o cruzamento aritmético implícito nas entradas; tarifas, spreads e regras de liquidação são separados.

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

POSThttps://api.kit.forhosting.com/econ/cross-exchange-rate

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

curl -X POST https://api.kit.forhosting.com/econ/cross-exchange-rate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"base_currency":"EUR","quote_currency":"GBP","common_currency":"USD","base_rate":1.08,"quote_rate":1.26}'
{
  "base_currency": "EUR",
  "quote_currency": "GBP",
  "common_currency": "USD",
  "base_rate": 1.08,
  "quote_rate": 1.26
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "econ.cross_exchange_rate",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →