Early access is open. Free sample datasets are live now. Download a sample

Data product · Early access

Economic Calendar and Market Events API

When the next CPI, payrolls or Fed decision lands, to the minute in UTC, and what the last one printed, so your strategy knows to stand aside or get ready.

Coverage

What you get

Item Detail
Product code X-CALENDARS
Coverage Economic releases and central bank decisions, built from public agency calendars. IPO, dividend, split and holiday events come with the stocks plans
Granularity One record per event
History Past events with their released actual and previous values
Delivery REST
Update speed Schedule refreshed as agencies publish it; actual filled after each release

Release days move every market at once. A 13:30 UTC CPI print can wipe out a week of carefully placed stops in a minute. The schedule and the released values are public, so we give them away. Consensus forecasts are licensed, which is why they come later on Pro.

Schema

Schema

Field Type Required Description
event_id string yes Our ID
event_type string yes economic, central_bank, ipo, dividend, split, fda, holiday
symbol string yes Ticker for company events; series ID for economic events (e.g. CPIAUCSL)
event_name string yes e.g. CPI YoY
country string yes ISO code
date string yes YYYY-MM-DD
timestamp string optional Exact release time, UTC
importance string optional low, medium, high
actual number optional Released value
estimate number optional Consensus forecast
previous number optional Prior value
revised_previous number optional Prior value after revision
unit string optional e.g. percent
details object optional Type-specific fields, e.g. IPO price_range_low, price_range_high, exchange

Example record (illustrative, a scheduled release before it happens):

{
  "event_id": "econ-us-cpi-2026-11",
  "event_type": "economic",
  "symbol": "CPIAUCSL",
  "event_name": "CPI MoM",
  "country": "US",
  "date": "2026-12-10",
  "timestamp": "2026-12-10T13:30:00Z",
  "importance": "high",
  "actual": null,
  "estimate": null,
  "previous": 0.3,
  "unit": "percent"
}

Sample data

Sample data

No free calendar sample yet. A sample file is available on request: tell us the countries and the date range and we'll send the events in this schema.

The underlying series are already free to download: the US Economic Indicators sample has CPI, unemployment, payrolls, GDP and fed funds from FRED.

Use cases

Use cases

News blackout windows. Pull all importance high events for the next week and block new entries from 15 minutes before to 15 minutes after each timestamp. A simple rule that saves a lot of slippage.

Event-day backtests. Join historical events on date to your intraday bars and compare the volatility of release days with normal days. You'll often find a strategy that works well except on FOMC days.

Surprise trading. Once actual fills, compare it with previous, or with estimate when that's available on Pro. Size the reaction trade on the size of the miss.

IPO and dividend tracking. Filter event_type on ipo or dividend to keep a watchlist of new listings and ex-dates alongside the macro events.

Code

Code examples

Example: high-importance US events next week.

curl "https://api.marketdata.co/v1/calendar/economic?country=US&importance=high&start=2026-11-23&end=2026-11-27" \
  -H "Authorization: Bearer $MARKETDATA_API_KEY"

Example: Python, build blackout windows for a trading bot.

import os
import requests
import pandas as pd

resp = requests.get(
    "https://api.marketdata.co/v1/calendar/economic",
    params={"country": "US", "importance": "high", "start": "2026-11-23", "end": "2026-12-31"},
    headers={"Authorization": f"Bearer {os.environ['MARKETDATA_API_KEY']}"},
)
resp.raise_for_status()
ev = pd.DataFrame(resp.json()["results"])
ev["timestamp"] = pd.to_datetime(ev["timestamp"])
ev["block_from"] = ev["timestamp"] - pd.Timedelta(minutes=15)
ev["block_to"] = ev["timestamp"] + pd.Timedelta(minutes=15)
print(ev[["event_name", "block_from", "block_to"]])

Pricing

Pricing

Plan Economic calendar
Free, $0 Release schedule with actual and previous values
Pro, $79/mo Adds consensus estimates, once we license a source

Company events (IPOs, dividends, splits) come with the stocks plans. The calendar isn't sold as a dataset. Among the providers we studied, calendar data runs from $0 to $1,250 a month.

Side by side

How we compare

14 of the 50 providers we studied sell event calendars. The paid part elsewhere is usually the consensus forecast. We build the schedule and actuals from public agency calendars and give them away, with exact UTC release times, and add licensed estimates on Pro. Each economic event carries the same symbol as the series in our economic data API, so you can pull the full history behind any release.

FAQ

Frequently asked questions

What time zone are release times in?

UTC. US data released at 8:30 New York time is 13:30 UTC in winter and 12:30 UTC in summer, and the timestamp follows that shift.

Where do the actual values come from?

From the publishing agency, such as the BLS for CPI and payrolls. We fill actual after the release and keep the original previous value, with revised_previous when the agency revises it.

Do you include consensus forecasts?

Not on Free. Consensus forecasts are licensed, so estimate is planned for Pro once we have a source under contract.

Which countries are covered?

We start with US releases and central bank decisions and add other countries from their own agency calendars. Each event has an ISO country code.

How fast is actual filled after a release?

It is filled after the agency publishes. This calendar is not a low-latency news feed, so don't use it to trade the first second after a print.

Can I download the calendar as a file?

No. The calendar is API only. You can get the underlying economic series as free files in the economic data API.

Keep reading