Free Economic Calendar API

US macro release schedule as JSON, synced weekly from BLS, the Fed, and BEA, with actual values filled in after CPI and payroll releases. Official sources only.

Endpoints

GET

/api/markets/calendar?from=YYYY-MM-DD&to=YYYY-MM-DD&importance=high

Events in a window (default: last 7 days to next 30), oldest first.

GET

/api/markets/calendar/csv

Everything as CSV.

Example

curl "https://xoomar.com/api/markets/calendar?importance=high"

Response Shape

Every endpoint returns the same JSON envelope: { data, updatedAt, source, docs }. The data field is an array of records with these fields:

Field	Type	Description
source	string	bls, fed, or bea
eventName	string	CPI, Nonfarm Payrolls, FOMC Rate Decision, GDP...
importance	string	high, med, or low
scheduledAt	string (datetime)	Release time, UTC
periodLabel	string \| null	Reference period, e.g. 'December 2025'
previous	string \| null	Prior reading (same units as actual)
actual	string \| null	Filled after release: CPI YoY %, NFP monthly change in thousands

No forecast field: consensus forecasts come from paid surveys and no free official source publishes them. We won't fake it.

Numeric values arrive as strings where precision matters (prices, rates); parse with your language's decimal type for accounting-grade math. Rate limiting is fair-use per IP; a 429 response includes a Retry-After header. No authentication or API key needed. Attribution is appreciated: xoomar.com/markets.

Need more headroom? A free account raises your limit to 120 requests a minute with an X-API-Key header.

Dashboard →Rates API →

Frequently Asked Questions

Which events are included?

CPI and the jobs report from BLS, FOMC rate decisions from the Fed's published meeting calendar, and GDP estimates from BEA. High-signal US macro, nothing scraped from commercial calendars.

When do actuals appear?

Within the hour for CPI (year-over-year percent) and nonfarm payrolls (monthly change, thousands), pulled from the keyless BLS API.

What are the rate limits?

30 requests per minute per IP without a key, 120 with a free account key.

Is the schedule reliable?

It's the agencies' own published schedule, synced weekly. Agencies occasionally reschedule; the sync picks that up.

Data on this page is provided for informational purposes only and is not financial advice. See our editorial policy.