TickAtlas
Calendar API Last updated: March 2026

Economic Calendar API

Access scheduled economic events — NFP, CPI, FOMC, interest rate decisions, and 100+ more — with impact ratings, forecasts, previous readings, and actuals published the moment they release.

Endpoint

endpoint 
GET https://tickatlas.com/v1/calendar

Requires X-API-Key header. Returns upcoming scheduled events with optional filtering.

Query Parameters

Parameter Type Default Description
next_hours integer 24 Hours ahead to look. Max 168 (7 days).
impact string all Filter by impact: low, medium, high, or omit for all.
currencies string — Comma-separated currency codes: USD,EUR,GBP
offset integer 0 Number of results to skip for pagination.
limit integer 100 Max events to return (1-500).

Response Fields

Field Description
datetimeISO 8601 UTC timestamp of the event release
currencyAffected currency (USD, EUR, GBP, JPY, etc.)
eventFull event name (e.g., "Non-Farm Payrolls")
impactEvent market impact: low, medium, or high
forecastAnalyst consensus forecast (string, may include units)
previousPrior period reading
actualnull before release; populated with the actual result as soon as it's available
minutes_untilMinutes until event; negative means event already occurred

Example Response

200 OK 
{
  "success": true,
  "events": [
    {
      "id": "event_001",
      "datetime": "2026-03-29T13:30:00Z",
      "currency": "USD",
      "event": "Non-Farm Payrolls",
      "impact": "high",
      "forecast": "195K",
      "previous": "187K",
      "actual": null,
      "minutes_until": 42
    },
    {
      "id": "event_002",
      "datetime": "2026-03-29T15:00:00Z",
      "currency": "USD",
      "event": "ISM Manufacturing PMI",
      "impact": "medium",
      "forecast": "51.2",
      "previous": "50.8",
      "actual": "51.9",
      "minutes_until": -18
    }
  ],
  "pagination": {
    "offset": 0,
    "limit": 100,
    "total": 2,
    "has_more": false
  }
}

Code Examples

cURL

cURL 
# Get all high-impact events in the next 24 hours
curl -X GET "https://tickatlas.com/v1/calendar?impact=high&next_hours=24&offset=0&limit=100" \
  -H "X-API-Key: YOUR_API_KEY"

# Filter by currency
curl -X GET "https://tickatlas.com/v1/calendar?currencies=USD,EUR&next_hours=48&offset=0&limit=100" \
  -H "X-API-Key: YOUR_API_KEY"

# All events this week (168 hours)
curl -X GET "https://tickatlas.com/v1/calendar?next_hours=168&offset=0&limit=100" \
  -H "X-API-Key: YOUR_API_KEY"

Python

Python 
import requests

API_KEY = "YOUR_API_KEY"
BASE_URL = "https://tickatlas.com/v1/calendar"

# Get high-impact events in the next 24 hours
def get_high_impact_events(hours_ahead=24):
    r = requests.get(
        BASE_URL,
        headers={"X-API-Key": API_KEY},
        params={"impact": "high", "next_hours": hours_ahead}
    )
    return r.json().get("events", [])

# Get events for specific currencies
def get_usd_eur_events():
    r = requests.get(
        BASE_URL,
        headers={"X-API-Key": API_KEY},
        params={"currencies": "USD,EUR", "next_hours": 48}
    )
    return r.json().get("events", [])

events = get_high_impact_events(24)
for e in events:
    print(f"{e['datetime']} | {e['currency']} | {e['event']} | Impact: {e['impact']}")
    if e["actual"]:
        print(f"  Result: {e['actual']} vs Forecast: {e['forecast']}")

Common Use Cases

News Trading Bot

Poll the calendar before each new position entry. If minutes_until < 30 and impact === "high", hold off on new trades until after the release.

Beat/Miss Momentum Signal

After datetime passes, poll until actual is non-null. Compare to forecast — a significant beat often triggers a momentum move in the affected currency.

Pre-Event Discord Alert

Run every 5 minutes. When minutes_until <= 30 for a high-impact event, fire a Discord or Slack webhook to alert your team.

Related Resources