Skip to content

Data catalogue

Data Coverage Catalogue

FXMacroData publishes 486 indicator endpoints across 22 production API currencies and 104 distinct macroeconomic indicators. Series are normalized from the official publisher identified in their metadata. Use this page to choose a market, source family, endpoint, and history window before wiring the data into a model.

Availability is separate from reuse rights. Read Data sources & licensing for publisher terms, attribution and enterprise licensing review.

Markets 22 production API currencies
Indicators 104 macro series
Endpoint pairs 486 currency and indicator combinations

Official-source data

Each listed macro series maps back to a central bank, statistics office, exchange, or official publisher where available.

Backtest integrity

Announcement endpoints expose date and announcement-time fields so models can avoid future-looking joins.

Machine-readable

The same catalogue is available as JSON for crawlers, agent planners, and preflight checks.

Commercial integration preflight

A listed series confirms the endpoint, not every optional field.

Use this catalogue to confirm currency and indicator pairs and their history windows. Consensus, other forecasts, revisions, and exact official release permalinks are separate capabilities and may be unavailable on an otherwise supported series. Test each field your product requires before launch.

Product requirementWhere to verify itImportant availability rule
Actual and historical values/v1/announcements/{currency}/{indicator}Use this catalogue for the pair and history start, then probe the endpoint.
Previous and revised valuesAnnouncements with revisions=allRevision arrays exist only when a revision has been captured.
Market consensus and forecasts/v1/predictions/{currency}/{indicator} with prediction_class=compiled_consensus or prediction_class=forecaster_survey, plus the forecast coverage matrixMany releases have no consensus from any official publisher, and no plan adds one: check the availability block on the response before designing around it. Do not substitute fxmacrodata or another class for consensus. Pairs with external forecast feeds carry a "Forecasts" badge below.
Official source linksource_url and source_url_scopeThe URL is optional and may identify a release, dataset, or series.
Upcoming release time/v1/calendar/{currency}Use the returned confirmed schedule fields; do not infer future times.
Yields, commodities, gold, and FX contextTheir dedicated endpoint familiesCoverage and field shapes differ from announcement series.

Choose a dataset family

Start with the coverage question, then open the endpoint.

Use the sections below to check available markets, history starts, endpoint pages, and machine-readable paths before building a research, dashboard, or agent workflow.

Manifest generated:

AUD BRL CAD CHF CNH CNY DKK EUR GBP HUF ILS JPY KRW MYR NGN NOK NZD PEN SEK THB TWD USD

FX markets

Intraday FX reference rates

Retrieve timestamped FX reference rates by currency pair. This point-in-time history is distinct from a session-close snapshot and from a live bid or ask feed.

Individual subscriber feature. An active subscription and API key are required for intraday FX reference-rate requests.

View data availability
curl -H "X-API-Key: YOUR_API_KEY" "https://api.fxmacrodata.com/v1/fx/intraday-reference-rates/{base}/{quote}?start_time=2026-07-13T00%3A00%3A00Z&end_time=2026-07-14T00%3A00%3A00Z"

Discover cleared source coverage with FX sources and source pair coverage.

Quick start — one curl call

Every indicator endpoint follows the same shape. Replace {currency}, {indicator}, and send X-API-Key: YOUR_API_KEY as a request header when authentication is required:

curl "https://api.fxmacrodata.com/v1/announcements/usd/inflation"

More examples (any supported currency, any indicator):

# Eurozone policy rate
curl -H "X-API-Key: YOUR_API_KEY" "https://api.fxmacrodata.com/v1/announcements/eur/policy_rate"

# UK GDP
curl -H "X-API-Key: YOUR_API_KEY" "https://api.fxmacrodata.com/v1/announcements/gbp/gdp"

# Japan unemployment, date-bounded
curl -H "X-API-Key: YOUR_API_KEY" "https://api.fxmacrodata.com/v1/announcements/jpy/unemployment?start_date=2024-01-01"

# Latest value for every USD indicator in one call
curl "https://api.fxmacrodata.com/v1/announcements/usd/latest"

USD data is free for the trailing 90 days without authentication, on a 15-minute delay. All other currencies and full history require an API key. Browse the summary below or pull the machine-readable manifest at /data-coverage.json.

