GET /currency-exchange

Endpoint

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

Autenticação

Header	Obrigatório	Valor
`X-API-Key`	Sim	Sua 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âmetro	Tipo	Obrigatório	Descrição
`from`	string	Sim	Código da moeda de origem (ISO 4217, ex.: `USD`)
`to`	string	Sim	Código da moeda de destino (ISO 4217, ex.: `BRL`)

Resposta

200 OK

Campo	Tipo	Descrição
`from`	string	Código da moeda de origem
`to`	string	Código da moeda de destino
`rate`	number	Taxa de câmbio (1 unidade de `from` em `to`)
`updated_at`	string	Timestamp 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"

Introdução

Referência da API

GET /currency-exchange

Endpoint

Autenticação

Visão geral

Casos de uso

Detalhes

Parâmetros de query

Resposta

200 OK

401 Unauthorized

402 Payment Required

422 Unprocessable Entity

429 Too Many Requests

Exemplo cURL

​Endpoint

​Autenticação

​Visão geral

​Casos de uso

​Detalhes

​Parâmetros de query

​Resposta

​200 OK

​401 Unauthorized

​402 Payment Required

​422 Unprocessable Entity

​429 Too Many Requests

​Exemplo cURL

Endpoint

Autenticação

Visão geral

Casos de uso

Detalhes

Parâmetros de query

Resposta

200 OK

401 Unauthorized

402 Payment Required

422 Unprocessable Entity

429 Too Many Requests

Exemplo cURL