Pular para o conteúdo principal

​
Endpoint

GET https://api.bunny.build/api/v1/currency-exchange?from=USD&to=BRL

​
Autenticação

HeaderObrigatórioValor
X-API-KeySimSua chave de API (bun_...)

​
Visão geral

Obtenha taxas de câmbio em tempo real entre quaisquer duas moedas. A API de Câmbio da Bunny suporta mais de 160 moedas e retorna a cotação atual do mercado intermediário, o valor convertido e o timestamp da última atualização das taxas.

​
Casos de uso

  • Exibir preços na moeda local do visitante
  • Processar pagamentos e faturas em múltiplas moedas
  • Criar widgets de conversão de moedas
  • Sincronizar preços de inventário entre mercados

​
Detalhes

As taxas são atualizadas frequentemente e armazenadas em cache por até 60 minutos. Informe from e to como códigos ISO 4217 (ex.: USD, BRL, EUR). Passe opcionalmente amount para obter o valor convertido diretamente.

​
Parâmetros de query

ParâmetroTipoObrigatórioDescrição
fromstringSimCódigo da moeda de origem (ISO 4217, ex.: USD)
tostringSimCódigo da moeda de destino (ISO 4217, ex.: BRL)

​
Resposta

​
200 OK

CampoTipoDescrição
fromstringCódigo da moeda de origem
tostringCódigo da moeda de destino
ratenumberTaxa de câmbio (1 unidade de from em to)
updated_atstringTimestamp da taxa (ISO 8601)
Exemplo 
{
  "from": "USD",
  "to": "BRL",
  "rate": 5.42,
  "updated_at": "2024-01-15T12:00:00Z"
}

​
401 Unauthorized

{
  "detail": "Missing API key. Include X-API-Key header."
}

​
402 Payment Required

{
  "detail": "Monthly quota exceeded. Upgrade your plan."
}

​
422 Unprocessable Entity

Código de moeda inválido. 
{
  "detail": "Invalid currency code"
}

​
429 Too Many Requests

{
  "detail": "Rate limit exceeded. Try again in 60 seconds."
}

​
Exemplo cURL

curl "https://api.bunny.build/api/v1/currency-exchange?from=USD&to=BRL" \
  -H "X-API-Key: bun_sua_chave_api"