Economic Calendar API

Scheduled economic events, forecasts and previous values for all major currencies, served from a database in milliseconds. All times are UTC (ISO-8601).

Quick start

curl "https://calendar.quiply.net/v1/calendar?date=2026-10-16&currency=USD&impact=high" \
  -H "X-API-Key: YOUR_KEY"

Authentication

Every request must include your key in the X-API-Key header. You get your key instantly on the pricing section. Keep it secret — don't put it in public front-end code.

Base URL: https://calendar.quiply.net

GET/v1/calendar

All events for one UTC day.

ParameterTypeDescription
date requiredstringUTC day, YYYY-MM-DD
currencyCSVe.g. USD,EUR
impactCSVlow, medium, high, holiday
{
  "date": "2026-10-16",
  "count": 1,
  "events": [
    {
      "id": "…",
      "currency": "USD",
      "title": "Core Retail Sales m/m",
      "impact": "high",
      "event_time": "2026-10-16T12:30:00+00:00",
      "actual": null,
      "forecast": "0.3%",
      "previous": "0.2%",
      "detail_url": "…"
    }
  ]
}

GET/v1/calendar/week

A 7-day window starting on start. Response: {"start", "days": 7, "count", "events": [...]}

ParameterTypeDescription
start requiredstringUTC start day, YYYY-MM-DD
currencyCSVOptional currency filter
impactCSVOptional impact filter

GET/v1/calendar/upcoming

Events in the next N hours — ideal for alerts and trading bots.

ParameterTypeDescription
hoursintegerLook-ahead window, 1–336 (default 48)
currencyCSVOptional currency filter
impactCSVOptional impact filter
curl "https://calendar.quiply.net/v1/calendar/upcoming?hours=24&impact=high" -H "X-API-Key: YOUR_KEY"

GET/v1/health

Service status and data freshness. No key needed.

The calendar covers scheduled events with forecast and previous values. Actual (released) values are not included.

Errors

StatusMeaning
401Missing or invalid X-API-Key
403Subscription inactive (cancelled or payment failed)
422Bad parameter (e.g. wrong date format)
429Monthly request quota reached

Pricing

Free trial: 5 requests/day. All APIs plan: $9.95/month gives you every Quiply API, 250,000 requests a month.

Get your API key