Convert with a historical exchange rate - Cotizave

Add date=YYYY-MM-DD to GET /v2/fx/convert. It requires Growth or Pro and a rate with history within your plan’s retention.

curl

curl "https://api.cotizave.com/v2/fx/convert?from=USD&to=COP&amount=2&via=co-trm&date=2026-11-03" \
  -H "X-API-Key: $COTIZAVE_API_KEY"

Illustrative response; replace the date with one within your plan’s retention:

{
  "from": { "currency": "USD", "amount": 2 },
  "to": { "currency": "COP", "amount": 7800.24 },
  "rate": 3900.12,
  "via": "co-trm",
  "market": "co_trm",
  "type": "reference",
  "updated_at": "2026-11-03T00:00:00Z",
  "effective_date": "2026-11-03",
  "date": "2026-11-03",
  "staleness_sec": 0,
  "stale": false
}

Store date, via, and updated_at with the calculated amount. A date outside retention returns 403 history_out_of_retention.