Sign in

Get a provider's exchange rates

Returns one provider's rates as published, unblended. Identical to /rates?providers={provider}: same parameters, same records, same limits. Native-base records carry the provider's published digits; other bases are derived. Sending providers here returns 422. Unknown provider returns 404.

get/providers/{provider}/rates

Path parameters

providerstring required
Example:ECB

Provider key, case-insensitive. See /providers for the list.

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

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 or accounting unit code

quotestring required

Quote currency or accounting unit code

ratenumber required

Exchange rate value

Changes

Changed in 1 of the 39 revisions of this API.1