docs / currency

Currency & FX

Exchange rates, conversion and historical rates.

base /currency/v16 endpoints

post/currency/v1/latest1 credit

latest reference rates for a base (default EUR) → all or selected target currencies (+ unix timestamp)

Parameter		Allowed / range	Description
base = EUR	optional	EUR · USD · JPY · GBP · CHF · AUD · CAD · CNY · HKD · NZD · SEK · NOK · DKK · CZK · HUF · PLN · RON · BGN · TRY · ISK · ILS · INR · IDR · KRW · MYR · PHP · SGD · THB · ZAR · MXN · BRL · RUB · HRK · GRD · CYP · EEK · LTL · LVL · MTL · SIT · SKK · ROL · TRL	Base currency the rates are expressed in (ISO-4217). Defaults to EUR. Retired codes (RUB/HRK/legacy euro-joiners) work only for historical dates that predate their discontinuation.
symbols	optional	—	Optional comma-separated target currencies to return (e.g. 'USD,GBP,JPY'). Omit to return every currency in the ECB set. Unknown codes are reported under 'unavailable', not rejected.

Try in playground →

post/currency/v1/convert1 credit

convert an amount from→to at the latest rate (or a given historical date); returns rate + result

Parameter		Allowed / range	Description
from	required	EUR · USD · JPY · GBP · CHF · AUD · CAD · CNY · HKD · NZD · SEK · NOK · DKK · CZK · HUF · PLN · RON · BGN · TRY · ISK · ILS · INR · IDR · KRW · MYR · PHP · SGD · THB · ZAR · MXN · BRL · RUB · HRK · GRD · CYP · EEK · LTL · LVL · MTL · SIT · SKK · ROL · TRL	Source currency to convert FROM (ISO-4217).
to	required	EUR · USD · JPY · GBP · CHF · AUD · CAD · CNY · HKD · NZD · SEK · NOK · DKK · CZK · HUF · PLN · RON · BGN · TRY · ISK · ILS · INR · IDR · KRW · MYR · PHP · SGD · THB · ZAR · MXN · BRL · RUB · HRK · GRD · CYP · EEK · LTL · LVL · MTL · SIT · SKK · ROL · TRL	Target currency to convert TO (ISO-4217).
amount = 1	optional	0–	Amount of the source currency to convert (default 1).
date	optional	—	Optional historical date (YYYY-MM-DD) to convert at; omit for the latest published rate.

Try in playground →

post/currency/v1/historical1 credit

reference rates on a past date (YYYY-MM-DD; weekend/holiday → last working day) since 1999-01-04

Parameter		Allowed / range	Description
date	required	—	Reference date (YYYY-MM-DD), since 1999-01-04. A weekend/holiday resolves to the last working day (echoed as requested_date).
base = EUR	optional	EUR · USD · JPY · GBP · CHF · AUD · CAD · CNY · HKD · NZD · SEK · NOK · DKK · CZK · HUF · PLN · RON · BGN · TRY · ISK · ILS · INR · IDR · KRW · MYR · PHP · SGD · THB · ZAR · MXN · BRL · RUB · HRK · GRD · CYP · EEK · LTL · LVL · MTL · SIT · SKK · ROL · TRL	Base currency the rates are expressed in (ISO-4217). Defaults to EUR. Retired codes (RUB/HRK/legacy euro-joiners) work only for historical dates that predate their discontinuation.
symbols	optional	—	Optional comma-separated target currencies to return (e.g. 'USD,GBP,JPY'). Omit to return every currency in the ECB set. Unknown codes are reported under 'unavailable', not rejected.

Try in playground →

post/currency/v1/timeseries2 credits

rates over a date range (working days) for a base → selected/all targets; {date:{CUR:val}}

Parameter		Allowed / range	Description
start	required	—	Range start date (YYYY-MM-DD, inclusive). Only ECB working days inside the range are returned.
end	required	—	Range end date (YYYY-MM-DD, inclusive).
base = EUR	optional	EUR · USD · JPY · GBP · CHF · AUD · CAD · CNY · HKD · NZD · SEK · NOK · DKK · CZK · HUF · PLN · RON · BGN · TRY · ISK · ILS · INR · IDR · KRW · MYR · PHP · SGD · THB · ZAR · MXN · BRL · RUB · HRK · GRD · CYP · EEK · LTL · LVL · MTL · SIT · SKK · ROL · TRL	Base currency the rates are expressed in (ISO-4217). Defaults to EUR. Retired codes (RUB/HRK/legacy euro-joiners) work only for historical dates that predate their discontinuation.
symbols	optional	—	Optional comma-separated target currencies to return (e.g. 'USD,GBP,JPY'). Omit to return every currency in the ECB set. Unknown codes are reported under 'unavailable', not rejected.

Try in playground →

post/currency/v1/fluctuation2 credits

per-currency change over a date range: {CUR:{start_rate,end_rate,change,change_pct}} (derived from the range endpoints)

Parameter		Allowed / range	Description
start	required	—	Range start date (YYYY-MM-DD, inclusive). Only ECB working days inside the range are returned.
end	required	—	Range end date (YYYY-MM-DD, inclusive).
base = EUR	optional	EUR · USD · JPY · GBP · CHF · AUD · CAD · CNY · HKD · NZD · SEK · NOK · DKK · CZK · HUF · PLN · RON · BGN · TRY · ISK · ILS · INR · IDR · KRW · MYR · PHP · SGD · THB · ZAR · MXN · BRL · RUB · HRK · GRD · CYP · EEK · LTL · LVL · MTL · SIT · SKK · ROL · TRL	Base currency the rates are expressed in (ISO-4217). Defaults to EUR. Retired codes (RUB/HRK/legacy euro-joiners) work only for historical dates that predate their discontinuation.
symbols	optional	—	Optional comma-separated target currencies to return (e.g. 'USD,GBP,JPY'). Omit to return every currency in the ECB set. Unknown codes are reported under 'unavailable', not rejected.

Try in playground →

post/currency/v1/currencies1 credit

the current ECB reference currency set (code → name)

Try in playground →

Example request · latest

curl -X POST https://api.reefapi.com/currency/v1/latest \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"base":"EUR"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}