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.
15min
Refresh Interval
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
ForexFactory Source
Calendar data is sourced from ForexFactory, the most widely used economic calendar in retail and institutional forex trading. Events are verified against central bank schedules.
15-Minute Refresh
Data is refreshed every 15 minutes to capture newly added events, revised forecasts, and actual release values. The last_updated field in every response tells you exactly when.
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?
Actual values appear within the next 15-minute refresh cycle after the official release. The actual field is null until the data is released.
Is this available on all plans?
Yes. The calendar endpoint is available on all plans including the free trial. It counts as 1 request per call.
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