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

# Consultar una tasa de cambio por ID

> Solicita GET /v2/fx/{CC}/rates/{id} y revisa el par, el valor, las fechas y los campos disponibles para tu plan.

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

El `id` permanece en minúsculas aunque el país se escriba como `CO`. El siguiente JSON ilustra **Growth**: Free y Basic reciben menos metadatos. Si la tasa está restringida, el detalle responde `402`.

```json theme={null}
{
  "id": "co-trm",
  "market": "co_trm",
  "name": "TRM",
  "description": "Tasa Representativa del Mercado (TRM) que certifica la Superintendencia Financiera: la oficial para contratos, contabilidad e impuestos. Rige por día; la de un fin de semana es la del viernes.",
  "type": "reference",
  "base": "USD",
  "quote": "COP",
  "mid": 3900.12,
  "bid": null,
  "ask": null,
  "updated_at": "2026-10-25T00:00:00Z",
  "effective_date": "2026-10-25",
  "fetched_at": "2026-10-25T12:00:00Z",
  "stale": false,
  "stale_after_sec": 475200,
  "staleness_sec": 43200,
  "tags": [
    "trm",
    "oficial"
  ],
  "available": true,
  "required_plan": "free",
  "change_24h_pct": null,
  "vs_official_pct": null
}
```

Un ID desconocido devuelve `404`; una tasa restringida por el plan, `402`; una tasa conocida sin dato actual, `503`.


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