Example

Macro Calendar Filter

Display macro events that may affect trading plans.

Request

GET https://api.earningsapi.com/v1/calendar/economic?date=today&usmajor=true&apikey=YOUR_API_KEY

Code example

ExamplePython
import requests

API_KEY = "YOUR_API_KEY"
response = requests.get("https://api.earningsapi.com/v1/calendar/economic?date=today&usmajor=true", params={"apikey": API_KEY}, timeout=30)
response.raise_for_status()
print(response.json())

Result shape

countryeventNametimeconsensus
United StatesPPI08:30 ET0.2%
United StatesCore PPI08:30 ET0.3%

Build steps

  1. 1Call the economic calendar endpoint for date=today.
  2. 2Set usmajor=true when the dashboard only needs U.S. major events.
  3. 3Render time, actual, consensus, and previous fields in the event row.

Quota and limits

Free tier includes 60 requests per minute, 100 requests per day, and 1,000 requests per month. Paid plans are built for production use with higher limits and a 300 requests per minute rate limit. Daily and monthly reset windows use New York time.

View usage