# MacroDataAPI

> Macro and economic data for AI agents from the primary statistical agencies: BLS, BEA, Treasury, Fed, ECB, Eurostat, ONS, Bank of England, ABS and RBA. Latest prints, point-in-time history with vintages, release calendar, policy rates and yield curves. One key, or pay per request in USDC over x402.

## Authentication
Send `X-API-Key: mdk_live_...`. Free key: `POST https://macrodataapi.com/api/v1/auth/keys` with `{"email": "..."}`. No key? GET any data endpoint and you receive a 402 with the USDC price (x402).
Free at volume: the same endpoints are on RealtimeAPI.ai as feed `macrodata` (https://api.realtimeapi.ai/v1/macrodata/...). A free RealtimeAPI key (`POST https://api.realtimeapi.ai/keys/free`) gives 1,000 calls a month across every feed, served from its edge cache. Setup prompt for any agent: https://macrodataapi.com/realtimeapi/prompt.txt

## First calls
1. `GET /api/v1/series` (MCP: `macro_search_series`): the catalog.
2. `GET /api/v1/releases/upcoming?days=7` (MCP: `macro_calendar`): what lands this week, UTC.
3. `GET /api/v1/series/us.cpi.all.sa` (MCP: `macro_latest`): latest print, changes, release time.
4. `GET /api/v1/series/us.cpi.all.sa/history?as_of=2026-06-30` (MCP: `macro_history`, Pro): the series as known on that date.

## Endpoints and prices (USDC per request without a key)
- `GET /api/v1/series`: Catalog of every series with publisher, unit, frequency, latest period and next release. $0.005. Refreshes every 60 minutes. Tier: free.
- `GET /api/v1/series/{series_id}`: Latest print for one series with the previous value, change, release time and next release. $0.010. Refreshes at each release; polled every 5 minutes on release days. Tier: free.
- `GET /api/v1/series/{series_id}/history`: Full history of one series, optionally as it stood on a past date (as_of) for point-in-time backtests. $0.020. Refreshes at each release. Tier: pro.
- `GET /api/v1/series/{series_id}/vintages`: Every revision of one period of one series: the initial print and each later value with its vintage date. $0.020. Refreshes at each release. Tier: pro.
- `GET /api/v1/releases/upcoming`: Scheduled data releases for the next N days across every publisher, with the series each one updates. $0.005. Refreshes every 5 minutes. Tier: free.
- `GET /api/v1/releases/latest`: The most recent releases observed, newest first, with the headline values that changed. $0.010. Refreshes every 60 seconds. Tier: free.
- `GET /api/v1/rates/policy`: Current policy rates of the Fed, ECB, Bank of England and RBA with the last decision date and next meeting. $0.005. Refreshes every 5 minutes. Tier: free.
- `GET /api/v1/yields/{country}`: Daily par yield curve for a country (US today), every tenor, with the previous session and the 2s10s spread. $0.010. Refreshes every 30 minutes. Tier: free.

## Tiers
- Free: 10/min, 500/day. Latest values, catalog, calendar, policy rates, yields.
- Pro: 60/min, 20000/day. Adds history with as_of and vintages. Passes: 1h $1.00, 1d $3.00, 7d $8.00. No subscriptions.
- Pay per request (x402): no key, no account. Prices above. `POST /api/v1/payments/agent-subscribe` with `{"plan": "pass_1d"}` buys a pass and returns a key.
- RealtimeAPI.ai: 1,000 free calls a month on this feed and every other feed with one `rta_live_` key. MCP: https://mcp.realtimeapi.ai/mcp. Feed page: https://realtimeapi.ai/feeds/macrodata.

## Response envelope
Values are decimal strings. Every data response carries `source` (publisher, licence, url, retrieved_at), `as_of` and, where known, `next_release_at`. Periods: YYYY-MM-DD daily, YYYY-MM monthly, YYYY-Qn quarterly. Vintages are recorded from the day the service first observed a series.

## Series

- `us.cpi.all.sa`: CPI-U, all items, seasonally adjusted. BLS, monthly, unit index_1982_84_100.
- `us.cpi.all.nsa`: CPI-U, all items, not seasonally adjusted. BLS, monthly, unit index_1982_84_100.
- `us.cpi.core.sa`: CPI-U, all items less food and energy, seasonally adjusted. BLS, monthly, unit index_1982_84_100.
- `us.unemployment.rate`: Unemployment rate, 16 years and over. BLS, monthly, unit percent.
- `us.payrolls.total`: Total nonfarm payroll employment. BLS, monthly, unit thousands.
- `us.earnings.hourly.private`: Average hourly earnings, total private. BLS, monthly, unit usd.
- `us.ppi.final_demand`: PPI final demand. BLS, monthly, unit index_nov_2009_100.
- `us.gdp.real.qoq.saar`: Real GDP, percent change from preceding quarter (SAAR). BEA, quarterly, unit percent_saar.
- `us.pce.price.index`: PCE price index. BEA, monthly, unit index_2017_100.
- `us.pce.price.core`: PCE price index excluding food and energy. BEA, monthly, unit index_2017_100.
- `us.debt.total`: Total public debt outstanding. Treasury, daily, unit usd.
- `us.debt.public`: Debt held by the public. Treasury, daily, unit usd.
- `us.yield.10y`: 10-year Treasury par yield. Treasury, daily, unit percent.
- `us.yield.2y`: 2-year Treasury par yield. Treasury, daily, unit percent.
- `us.yield.3m`: 3-month Treasury par yield. Treasury, daily, unit percent.
- `us.yield.30y`: 30-year Treasury par yield. Treasury, daily, unit percent.
- `us.fedfunds.effective`: Effective federal funds rate. Fed, daily, unit percent.
- `ea.ecb.mrr`: ECB main refinancing operations rate. ECB, daily, unit percent.
- `ea.ecb.dfr`: ECB deposit facility rate. ECB, daily, unit percent.
- `ea.hicp.annual`: Euro area HICP, annual rate of change. ECB, monthly, unit percent.
- `ea.unemployment.rate`: Euro area unemployment rate. Eurostat, monthly, unit percent.
- `uk.cpi.annual`: UK CPI annual rate, all items. ONS, monthly, unit percent.
- `uk.unemployment.rate`: UK unemployment rate, 16 and over. ONS, monthly, unit percent.
- `uk.gdp.qoq`: UK GDP, quarter on quarter growth. ONS, quarterly, unit percent.
- `uk.boe.bankrate`: Bank of England Bank Rate. BoE, daily, unit percent.
- `au.cpi.index`: Australia CPI, all groups, index. ABS, quarterly, unit index_2011_12_100.
- `au.unemployment.rate`: Australia unemployment rate. ABS, monthly, unit percent.
- `au.rba.cashrate`: RBA cash rate target. RBA, daily, unit percent.