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

# Compare currency-conversion routes by API

> Use GET /v2/fx/{CC}/route to rank available conversion alternatives; the endpoint does not execute payments.

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

Illustrative response; sample figures and dates.

```json theme={null}
{
  "country": "CO",
  "from": {
    "currency": "USD",
    "amount": 100
  },
  "direction": "receive",
  "best": {
    "id": "co-p2p",
    "market": "co_p2p",
    "type": "p2p",
    "rate": 4001.55,
    "amount": 400155,
    "updated_at": "2026-10-25T11:55:00Z",
    "staleness_sec": 300
  },
  "alternatives": [
    {
      "id": "co-trm",
      "market": "co_trm",
      "type": "reference",
      "rate": 3900.12,
      "amount": 390012,
      "updated_at": "2026-10-25T00:00:00Z",
      "staleness_sec": 43200
    }
  ],
  "skipped": [],
  "fetched_at": "2026-10-25T12:00:00Z"
}
```

Requires Pro. `direction` accepts `send` or `receive`; `max_staleness` excludes rates that are too old.


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