Economic Calendar API

Retrieve economic events for a specific date. Time is Eastern Time (ET).

GET /v1/calendar/economic

Quick Copy & Paste

https://api.earningsapi.com/v1/calendar/economic?date=2026-01-31&apikey=YOUR_API_KEY

https://api.earningsapi.com/v1/calendar/economic?date=2026-01-31&usmajor=true&apikey=YOUR_API_KEY

usmajor controls filtering:

• usmajor=true → U.S. major indicators only
• Default: false (returns broader global events)

Parameters

Query

Parameter	Type	Required	Description
`date`	string	Yes	Date in YYYY-MM-DD format (e.g., "2026-01-31")
`usmajor`	boolean	No	If true, returns U.S. major indicators only (default: false)
`apikey`	string	Yes	Your API key

Response Example

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

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)

cURL Example

curl "https://api.earningsapi.com/v1/calendar/economic?date=2026-01-31&apikey=YOUR_API_KEY"

Rate Limiting

Free tier: 1,000 requests / month
429 returned when limit is exceeded