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

# API de tasas oficiales por moneda

> Consulta GET /v2/fx/rates para obtener referencias oficiales en un mapa por moneda, filtrar symbols y revisar el plan para cambiar la base.

`GET /v2/fx/rates` devuelve las tasas oficiales disponibles, indexadas por moneda cotizada. Los países que comparten moneda comparten una clave. Requiere API key y cuenta como una consulta. `symbols` filtra monedas cotizadas; `base` predetermina a USD y solo se puede cambiar en planes pagos.

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

Respuesta ilustrativa para `symbols=BRL`; el valor y las fechas son ficticios:

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

`400 invalid_format` indica una base no publicada; `402 feature_not_in_plan`, que el plan no permite cambiarla. Una moneda sin observación oficial actual no aparece en `rates`.


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