Skip to content

Data catalogue

Data Coverage Catalogue

FXMacroData publishes 629 indicator endpoints across 26 supported currency codes and 195 distinct macroeconomic indicators. Check the exact series for your research notebook, dashboard or trading system. Currency codes are not country counts: EUR covers the euro area, while CNY and CNH are separate codes for China. 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 26 production API currencies
Indicators 195 macro series
Endpoint pairs 629 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.

Check coverage for your task

Compare selected currency and indicator pairs, source definitions and dated history starts before subscribing. History depth, revisions, freshness and publication evidence are checked separately.

Check my required series

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
Verified first-release historyRelease and revision reviewObservation start dates below are not first-release coverage dates. Studio reports retained versions, first-release flags and confirmed timing separately. Complete first-release history remains uncertified.
Publication precisionStudio Series coverage and revision workbooksInspect the precision and timing status for the selected data. Capture timestamps and scheduled times do not establish when the publisher released a value.
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 contain retained captures and source vintages, including legacy snapshots and equal-value captures. They do not certify publisher revision completeness or first-release status.
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.
Schedule known at a past date/v1/calendar/{currency}/snapshot with as_of, /v1/calendar/{currency}/events/{archive_event_id}/versionsEach version shows when FXMacroData captured it or the dated publisher notice behind it. Schedules recovered later from official archives appear only from their retrieval date, so they do not show what was known beforehand. knowledge_mode=reconstruction also admits dated official notices recovered later.
Dates with no schedule events/v1/calendar/{currency}/coverage with start_date and end_dateEach source reports window_events and window_status. When window_listing is whole_window, no_events_listed means the publisher's own month page lists no event of the kinds in event_kinds_covered. Otherwise an empty window reports only what the archive holds from that source.
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 CZK DKK EUR GBP HUF IDR ILS JPY KRW MXN MYR NGN NOK NZD PEN PLN 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 629 endpoint pairs across 195 indicators.

Economy

Balance on Goods

Balance of payments: trade in goods.

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.

Gross Domestic Product (GDP)

Gross domestic product: the total value of goods and services produced in the economy, its broadest measure of activity. Depending on the country, the headline series is published as a level or as a growth rate; the unit shown with each series says which.

Show the remaining 11 of 19 markets

Government Debt

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

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.

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 13 of 21 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.

Household Spending

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

Trade-Weighted Index (NEER)

Nominal Effective Exchange Rate (NEER) measuring the value of a currency relative to a basket of trading partners' currencies, weighted by trade volumes. Published monthly by the BIS.

Show the remaining 10 of 18 markets

Business Cycle Survey - Industry - base index

Czech Statistical Office Business Cycle Survey industry confidence, expressed as a seasonally adjusted base index, with the long-term average equal to 100.

Business Cycle Survey - Construction - base index

Czech Statistical Office Business Cycle Survey construction confidence, expressed as a seasonally adjusted base index, with the long-term average equal to 100.

Business Cycle Survey - Trade - base index

Czech Statistical Office Business Cycle Survey trade confidence, expressed as a seasonally adjusted base index, with the long-term average equal to 100.

Business Cycle Survey - Selected Services - base index

Czech Statistical Office Business Cycle Survey selected services confidence, expressed as a seasonally adjusted base index, with the long-term average equal to 100.

Business Cycle Survey - Economic sentiment indicator - base index

Czech Statistical Office Business Cycle Survey economic sentiment indicator confidence, expressed as a seasonally adjusted base index, with the long-term average equal to 100.

Business Cycle Survey - Industry - balance

Czech Statistical Office Business Cycle Survey industry confidence, expressed as a seasonally adjusted survey balance.

Business Cycle Survey - Construction - balance

Czech Statistical Office Business Cycle Survey construction confidence, expressed as a seasonally adjusted survey balance.

Business Cycle Survey - Trade - balance

Czech Statistical Office Business Cycle Survey trade confidence, expressed as a seasonally adjusted survey balance.

Business Cycle Survey - Business indicator - balance

Czech Statistical Office Business Cycle Survey business indicator confidence, expressed as a seasonally adjusted survey balance.

Business Cycle Survey - Consumer indicator - balance

Czech Statistical Office Business Cycle Survey consumer indicator confidence, expressed as a seasonally adjusted survey balance.

Business Cycle Survey - Economic sentiment indicator - balance

Czech Statistical Office Business Cycle Survey economic sentiment indicator confidence, expressed as a seasonally adjusted survey balance.

Economic activity (IGAE) index

INEGI's monthly IGAE index for total economic activity in Mexico, seasonally adjusted with 2018=100. Month-on-month and year-on-year changes are published by INEGI.

Primary activity (IGAE) index

INEGI's monthly IGAE index for primary activities in Mexico, seasonally adjusted with 2018=100. Month-on-month and year-on-year changes are published by INEGI.

Services activity (IGAE) index

INEGI's monthly IGAE index for tertiary activities in Mexico, seasonally adjusted with 2018=100. Month-on-month and year-on-year changes are published by INEGI.

Import Price Index

Singapore Department of Statistics import price index, covering overall items. The monthly index has a 2023=100 base and is not 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.

Unemployment Rate

Percentage of the labor force that is unemployed.

Show the remaining 10 of 18 markets

Employment-to-population ratio (national, all sexes)

Official EPHC survey estimates for people aged 15 and over. Excludes Boquerón, Alto Paraguay, indigenous communities and collective dwellings. Population weights use revision 2025; figures are not seasonally adjusted.

Unemployed persons, age 15 and over (national, all sexes)

Official EPHC survey estimates for people aged 15 and over. Excludes Boquerón, Alto Paraguay, indigenous communities and collective dwellings. Population weights use revision 2025; figures are not seasonally adjusted.

Money & Credit

Credit Growth

Total credit growth from RBA series.

Monetary Policy

Central Bank Policy Rate

Primary interest rate set by the Central Bank.

Show the remaining 11 of 19 markets

Risk Free Rate

Overnight lending rate between banks.

Show the remaining 15 of 23 markets

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.

SNB Indicators

Sight Deposits

SNB sight deposits (Girokonto balances).

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.

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.

Economic indicators

Total Revenues (Non-financial Enterprises, Year to Date)

Bank Lending Standards (SLOOS, C&I loans to large and middle-market firms)

Nominal Advanced Foreign Economies U.S. Dollar Index

Nominal Emerging Market Economies U.S. Dollar Index

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