Get FX reference rates

API endpoint to get FX reference rates. All filters are optional.

Without a value date the current rates are returned: for each currency pair and source, the rate valid right now.
A rate registered with a future validFromDate is not current until that moment; until then the rate it replaces
is returned, with validToDate set to when it stops being valid.

With a value date the rate that was valid on that date is returned. When more than one rate was valid during that
day, the last one registered wins, so it is effectively the end-of-day rate. A value date after the latest rate
returns the latest known rate, so a missed rate feed never leaves a gap.

A reference rate source that does not exist returns a 400. A currency pair without rates returns 200 with an empty
list. An invalid parameter, such as a currency code that is not 3 characters, returns a 422

Query Params
int32

Filter by the internal id of the reference rate source. Takes precedence over the source name when both are provided

string

Filter by the name of the reference rate source

string

Filter by the base currency code of the pair

string

Filter by the quoted currency code of the pair

date-time

Return the rates that were valid on this date instead of the current rates. When more than one rate was registered on that day, the last one registered is returned

Headers
string
required
Defaults to v1

API versioning

uuid
required

Correlates HTTP requests between a client and server

string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

500

Internal Server Error

Language
Credentials
OAuth2
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
text/plain
application/json
text/json