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.

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

Changes