GETPopular/v2/calendar/economic

Economic 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_KEY
RequestPython
import 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

NameTypeRequiredDescription
datestringYesDate in YYYY-MM-DD (e.g. "2026-01-31"), or the strings "today", "yesterday", "tomorrow" (resolved in New York time)
countrystringNoCountry or region code: US, GB, JP, CN, DE, EA, CA, AU. Defaults to US. Response country values are display names, such as United States.
usmajorbooleanNoIf true, returns U.S. major indicators only (default: false)

Response fields

FieldTypeDescription
countrystringCountry or region name
eventNamestringEvent name, including the measure, period, and adjustment basis when applicable.
datestringEvent date in YYYY-MM-DD format
timestring | nullTime in ET as HH:mm, or null when the release time is not established.
actualstring | nullReported value as a string, or null when unavailable or not yet reported.
consensusstring | nullForecast as a string; units may be included (for example, 0.8%). May be null.
previousstring | nullPrevious-period value as a string; units may be included (for example, 0.8%). May be null.

Response example

JSON response
[
  {
    "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%"
  }
]

Data API quota and limits

Compare plan limits and historical data access.

Free

  • 60 requests / minute
  • 100 requests / day
  • 1,000 requests / month
  • The most recent 24 months of historical data on supported endpoints
  • Earnings & economic values: Once daily

Pro

Price increasing soon
  • 300 requests / minute
  • Unlimited daily requests
  • Unlimited monthly requests
  • All available history on supported endpoints
  • Earnings & economic values: Every 5 minutes

Get Pro before the price goes up.

Upgrade to Pro

Earnings & economic values for today and upcoming dates. Past dates use the latest available values on both plans. Dates use New York time. Free daily and monthly quotas reset in New York time. Historical access applies to endpoints marked Historical access.

View usage and plans