FX markets API
Official FX fixing timeline
Retrieve official central-bank reference rates in source-time order. Each record identifies the rate, the source observation time, the source, and whether the requested pair is native or derived.
Timestamp basis
Official source observation time
Time zone
RFC 3339 timestamps in UTC
Access
Professional API key
Endpoint
Use an inclusive source-timestamp window. With no window parameters, the endpoint returns the most recent 24 hours.
GET https://api.fxmacrodata.com/fx/fixing-timeline/{base}/{quote}curl "https://api.fxmacrodata.com/fx/fixing-timeline/eur/usd?start_time=2026-07-13T00%3A00%3A00Z&end_time=2026-07-14T00%3A00%3A00Z&api_key=YOUR_API_KEY"Python example
import requests
response = requests.get(
"https://api.fxmacrodata.com/fx/fixing-timeline/eur/usd",
params={
"start_time": "2026-07-13T00:00:00Z",
"end_time": "2026-07-14T00:00:00Z",
"api_key": "YOUR_API_KEY",
},
timeout=30,
)
response.raise_for_status()
for point in response.json()["data"]:
print(point["timestamp_utc"], point["rate"], point["source"]["name"])Response fields
| Field | Meaning |
|---|---|
| timestamp_utc | The source observation timestamp used to order the timeline. |
| timestamp_type | Whether the source identifies the time as a fixing, publication, calculation, effective time, or other observation type. |
| reference_date | The business date to which the central-bank reference rate applies. |
| native_or_derived | Whether the requested pair is published directly by the source or calculated from its published legs. |
| source_legs | The source pair observations used for an inverted or crossed rate, when requested. |
Useful filters
sourcelimits the timeline to one source identifier.timestamp_typelimits rows to a source-defined timestamp category.native_only=trueexcludes inverted and crossed calculations.include_source_legs=falseomits derivation legs from the response.
How it differs from session rates
The fixing timeline is ordered by the bank's source timestamp. The session-rate endpoint instead reports the latest eligible official rate known at a selected Sydney, Tokyo, London, or New York session close.
This is an official reference-rate timeline, not a live executable FX, bid, or ask feed.
Discover source coverage
Use the source endpoints to inspect the official sources and available native, inverse, and derived currency pairs before requesting a timeline.