> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bunny.build/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /currency-exchange

> Obtenha taxas de câmbio em tempo real entre mais de 160 moedas, com a cotação atual, valor convertido e timestamp da última atualização.

## 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**

```json theme={null}
{
  "from": "USD",
  "to": "BRL",
  "rate": 5.42,
  "updated_at": "2024-01-15T12:00:00Z"
}
```

### 401 Unauthorized

```json theme={null}
{
  "detail": "Missing API key. Include X-API-Key header."
}
```

### 402 Payment Required

```json theme={null}
{
  "detail": "Monthly quota exceeded. Upgrade your plan."
}
```

### 422 Unprocessable Entity

Código de moeda inválido.

```json theme={null}
{
  "detail": "Invalid currency code"
}
```

### 429 Too Many Requests

```json theme={null}
{
  "detail": "Rate limit exceeded. Try again in 60 seconds."
}
```

## Exemplo cURL

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