Never Miss a Market-Moving Event
NFP, FOMC, CPI, ECB rate decisions -- the events that move markets by hundreds of pips.
Our /v1/calendar endpoint gives your system
advance warning, impact ratings, and consensus forecasts so you can act before the move.
Live
Actuals at Release
20+
Currencies Covered
3
Impact Levels
7d
Look-Ahead Window
Everything You Need for Event-Driven Trading
Structured economic data designed for algorithmic consumption
-
Impact Rating
High, Medium, Low impact classification so your system knows which events to prioritize.
-
Smart Filtering
Filter by currency (USD, EUR, GBP...), impact level, and date range. Get only the events that matter to your portfolio.
-
Forecast Data
Consensus forecast, previous value, and actual result (once released) for every event.
-
Precise Timing
UTC timestamps for every release. Know exactly when to widen stops, close positions, or prepare to enter.
Real Response Data
Upcoming high-impact events, structured for machines
GET /v1/calendar?currency=USD&impact=high&days=7&offset=0&limit=100{
"success": true,
"data": {
"events": [
{
"title": "Non-Farm Payrolls",
"currency": "USD",
"impact": "high",
"datetime": "2026-04-03T12:30:00Z",
"forecast": "185K",
"previous": "151K",
"actual": null,
"description": "Change in the number of employed people excluding farming industry"
},
{
"title": "FOMC Rate Decision",
"currency": "USD",
"impact": "high",
"datetime": "2026-04-07T18:00:00Z",
"forecast": "4.25%",
"previous": "4.50%",
"actual": null,
"description": "Federal funds target rate decision"
},
{
"title": "CPI m/m",
"currency": "USD",
"impact": "high",
"datetime": "2026-04-10T12:30:00Z",
"forecast": "0.3%",
"previous": "0.4%",
"actual": null,
"description": "Consumer Price Index, month-over-month change"
}
],
"total": 3,
"filters": {
"currency": "USD",
"impact": "high",
"days": 7
},
"last_updated": "2026-03-27T14:15:00Z",
"pagination": {
"offset": 0,
"limit": 100,
"total": 3,
"has_more": false
}
}
}Use Cases
How traders and developers use calendar data
Event-Driven Trading Bots
Automatically adjust position sizing, close open trades, or trigger straddle strategies 30 minutes before high-impact releases.
# Close all USD positions before NFP
events = get_calendar(currency="USD", impact="high")
for event in events:
if event["title"] == "Non-Farm Payrolls":
minutes_until = time_until(event["datetime"])
if minutes_until < 30:
close_all_usd_positions()Risk Management
Widen stop-losses or reduce leverage ahead of volatile releases. Your risk engine can query upcoming events and adjust parameters automatically.
// Reduce leverage before high-impact events
const events = await getCalendar({ days: 1, impact: "high" });
if (events.length > 0) {
await setMaxLeverage(5); // Reduce from 20x to 5x
console.log("High-impact event today - leverage reduced");
}News Trading Strategies
Compare actual vs forecast values when results are released. If actual CPI comes in higher than forecast, trigger buy on the affected currency. Calendar data makes this comparison trivial.
Dashboard Widgets
Build an upcoming-events widget for your trading dashboard. Filter by the currencies in your portfolio and show impact levels with color coding. The API does the heavy lifting.
Data Source & Freshness
Comprehensive Coverage
Central-bank decisions, employment, inflation, and other market-moving releases across major economies.
Live at Release
Released actual values are published at announcement time on plans with live actuals — not on a fixed refresh cycle. Consensus forecasts and previous values are available as soon as an event is scheduled.
Integration Examples
import requests
resp = requests.get(
"https://tickatlas.com/v1/calendar",
headers={"X-API-Key": "YOUR_API_KEY"},
params={
"currency": "USD,EUR",
"impact": "high",
"days": 3
}
)
events = resp.json()["data"]["events"]
for event in events:
print(f"{event['datetime']}: {event['title']}")
print(f" Impact: {event['impact']}")
print(f" Forecast: {event['forecast']}")
print(f" Previous: {event['previous']}")const res = await fetch(
"https://tickatlas.com/v1/calendar" +
"?currency=USD,EUR&impact=high&days=3",
{ headers: { "X-API-Key": "YOUR_API_KEY" } }
);
const { data } = await res.json();
// Check for events in the next hour
const now = new Date();
const upcoming = data.events.filter(e => {
const eventTime = new Date(e.datetime);
const hoursUntil = (eventTime - now) / 3600000;
return hoursUntil > 0 && hoursUntil < 1;
});
if (upcoming.length > 0) {
console.log("HIGH IMPACT EVENT WITHIN 1 HOUR");
}Frequently Asked Questions
Which currencies are supported?
All major currencies (USD, EUR, GBP, JPY, AUD, NZD, CAD, CHF) plus CNY, INR, BRL, and others. You can filter by one or multiple currencies using comma-separated values.
How far ahead does the calendar look?
Up to 7 days ahead. Most events are populated 1-2 weeks in advance. Central bank meetings and major releases (NFP, CPI, GDP) are typically available months ahead.
When are actual values populated?
Released values appear at announcement time on plans with live calendar actuals (Starter and above by default). Until release — and on tiers without live actuals — the actual field is null; forecast and previous are always available.
Is this available on all plans?
The calendar endpoint is available on all plans including the free trial (1 request per call). Live released actual values are included on Starter and higher plans; other tiers see forecast and previous with actual as null.
Trade the News with Confidence
Know what is coming before it moves the market. Start receiving structured economic calendar data in your trading system today.
14-day free trial / No credit card required / 1,000 requests included / Cancel anytime