fx_markets

Get timestamped official FX reference rates

Returns official FX reference rates as published by each source, one row per source observation. Sources fix at different times of day (for example the ECB at 14:10 CET and the Federal Reserve H.10 at noon New York time), so one date can carry several rows for a pair, including inverse and cross-derived rows. Each row's timestamp_utc, timestamp_type and source identify which fix it is. coverage.sources lists every contributing source with its row count, date range and usual UTC fix times. For a single-fix daily series, pass source (and native_only=true to exclude derived rows).

get/v1/fx/reference-rates/{base}/{quote}

Request

  • Base URL: https://api.fxmacrodata.com
  • URL: https://api.fxmacrodata.com/v1/fx/reference-rates/{base}/{quote}
  • Auth: one of:
    • none
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

basestring required

Base currency code

Example:EUR

Required path parameter. Base currency code

quotestring required

Quote currency code

Example:USD

Required path parameter. Quote currency code

Query parameters

datestring

Single reference date YYYY-MM-DD. Overrides start_date/end_date.

Example:2026-07-10

Optional query parameter. Single reference date YYYY-MM-DD. Overrides start_date/end_date.

start_datestring

Start reference date YYYY-MM-DD, inclusive. Without end_date the window runs through the latest available date (today, UTC); page through long histories with limit and offset or page.

Example:2026-07-10

Optional query parameter. Start reference date YYYY-MM-DD, inclusive. Without end_date the window runs through the latest available date (today, UTC); page through long histories with limit and offset or page.

end_datestring

End reference date YYYY-MM-DD, inclusive. Without start_date only this date is returned. With neither start_date nor end_date, today's (UTC) reference date is returned.

Example:2026-07-10

Optional query parameter. End reference date YYYY-MM-DD, inclusive. Without start_date only this date is returned. With neither start_date nor end_date, today's (UTC) reference date is returned.

sourcestring

Optional source id filter, for example ecb_eurofxref_daily.

Optional query parameter. Optional source id filter, for example ecb_eurofxref_daily.

timestamp_typestring

Optional timestamp type filter, for example fixing or published.

Optional query parameter. Optional timestamp type filter, for example fixing or published.

native_onlyboolean

Return only rows published directly for the requested pair, excluding inverse and cross-derived rows.

Optional query parameter. Return only rows published directly for the requested pair, excluding inverse and cross-derived rows.

include_source_legsboolean

Include derivation source legs when a rate is inverted or crossed.

Optional query parameter. Include derivation source legs when a rate is inverted or crossed.

order'timestamp_asc' | 'timestamp_desc' | 'date_asc' | 'date_desc'

Result ordering.

Optional query parameter. Result ordering.

limitinteger

Maximum rows to return. Maximum 100.

Optional query parameter. Maximum rows to return. Maximum 100.

offsetinteger

Number of rows to skip.

Optional query parameter. Number of rows to skip.

pageinteger nullable

One-based page number.

Optional query parameter. One-based page number.

dataset_versionstring nullable

Pin first-page content version; changed history returns 409.

Optional query parameter. Pin first-page content version; changed history returns 409.

api_keystring

Your Individual or Business API key

Deprecated: legacy query-string API key. Still accepted so existing integrations keep working, but new integrations must send the key in the X-API-Key header (or Authorization: Bearer). A key is required for non-USD, paid-only, or full-history requests. Responses to requests authenticated this way carry a Deprecation header.

Response

Successful Response

basestring required
quotestring required
start_datestring required
end_datestring required
timestamp_basisstring required
dataset_versionstring required
coverageobject required

Changes

No recorded changes to this operation across all 1 revision of this API.