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	Required
base	optional
symbols	optional

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	Required
from	required
to	required
amount	optional
date	optional

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	Required
date	required
base	optional
symbols	optional

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	Required
start	required
end	required
base	optional
symbols	optional

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	Required
start	required
end	required
base	optional
symbols	optional

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
}