> ## 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 a rate with the official reference

> Use GET /v2/fx/{CC}/spread with against to compare a selected rate with its country’s official reference.

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

Illustrative response; sample figures and dates.

```json theme={null}
{
  "country": "CO",
  "reference": {
    "id": "co-trm",
    "market": "co_trm",
    "value": 3900.12,
    "updated_at": "2026-10-25T00:00:00Z"
  },
  "compared": {
    "id": "co-p2p",
    "market": "co_p2p",
    "value": 4001.55,
    "updated_at": "2026-10-25T11:55:00Z"
  },
  "spread": {
    "absolute": 101.43,
    "percentage": 2.6007,
    "direction": "above"
  },
  "fetched_at": "2026-10-25T12:00:00Z"
}
```

`against` selects the comparison rate; if omitted, the API chooses a compatible alternative. Requires Growth or Pro.


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