FXMacroData API
Official-source macroeconomic indicators, release calendars, central-bank policy rates, FX reference rates, COT positioning and commodities across 22…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Official-source macroeconomic indicators, release calendars, central-bank policy rates, FX reference rates, COT positioning and commodities across 22 currencies. USD data is available without an API key; other currencies and datasets need an X-API-Key header.
Endpoints 44
health
- GETPing the API
/v1/healthReturns a simple OK status to verify the API is running. - GETPing the API
/v1/pingReturns a simple OK status to verify the API is running.
announcements
- POSTBuild a panel of values known at each decision time
/v1/research/panel - GETGet latest values for all indicators in a currency
/v1/announcements/:currency/latest - GETGet macroeconomic indicator data
/v1/announcements/:currency/:indicatorFetches historical data for a given macroeconomic indicator of a currency. Authentication & limits: USD data is publicly accessible without an API key, but… - GETPoll recent live announcement release changes
/v1/announcements/changesReturns recent live announcement release events from the same durable fanout used by the real-time SSE stream. Use next_cursor as the since value on the next… - GETSubscribe to real-time announcement events (SSE)
/v1/stream/eventsOpens a long-lived Server-Sent Events (SSE) stream. A new event is pushed to all connected clients whenever FXMacroData captures a new economic data release.…
predictions
- GETWhich forecast publishers cover which currency (no API key)
/v1/predictions/coverageFree, key-free catalogue of forecast coverage across every served currency: which publishers we carry, what class of forecast each produces, and which… - GETPer-indicator forecast coverage for one currency (no API key)
/v1/predictions/coverage/:currencyFree, key-free per-indicator catalogue for one currency: the publishers covering each indicator, the prediction_class each produces, whether any of them is a… - GETPage official forecast vintages from one publisher
/v1/predictions/:currencyRead one explicitly named source; bare currency listings stay disabled. This path never fans out to announcement indicators. Native variables, publication… - GETList predictions for one indicator of a currency
/v1/predictions/:currency/:indicatorReturns every available prediction for the requested currency/indicator pair. Each row is stamped with its original generated_at and full source provenance…
calendar
- GETGet upcoming economic data release dates
/v1/calendar/:currencyReturns upcoming economic data release dates for a given currency. Announcement rows keep the release slug mapping to… - GETGet the economic schedule known at a historical time
/v1/calendar/:currency/snapshot?as_of=2024-01-01T00:00:00ZSelects the latest eligible version of each event at as_of before applying scheduled-date, importance and event-kind filters. Times are UTC; date-only events… - GETGet immutable schedule versions for an event
/v1/calendar/:currency/events/:archive_event_id/versionsReturns accepted versions and their source, capture and documentary evidence. The archive event ID remains stable when its scheduled time changes; existing… - GETInspect calendar archive evidence coverage and capture gaps
/v1/calendar/:currency/coverageReports, per source, what we captured and the dates it covers. A source with coverage_type month_listing lists the publisher's month pages we captured in…
press_releases
- GETCentral bank press releases
/v1/press-releases/:currencyReturns press releases from official central bank websites for the requested currency, newest first. Requests with an API key include the history available…
commodities
- GETGet latest values for all commodity indicators
/v1/commodities/latest - GETGet commodity indicator data
/v1/commodities/:indicatorReturns commodity and energy price observations with source provenance. Supported indicators: crude_oil_inventories, crude_oil_stocks, distillate_inventories,…
fx_markets
- GETGet FX spot rates
/v1/forex/:base/:quoteFetches daily FX spot rates between two currencies using official central-bank reference rates. Path Parameters: base: Base currency code (e.g., AUD, USD).… - GETGet timestamped official FX reference rates
/v1/fx/reference-rates/:base/:quoteReturns 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… - GETGet subscriber intraday FX reference rates
/v1/fx/intraday-reference-rates/:base/:quoteReturn subscriber-only timestamped intraday FX reference rates. - GETGet official FX session-close reference rates
/v1/fx/session-rates/:base/:quote?session=londonFor each date, returns the latest timed official reference observation on that date at or before the selected session close: Sydney 17:00 Australia/Sydney,… - GETList public FX reference-rate sources
/v1/fx/sourcesLists the official FX reference-rate sources and the pairs each one publishes. native_pairs documents what the authority publishes; only served_pairs are… - GETList public FX reference-rate pair universe
/v1/fx/source-universe - GETFX market session timetable
/v1/market_sessionsReturns a real-time snapshot of the four major FX trading sessions (Sydney, Tokyo, London, New York) and their overlap windows. Each session entry shows… - GETGet pair rate differentials
/v1/rate_differentials/:base/:quoteReturns a historical differential between the base and quote currency using a shared rate measure. The endpoint aligns the two legs by date intersection and… - GETGet curve analytics by currency
/v1/curves/:currencyReturns a currency-level curve view from official-source government bond tenor nodes. Use view=nodes for raw node snapshots, view=slopes for curve-slope and… - GETRecorded risk-sentiment changes
/v1/risk_sentiment/changesReturns retained additions, score revisions and input-metadata changes in increasing change_sequence order. Pass pagination.next_after_sequence as… - GETGlobal risk-on / risk-off indicator
/v1/risk_sentimentReturns a composite daily risk-sentiment score indicating whether global financial conditions favour risk-on currencies (AUD, NZD, CAD) or risk-off safe… - GETGet CFTC Commitment of Traders (COT) data
/v1/cot/:currencyReturns weekly CFTC Commitment of Traders report data for the specified currency's futures contract. The default is the Legacy Futures-Only report; report=…
settlement
- GETContract templates for settling event contracts on official releases
/v1/settlement/contracts - GETPublic keys that verify signed settlement records
/v1/settlement/keys - GETSettle a contract template for one release
/v1/settlement/contracts/:contract_id?currency=string - GETSettlement record for one release of an announcement series
/v1/settlement/:currency/:indicator
data_catalogue
- GETGet Currently Available Macroeconomic Indicators
/v1/data_catalogue/:currencyReturns the currently available macroeconomic indicators for a specific currency. Availability reflects the data currently served, so temporarily unavailable… - GETSearch all dataset types and currencies
/v1/catalogueSearch published collections, datasets and series using the same filters as the website. Returns metadata, facets, pagination and snapshot freshness; no…
monetary_policy
- GETOfficial financial prices and yield curves
/v1/financial_prices/:currencyOfficial government and central-bank observations. Filter by source, issuer, instrument or measure. Separate nominal, real, par, zero, security quotes and… - GETNative source definitions
/v1/native - GETReserves, Treasury and energy history
/v1/native/:source?year=1900Persisted observations for one source and year. Ownership and custody, holdings and flows, and auction dates remain separate. Historical publication times can…
positioning
- GETCFTC instrument and report definitions
/v1/positioning - GETCFTC contract positioning history
/v1/positioning/:instrument
factors
- GETGet a precomputed FX factor for one currency
/v1/factors/:currency/:factorReturns a factor series for one explicit currency and one explicit factor. Factor values are precomputed snapshots; component macro indicators are not…
Organisation directory
- GETSearch Organisations
/v1/organisations?q=stringFind up to ten public organisation references by name or service, with optional category filtering and canonical citation URLs. - GETOrganisation Profile
/v1/organisations/:slugRead one published organisation summary with services, identity type, original sources and an FXMacroData citation URL.
API details
- Base URL
https://api.fxmacrodata.com- Authentication
- An API key in the X-API-Key header
A bearer token in the Authorization header
An API key in the api_key query parameter - Operations
- 44 operations on 44 pathsGET 43POST 1
- Main resources
- fx_markets 12announcements 5calendar 4predictions 4settlement 4monetary_policy 3Organisation directory 2commodities 2data_catalogue 2health 2
- Response formats
application/jsontext/event-stream- Description format
- OpenAPI 3.1.0, API version
1.0.0 - Links
- OpenAPI document
- Listed from
- Fxmacrodata's published OpenAPI description
How to test the FXMacroData API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the FXMacroData API collection, without the publisher's secrets.
- Add your credentialsThis API uses an API key in the X-API-Key header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Ping the API” (GET /v1/health), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the FXMacroData API?
Official-source macroeconomic indicators, release calendars, central-bank policy rates, FX reference rates, COT positioning and commodities across 22… It is listed under Finance & banking and has 44 endpoints.
Who publishes the FXMacroData API?
It is listed from FXMacroData's public API description (an OpenAPI document), not published by FXMacroData on Swastik Codes. Anyone who controls fxmacrodata.com can claim the profile by adding a DNS TXT record.
What is the base URL of the FXMacroData API?
Requests go to https://api.fxmacrodata.com. Endpoint paths are added to this base URL.
How do I authenticate with the FXMacroData API?
It accepts 3 methods: an API key in the X-API-Key header; A bearer token in the Authorization header; an API key in the api_key query parameter.
How many endpoints does the FXMacroData API have?
44 operations on 44 paths (43 GET, 1 POST). The largest groups are fx_markets, announcements, calendar, predictions.
Is forking the FXMacroData API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.