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