Currency reference rates

Checking current availability and approved prices…

The operations

JSON in, a structured response out. Every public gateway endpoint uses POST.

Latest reference rateslatest

Rates for the most recently published reference day. Omitting symbols uses USD,GBP,JPY.

POST /api/v1/currency/latest

Price: 1.5 credits per call

View sample input

Use the documented flat JSON object. Keep the fields at the top level; do not wrap them in body.

{
  "base": "EUR",
  "symbols": "USD,GBP,JPY"
}

Try it in the playground

Convert an amountconvert

A numeric amount greater than zero and no more than 1,000,000,000; defaults to 1. Optional historical date.

POST /api/v1/currency/convert

Price: 1.5 credits per call

View sample input

Use the documented flat JSON object. Keep the fields at the top level; do not wrap them in body.

{
  "from": "USD",
  "to": "EUR",
  "amount": 100
}

Try it in the playground

Historical reference dayhistorical

Dates start at 1999-01-04. A weekend or holiday resolves to the previous working day.

POST /api/v1/currency/historical

Price: 1.5 credits per call

View sample input

Use the documented flat JSON object. Keep the fields at the top level; do not wrap them in body.

{
  "date": "2024-01-06",
  "base": "EUR",
  "symbols": "USD,GBP"
}

Try it in the playground

Short time seriestimeseries

At most 31 calendar days inclusive and 10 symbols. Inspect stop_reason; missing business-day data is not zero.

POST /api/v1/currency/timeseries

Price: 3 credits per call

View sample input

Use the documented flat JSON object. Keep the fields at the top level; do not wrap them in body.

{
  "start": "2024-01-02",
  "end": "2024-01-05",
  "base": "EUR",
  "symbols": "USD"
}

Try it in the playground

Endpoint changefluctuation

Compare available endpoint rates within a 31-day window, retaining actual dates rather than inventing daily observations.

POST /api/v1/currency/fluctuation

Price: 3 credits per call

View sample input

Use the documented flat JSON object. Keep the fields at the top level; do not wrap them in body.

{
  "start": "2024-01-02",
  "end": "2024-01-05",
  "base": "EUR",
  "symbols": "USD"
}

Try it in the playground

Current currency namescurrencies

Current published code-to-name set. Its membership does not establish availability on historical dates.

POST /api/v1/currency/currencies

Price: 1.5 credits per call

View sample input

Use the documented flat JSON object. Keep the fields at the top level; do not wrap them in body.

{}

Try it in the playground

Where it can fit

Label indicative cross-border prices with a reference date.
Build an expense-report conversion preview with an explicit rounding policy.
Compare short reporting periods without treating calendar gaps as zero rates.

Limits and constraints

Rates are the European Central Bank's reference rates, published once per working day; a weekend or holiday resolves to the previous working day, shown in the returned date.
Accepted codes include retired currencies such as GRD and HRK; a target code in symbols without a rate on the requested date is absent from rates, and a retired base works only for dates before the currency was discontinued.
The gateway caps inclusive ranges at 31 days and symbol lists at 10; unknown codes, duplicates and future dates are rejected.
Omitting symbols selects USD,GBP,JPY, not every supported currency. Conversion amount is numeric, positive, finite and at most 1e9.
Prices are per-call amounts in decimal-string credit units (1 credit = 100 units).
When a result carries attribution, it is returned in meta.sourceAttribution; keep it with the rates you display.

A few useful answers

Which day does latest return?

The most recently published ECB reference day. The returned date names that day, which can be earlier than today's calendar date.

How many currencies can one request return?

Up to 10 unique codes in symbols, separated by commas without spaces. Omitting symbols returns USD, GBP and JPY. Unknown or duplicate codes are rejected with INVALID_PARAM (400) and nothing is charged.

How long can a timeseries or fluctuation range be?

At most 31 calendar days, counting both start and end, and end must not precede start. These two operations cost twice the per-call price of the other four.

Loading / 加载中…

Limits and constraints

Rates are the European Central Bank's reference rates, published once per working day; a weekend or holiday resolves to the previous working day, shown in the returned date.

Accepted codes include retired currencies such as GRD and HRK; a target code in symbols without a rate on the requested date is absent from rates, and a retired base works only for dates before the currency was discontinued.

The gateway caps inclusive ranges at 31 days and symbol lists at 10; unknown codes, duplicates and future dates are rejected.

Omitting symbols selects USD,GBP,JPY, not every supported currency. Conversion amount is numeric, positive, finite and at most 1e9.

Prices are per-call amounts in decimal-string credit units (1 credit = 100 units).

When a result carries attribution, it is returned in meta.sourceAttribution; keep it with the rates you display.

A few useful answers

Which day does latest return?

The most recently published ECB reference day. The returned date names that day, which can be earlier than today's calendar date.

How many currencies can one request return?

How long can a timeseries or fluctuation range be?

At most 31 calendar days, counting both start and end, and end must not precede start. These two operations cost twice the per-call price of the other four.