Economic Calendar API
Upcoming economic events with impact levels, forecasts, and actual values. Filter by currency, filter by impact. Automate your news trading workflow.
-
Impact Levels
Filter events by high, medium, or low impact. Focus on market-moving events like NFP, FOMC, and ECB decisions.
-
Currency Filtering
Get events for USD, EUR, GBP, JPY, or any currency. Build currency-specific event monitors.
-
Forecast vs Actual
Events include forecast and previous values. Actual values are added when released — detect surprises programmatically.
-
News Trading Automation
Combine calendar data with indicator analysis. Check RSI before NFP, monitor ATR after release.
-
Content Generation
Generate "week ahead" sections for newsletters automatically. List upcoming events with forecasts.
-
Dashboard Integration
Feed calendar data into your trading dashboard. Show upcoming events alongside indicator readings.
Calendar API Example
# Get high-impact USD events
curl -H "X-API-Key: YOUR_KEY" \
"https://tickatlas.com/v1/calendar?currencies=USD&impact=high&offset=0&limit=100"
# Response:
{
"success": true,
"data": {
"events": [
{
"event": "Non-Farm Payrolls",
"datetime": "2026-04-03T13:30:00+00:00",
"currency": "USD",
"impact": "high",
"forecast": "180K",
"previous": "151K",
"actual": null
},
{
"event": "FOMC Statement",
"datetime": "2026-04-07T19:00:00+00:00",
"currency": "USD",
"impact": "high",
"forecast": "5.25%",
"previous": "5.25%",
"actual": null
}
],
"pagination": {
"offset": 0,
"limit": 100,
"total": 2,
"has_more": false
}
}
} Calendar API Endpoints
| Endpoint | Parameters | Description |
|---|---|---|
/v1/calendar | None | All upcoming events |
/v1/calendar?impact=high | impact | High-impact events only |
/v1/calendar?currencies=USD | currency | USD events only |
/v1/calendar?currencies=EUR&impact=high | Both | High-impact EUR events |
Frequently Asked Questions
What data does the economic calendar API return?
Each event includes: title, date/time, currency, impact level (low/medium/high), forecast value, previous value, and actual value (when released). Filter by currency or impact.
Can I filter events by impact level?
Yes. Use the impact parameter: /v1/calendar?impact=high returns only high-impact events like NFP, FOMC, and ECB rate decisions.
Can I filter by currency?
Yes. Use the currencies parameter: /v1/calendar?currencies=USD returns only USD-related events. Combine with impact: ?currencies=EUR&impact=high.
How far ahead does the calendar go?
The calendar includes events for the current and upcoming week. Events are updated as forecasts and actual values become available.
Can I use this for news trading automation?
Yes. Poll the calendar to detect upcoming high-impact events, then use /v1/indicator to analyze pre-event positioning. See our news trading use case for a full architecture.
Never Miss a Market-Moving Event
14-day free trial. Economic calendar with impact filtering and forecast data.