v29

latestOpenAPI 3.1.2MITraw.githubusercontent.com2026-08-015417.4 KB

Get exchange rates

Returns exchange rates blended across providers. Without date params, returns the latest rates. Each record is a single currency pair. The response includes an identity record for the base currency (base equals quote, rate 1), subject to the quotes filter like any other record. Daily date ranges of any length are served, including full history. Limit: requests using providers or expand=providers recompute the blend per date, so at daily granularity they return 422 for ranges longer than 5 years. With providers naming at most 5 providers, a quotes list of at most 5 currencies lifts the cap; without providers, expand=providers ranges compute every currency regardless of quotes, so aggregate with group=week or group=month, add providers, or split the range into shorter requests.

get/rates

Query parameters

datestring date
Example:2024-01-15

Specific date (YYYY-MM-DD). Cannot be combined with from/to.

fromstring date
Example:2024-01-01

Start of date range (YYYY-MM-DD)

tostring date
Example:2024-01-31

End of date range (YYYY-MM-DD). Defaults to today.

basestring
Example:USD

Base currency (default: EUR)

quotesstring
Example:USD,GBP,JPY

Comma-separated list of quote currencies to include

providersstring
Example:ECB,TCMB

Comma-separated list of data providers to include

group'week' | 'month'
Example:month

Downsample rates by time period. Only applies to date ranges.

expand'providers'
Example:providers

Comma-separated list of optional fields to include per record. Currently supports providers, which adds an array of { key, date, rate } objects per record showing each provider's individual observation date and rate. Outliers excluded from the blend (and providers whose rate was overridden by a currency peg) are flagged with excluded: true. The field is omitted on synthesized peg rows where no provider published the quote. In CSV output, the providers column is encoded as KEY:RATE pairs joined by |, with a trailing * on excluded entries (e.g. ECB:0.92|FED:1.50*).

Response

Exchange rates

datestring date required

The date of the rate

basestring required

Base currency code

quotestring required

Quote currency code

ratenumber required

Exchange rate value

All 5 operations