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¤cy=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.
| Parameter | Type | Description |
|---|---|---|
date required | string | UTC day, YYYY-MM-DD |
currency | CSV | e.g. USD,EUR |
impact | CSV | low, 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": [...]}
| Parameter | Type | Description |
|---|---|---|
start required | string | UTC start day, YYYY-MM-DD |
currency | CSV | Optional currency filter |
impact | CSV | Optional impact filter |
GET/v1/calendar/upcoming
Events in the next N hours — ideal for alerts and trading bots.
| Parameter | Type | Description |
|---|---|---|
hours | integer | Look-ahead window, 1–336 (default 48) |
currency | CSV | Optional currency filter |
impact | CSV | Optional 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
| Status | Meaning |
|---|---|
| 401 | Missing or invalid X-API-Key |
| 403 | Subscription inactive (cancelled or payment failed) |
| 422 | Bad parameter (e.g. wrong date format) |
| 429 | Monthly 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