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).
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%"
}
]