GETPopular
/v1/calendar/economicEconomic Calendar
Retrieve economic events for a specific date. Accepts YYYY-MM-DD or the strings today, yesterday, tomorrow (resolved in New York time). Time is Eastern Time (ET).
Historical access
Free plans can access the most recent 24 months of historical data. Pro plans can access all available history.
Request
GET https://api.earningsapi.com/v1/calendar/economic?date=2026-01-31&usmajor=true&apikey=YOUR_API_KEYRequestPython
import requests
response = requests.get("https://api.earningsapi.com/v1/calendar/economic?date=2026-01-31&usmajor=true", params={"apikey": "YOUR_API_KEY"}, timeout=30)
response.raise_for_status()
print(response.json())Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
date | string | Yes | Date in YYYY-MM-DD (e.g. "2026-01-31"), or the strings "today", "yesterday", "tomorrow" (resolved in New York time) |
usmajor | boolean | No | If true, returns U.S. major indicators only (default: false) |
Response fields
| Field | Type | Description |
|---|---|---|
country | string | Country or region name |
eventName | string | Event name (e.g., "PPI") |
date | string | Event date in YYYY-MM-DD format |
time | string | Time in ET (e.g., "08:30") or "24H" |
actual | string | null | Actual value (null if not released yet) |
consensus | string | null | Market consensus/forecast (may be null) |
previous | string | null | Previous value (may be null) |
Response example
JSON response
[
{
"country": "United States",
"eventName": "PPI",
"date": "2026-01-31",
"time": "08:30",
"actual": null,
"consensus": "0.2%",
"previous": "0.2%"
},
{
"country": "United States",
"eventName": "Core PPI",
"date": "2026-01-31",
"time": "08:30",
"actual": null,
"consensus": "0.3%",
"previous": "0.0%"
},
{
"country": "Japan",
"eventName": "Housing Starts",
"date": "2026-01-31",
"time": "24H",
"actual": null,
"consensus": "-4.5%",
"previous": "-8.5%"
}
]