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

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

Pro

  • 300 requests / minute
  • Unlimited daily requests
  • Unlimited monthly requests
  • All available history on supported endpoints

Free daily and monthly quotas reset in New York time. Historical access applies to endpoints marked Historical access.

View usage and plans