Showing all 486 endpoint pairs across 104 indicators.

Economy

Balance on Goods

Balance of payments: trade in goods.

Balance on Services

Balance of payments: trade in services.

Building Permits

Number of new residential construction permits authorized, a leading indicator of future housing activity and economic growth.

Core Inflation MoM

Month-over-month change in core consumer prices (excluding food and energy), tracking underlying inflation trends.

Dairy Exports

Monthly New Zealand dairy export value from official Stats NZ overseas merchandise trade HS10 export data.

Durable Goods Orders

Measures new orders placed with domestic manufacturers for delivery of long-lasting goods.

Government Debt

Total outstanding debt obligations of the central government, indicating fiscal sustainability and public sector borrowing requirements.

House Price Index

Measures changes in residential property prices over time, reflecting housing market conditions and consumer wealth.

Housing Starts

Number of new residential construction projects that have begun in a given period, a key indicator of economic activity and construction sector health.

Industrial Production

Measures the output of the industrial sector (manufacturing, mining, utilities).

Inflation Rate (CPI/HICP)

Headline inflation: the year-over-year percentage change in the Consumer Price Index (CPI), the standard measure central banks target.

Show the remaining 10 of 18 markets

PCE Price Index

The headline Personal Consumption Expenditures price index published by BEA.

PCE MoM

Month-over-month change in the Personal Consumption Expenditures price index.

Producer Price Index MoM (PPI)

Month-over-month change in producer prices, an early indicator of inflationary pressure in the supply chain.

Household Spending

Monthly change in total household spending on goods and services, at current prices and seasonally adjusted.

Labor Market

Average Hourly Earnings

Measures the change in the price businesses pay for labor.

Initial Jobless Claims

Weekly initial unemployment insurance claims.

Job Openings

Total number of unfilled job positions, a key indicator of labor market demand and tightness.

NAIRU (Natural Rate of Unemployment)

Non-Accelerating Inflation Rate of Unemployment — the estimated unemployment rate consistent with stable inflation, published by the Congressional Budget Office.

Non-Farm Payrolls (NFP)

Number of workers in the U.S. excluding farm workers.

Money & Credit

Credit Growth

Total credit growth from RBA series.

Monetary Policy

Government Bond Yields

1-Month Treasury Par Yield

The U.S. Treasury constant-maturity par yield for a 1-month maturity, expressed as an annual percentage rate.

1.5-Month Treasury Par Yield

The U.S. Treasury constant-maturity par yield for a 1.5-month maturity, expressed as an annual percentage rate.

2-Month Treasury Par Yield

The U.S. Treasury constant-maturity par yield for a 2-month maturity, expressed as an annual percentage rate.

3-Month Treasury Par Yield

The U.S. Treasury constant-maturity par yield for a 3-month maturity, expressed as an annual percentage rate.

4-Month Treasury Par Yield

The U.S. Treasury constant-maturity par yield for a 4-month maturity, expressed as an annual percentage rate.

6-Month Treasury Par Yield

The U.S. Treasury constant-maturity par yield for a 6-month maturity, expressed as an annual percentage rate.

5-Year Treasury Real Par Yield

The U.S. Treasury real par yield for a 5-year constant maturity, derived from Treasury Inflation-Protected Securities and expressed as an annual percentage rate.

7-Year Treasury Real Par Yield

The U.S. Treasury real par yield for a 7-year constant maturity, derived from Treasury Inflation-Protected Securities and expressed as an annual percentage rate.

20-Year Treasury Real Par Yield

The U.S. Treasury real par yield for a 20-year constant maturity, derived from Treasury Inflation-Protected Securities and expressed as an annual percentage rate.

30-Year Treasury Real Par Yield

The U.S. Treasury real par yield for a 30-year constant maturity, derived from Treasury Inflation-Protected Securities and expressed as an annual percentage rate.

6-Year JGB Constant-Maturity Yield

The Japanese Ministry of Finance constant-maturity yield for a 6-year Japanese government bond, expressed as an annual percentage rate with semiannual compounding.

8-Year JGB Constant-Maturity Yield

The Japanese Ministry of Finance constant-maturity yield for a 8-year Japanese government bond, expressed as an annual percentage rate with semiannual compounding.

