/v2/calendar/economicEconomic Calendar
Retrieve economic events for a New York date and country. Dates accept YYYY-MM-DD, today, yesterday, or tomorrow. Times use Eastern Time (ET).
Historical access
Free plans can access the most recent 24 months of historical data. Pro plans can access all available history.
Coverage and available history vary by indicator and country. A null value is unavailable and must not be treated as zero. Applies to actual, consensus, and previous. Free updates values once daily for events dated today or later. Pro updates values every 5 minutes. Today is determined in America/New_York at request time, using each event's official date. Earlier events return the same latest available values on both plans, subject to historical access limits. Event schedules remain available; values not yet available in the Free daily update are null, not zero. This difference applies only to the fields listed here, not all API data.
Request
GET https://api.earningsapi.com/v2/calendar/economic?date=2026-10-30&country=US&apikey=YOUR_API_KEYimport requests
response = requests.get("https://api.earningsapi.com/v2/calendar/economic?date=2026-10-30&country=US", 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) |
country | string | No | Country or region code: US, GB, JP, CN, DE, EA, CA, AU. Defaults to US. Response country values are display names, such as United States. |
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, including the measure, period, and adjustment basis when applicable. |
date | string | Event date in YYYY-MM-DD format |
time | string | null | Time in ET as HH:mm, or null when the release time is not established. |
actual | string | null | Reported value as a string, or null when unavailable or not yet reported. |
consensus | string | null | Forecast as a string; units may be included (for example, 0.8%). May be null. |
previous | string | null | Previous-period value as a string; units may be included (for example, 0.8%). May be null. |
Response example
[
{
"country": "United States",
"eventName": "U.S. ECI Total Compensation QoQ SA",
"date": "2026-10-30",
"time": "08:30",
"actual": "0.8%",
"consensus": "0.8%",
"previous": "0.9%"
},
{
"country": "United States",
"eventName": "U.S. ECI Wages and Salaries QoQ SA",
"date": "2026-10-30",
"time": "08:30",
"actual": "0.7%",
"consensus": "0.8%",
"previous": "0.9%"
}
]