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

# Empezar con la API de tipos de cambio V2

> Crea una API key, consulta GET /v2/fx/{CC}/rates y aprende a leer IDs, fechas, errores y disponibilidad de Cotizave V2.

V2 usa IDs de tasa como `co-trm` y rutas bajo `https://api.cotizave.com/v2/`. Genera una API key en el [dashboard](https://app.cotizave.com) y úsala desde tu servidor.

## Primera petición

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

Respuesta ilustrativa; los valores no son cotizaciones actuales:

```json theme={null}
{
  "country": "CO",
  "currency": "COP",
  "base": "USD",
  "fetched_at": "2026-11-03T12:00:00Z",
  "plan": "free",
  "rates": [
    { "id": "co-trm", "market": "co_trm", "type": "reference", "mid": 3900.12, "updated_at": "2026-11-03T00:00:00Z" }
  ]
}
```

Usa el `id` recibido para consultar una tasa, su histórico o una conversión. Los campos disponibles dependen del plan.

## Continuar

* [Tasas por país y por ID](https://docs.cotizave.com/api/v2/rates.md)
* [Histórico, estadísticas y medias móviles](https://docs.cotizave.com/api/v2/history.md)
* [Conversión individual y por lote](https://docs.cotizave.com/api/v2/convert.md)
* [Todas las rutas V2](https://docs.cotizave.com/api/v2/endpoints.md)
* [Planes y campos](https://docs.cotizave.com/api/v2/plans.md)
* [Autenticación, formatos y errores](https://docs.cotizave.com/api/authentication.md)

Si integras con un agente de programación, usa la [skill de Cotizave](https://docs.cotizave.com/agent-skill.md). Para migrar desde Venezuela V1, consulta [V1 → V2](https://docs.cotizave.com/api/v2/migration.md).


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