9-Year JGB Constant-Maturity Yield

The Japanese Ministry of Finance constant-maturity yield for a 9-year Japanese government bond, expressed as an annual percentage rate with semiannual compounding.

15-Year JGB Constant-Maturity Yield

The Japanese Ministry of Finance constant-maturity yield for a 15-year Japanese government bond, expressed as an annual percentage rate with semiannual compounding.

25-Year JGB Constant-Maturity Yield

The Japanese Ministry of Finance constant-maturity yield for a 25-year Japanese government bond, expressed as an annual percentage rate with semiannual compounding.

Interest Rates

Effective Federal Funds Rate

The New York Fed volume-weighted median rate on overnight federal funds transactions, expressed as an annual percentage rate.

Overnight Bank Funding Rate

The New York Fed measure of wholesale unsecured overnight U.S. dollar bank funding costs, expressed as an annual percentage rate.

Tri-Party General Collateral Rate

The New York Fed measure of overnight tri-party general collateral repo borrowing costs secured by U.S. Treasury securities, expressed as an annual percentage rate.

Broad General Collateral Rate

The New York Fed measure of overnight Treasury general collateral repo borrowing costs across tri-party and GCF repo markets, expressed as an annual percentage rate.

SOFR Index

The New York Fed index of cumulative daily compounding of the Secured Overnight Financing Rate (SOFR), with a base value of 1 on April 2, 2018.

30-Day Compounded SOFR Average

The New York Fed compounded average of SOFR over the previous 30 calendar days, expressed as an annual percentage rate.

90-Day Compounded SOFR Average

The New York Fed compounded average of SOFR over the previous 90 calendar days, expressed as an annual percentage rate.

180-Day Compounded SOFR Average

The New York Fed compounded average of SOFR over the previous 180 calendar days, expressed as an annual percentage rate.

Overnight Deposit Rate

Overnight deposit rate at registered banks. RBNZ daily banking rates.

SNB Indicators

Sight Deposits

SNB sight deposits (Girokonto balances).

SNB Balance Sheet

SNB total balance sheet assets.

Additional Indicators

Building Approvals

Dwellings approved for construction, a leading indicator of future residential building activity.

Energy Commodities

Energy component of the Bank of Canada commodity price index, covering crude oil, natural gas and coal export prices.

Ex-Energy Commodities

Bank of Canada commodity price index excluding energy, covering metals, forestry, agriculture and fisheries export prices.

Commodity Price Index

Bank of Canada commodity price index: an export-weighted measure of the prices of Canada's main commodity exports.

Commodity Prices

Price measure for the economy's principal commodity exports. Published as an index or as a benchmark price depending on the market; check the unit for each currency.

Core Inflation (Median)

Median CPI: the year-on-year price change at the midpoint of the CPI basket, a core inflation measure that removes outlying components.

Core Inflation (Trim)

Trimmed CPI: year-on-year inflation after excluding the components with the most extreme price moves in each period.

FX Reserves

Official foreign-currency reserve assets held by the central bank. Reported in the unit each authority publishes; check the unit before comparing markets.

Quarterly GDP

Quarterly gross domestic product: total output of the economy in the quarter. Published as a growth rate or a level depending on the market.

House Prices

Residential property price index covering existing and newly built dwellings.

Household Credit

Outstanding credit extended to households, including residential mortgages and consumer lending.

Terms of Trade

Ratio of export prices to import prices. A rise means each unit of exports buys more imports.

Trimmed Mean Inflation

Trimmed mean CPI: the core inflation measure that excludes the largest price rises and falls in the basket.

Wage Price Index

Wage price index: the change in the price of labour for a fixed quantity and quality of work, so it is not distorted by shifts in the composition of the workforce.

For AI agents

If you are building an AI agent that needs to fetch macroeconomic data, start with the JSON coverage manifest, pick the (currency, indicator) pair, and call the corresponding https://api.fxmacrodata.com/v1/announcements/{currency}/{indicator} endpoint. Discovery documents are published at /.well-known/mcp.json and /.well-known/ai-plugin.json. The full schema is at /api/openapi.json.

Share page X LinkedIn Email