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

# Convert currencies with a selected rate ID

> Call GET /v2/fx/convert with from, to, amount, and via to convert using the selected rate reference.

```bash curl theme={null}
curl "https://api.cotizave.com/v2/fx/convert?from=USD&to=COP&amount=100&via=co-trm" \
  -H "X-API-Key: $COTIZAVE_API_KEY"
```

```json theme={null}
{
  "from": {
    "currency": "USD",
    "amount": 100
  },
  "to": {
    "currency": "COP",
    "amount": 390012
  },
  "rate": 3900.12,
  "via": "co-trm",
  "type": "reference",
  "updated_at": "2026-10-25T00:00:00Z",
  "staleness_sec": 43200,
  "stale": false,
  "market": "co_trm"
}
```

`from`, `to`, and `amount` are required; `via` selects a rate ID. Without `via`, the compatible default reference is used.


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