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

# Official exchange rates by currency API

> Use GET /v2/fx/rates for a currency-keyed map of available official references, optional symbols, and base-currency rules.

`GET /v2/fx/rates` returns available official rates keyed by quote currency. Countries sharing a currency share one key. It requires an API key and counts as one request. `symbols` filters quote currencies; `base` defaults to USD and can only be changed on paid plans.

```bash curl theme={null}
curl "https://api.cotizave.com/v2/fx/rates?symbols=BRL" \
  -H "X-API-Key: $COTIZAVE_API_KEY"
```

Illustrative response for `symbols=BRL`; value and timestamps are samples:

```json theme={null}
{
  "base": "USD",
  "date": "2026-11-03T15:00:00Z",
  "rates": {
    "BRL": 5.12
  }
}
```

`400 invalid_format` means the base currency is not published; `402 feature_not_in_plan` means the plan cannot change it. A currency without a current official observation is omitted from `rates`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.