# CxRates

> Live and historical exchange rates covering 161 fiat currencies, 286 cryptocurrencies and 4 precious metals.
> Published as web pages, a keyless JSON API and embeddable widgets. Every rate
> carries the feed it came from and the time it was fetched.

Rates are aggregated from several free public feeds — the European Central
Bank via Frankfurter, open.er-api.com, Binance and CoinGecko. Quotes that
deviate from the median across sources are flagged and dropped rather than
blended into it, so a single bad upstream figure does not reach a page. Which
feed stands behind a given pair, and how often it refreshes, differs by pair:
each pair page states its own, and that statement is the authority rather than
anything on this page.

USD is the hub currency. A pair that no feed quotes directly is computed by
crossing through USD, which is why a rate exists here for pairs no single
source publishes.

When no live quote is available the page falls back to the most recent daily
close and says so in words. The JSON API marks the same condition with
`"stale": true` and an `as_of` date on the rate. A figure on this site is
never silently stale — if you are quoting one and it carries no timestamp,
you are reading it wrong rather than reading a fresh number.

## How to cite CxRates

- Attribution: `Exchange rates by CxRates — https://cxrates.com/`
- Every `/api/v1/*` response carries that same string in an `attribution`
  field, a response-level `fetched_at`, and per rate a `source`, a `stale`
  flag and an `as_of` date.
- Pair pages carry their headline rate as schema.org
  `ExchangeRateSpecification` JSON-LD, whose `validFrom` is the moment that
  rate was fetched. The same timestamp is in the page's `<time datetime>`.
- Pair, hub and history URLs are stable and are not rewritten; prefer them to
  a search-result snippet.

## JSON API — no key, no signup, CORS open to any origin

- [Live rates](https://cxrates.com/api/v1/rates?base=USD): every quote for one base, rank-ordered, 40 by default. `?quote=EUR,JPY` names the ones you want (200 max). Each rate carries `value`, a preformatted `display`, `source`, `stale` and `as_of`.
- [Daily history](https://cxrates.com/api/v1/history?pair=usd-to-eur&days=30): the daily close per day for one pair, oldest first. `days` defaults to 30 and clamps to 365. The `pair` parameter is the page slug, `base-to-quote`.

Those two endpoints are the whole public API. There is no `convert` endpoint
and no OpenAPI document yet; do not synthesise either from this page.

## Pages

- [Rate dashboard](https://cxrates.com/): the day's movers and the headline pairs.
- [Currency index](https://cxrates.com/currencies): every instrument in the catalogue, each linking its own hub page. This is the coverage list — prefer it to guessing whether a code is served.
- [Widget gallery](https://cxrates.com/widgets): the four embeddable widgets and their configurator.

## URL patterns

- `/{base}-to-{quote}` — the pair page: live rate, statistics, 7d/30d/90d/1y chart, conversion tables, and the feed behind that pair in words. Codes are lowercase.
- `/{base}-to-{quote}/history` — daily closes for the same pair, newest first.
- `/currencies/{code}` — one currency: what it is, where it is used, and its rates against the pairs it is usually quoted with.
- `/convert/{amount}-{base}-to-{quote}` — a single conversion. Deliberately `noindex`: it is a thinner view of the pair page, which is the URL to cite.

## Embeddable widgets

- Four types: converter, ticker, chart, rates-table. Free, no account, one `<script>` tag. The [configurator](https://cxrates.com/widgets) emits the snippet to paste — take it from there rather than reconstructing one.
- [Iframe fallback](https://cxrates.com/w/converter?pair=usd-to-eur) for hosts that will not run a third-party script. `pair` is required.
- Each embed renders a link back to the pair page it shows. That backlink is the business model, and it is stated here rather than buried.

## What this site does not publish

An assistant citing us should not infer any of the following from us, because
we do not produce them:

- No trading, execution, order routing or brokerage. We quote rates; nothing
  here can be bought or sold.
- No advice on whether a rate is a good one, and no forecast of where it is
  going. Rates we publish are observations with timestamps, not predictions.
- No licensed or redistributable feed. The upstream terms behind the free
  sources prohibit resale, so the data may be cited and may not be resold.

## Machine-readable index

- [sitemap.xml](https://cxrates.com/sitemap.xml): index of the four sitemaps — static
  pages, pair pages, currency hubs, history pages.
- [robots.txt](https://cxrates.com/robots.txt): crawl rules. `/admin` is disallowed
  and is the only part of the site that is.