C
CurrencyRest

Endpoints

All endpoints are read-only (GET), return JSON and are versioned under /v1. Base URL: https://api.currencyrest.com/v1

The source parameter

Without source, the rate comes from the highest-priority source available for the pair (default mode), with cross-rate calculation via USD/EUR when needed. With source, the rate comes strictly from that source — never a silent fallback. Sources: ecb, boe, fed, boj, fixed, binance, google-finance, tradingview, google-search.

GET/convert

Convert an amount

Convert an amount from one currency to another.

fromstring · requiredSource currency (e.g. EUR)
tostring · requiredTarget currency (e.g. USD)
amountnumber · requiredAmount to convert
sourcestringSpecific source (optional)
Requestbash
curl "https://api.currencyrest.com/v1/convert?from=EUR&to=USD&amount=100" \
  -H "X-API-Key: your_api_key"
200 OKjson
{
  "from": "EUR",
  "to": "USD",
  "amount": 100,
  "result": 116.07,
  "rate": 1.1607,
  "source": "ecb",
  "timestamp": "2026-06-16T00:00:00.000Z"
}
GET/rates

All rates for a base

Returns all available rates for a base currency.

basestringBase currency (default USD)
sourcestringFilter to one source
200 OKjson
{
  "base": "EUR",
  "source": "default",
  "timestamp": "2026-06-16T09:00:00.000Z",
  "rates": { "USD": 1.1607, "GBP": 0.8648, "JPY": 186.1, "EUR": 1 }
}
GET/rates/pair

Single pair rate

fromstring · requiredSource currency
tostring · requiredTarget currency
sourcestringSpecific source
200 OKjson
{ "from": "EUR", "to": "GBP", "rate": 0.86483, "source": "ecb", "timestamp": "2026-06-15T00:00:00.000Z" }
GET/rates/sources

Sources for a pair

Lists the sources that currently have a rate for the pair.

200 OKjson
{ "from": "EUR", "to": "USD", "sources": ["ecb", "google-finance", "tradingview"] }
GET/historical

Historical series

fromstring · requiredSource currency
tostring · requiredTarget currency
sourcestringFilter to one source
startDateISO dateRange start
endDateISO dateRange end
limitnumberNumber of points (max 5000)
200 OKjson
{
  "from": "EUR",
  "to": "USD",
  "source": "all",
  "count": 2,
  "points": [
    { "rate": 1.1607, "source": "ecb", "timestamp": "2026-06-15T00:00:00.000Z" },
    { "rate": 1.1612, "source": "tradingview", "timestamp": "2026-06-14T17:00:00.000Z" }
  ]
}
GET/status

Source status

Live health of each source (operational / degraded / outage). Public, no key required.

200 OKjson
{
  "overall": "operational",
  "sources": [
    { "source": "ecb", "status": "operational", "latencyMs": 95, "lastCheckedAt": "..." },
    { "source": "binance", "status": "operational", "latencyMs": 290, "lastCheckedAt": "..." }
  ],
  "services": []
}

Next Steps