GET/v1/market-holidays

Market Holidays

Retrieve the official market holiday schedule (including early close days).

Request

GET https://api.earningsapi.com/v1/market-holidays?apikey=YOUR_API_KEY
RequestPython
import requests

response = requests.get("https://api.earningsapi.com/v1/market-holidays", params={"apikey": "YOUR_API_KEY"}, timeout=30)
response.raise_for_status()
print(response.json())

Query parameters

No additional parameters.

Response fields

FieldTypeDescription
namestringHoliday name (may include "Observed")
datestringDate in YYYY-MM-DD format
statusstring"closed" or "early_close(13:00)"

Response example

JSON response
[
  { "name": "New Year's Day", "date": "2026-01-01", "status": "closed" },
  { "name": "MLK, Jr. Day", "date": "2026-01-19", "status": "closed" },
  { "name": "Presidents Day", "date": "2026-02-16", "status": "closed" },
  { "name": "Good Friday", "date": "2026-04-03", "status": "closed" },
  { "name": "Memorial Day", "date": "2026-05-25", "status": "closed" },
  { "name": "Juneteenth", "date": "2026-06-19", "status": "closed" },
  { "name": "Independence Day (Observed)", "date": "2026-07-03", "status": "closed" },
  { "name": "Labor Day", "date": "2026-09-07", "status": "closed" },
  { "name": "Thanksgiving Day", "date": "2026-11-26", "status": "closed" },
  { "name": "Day after Thanksgiving", "date": "2026-11-27", "status": "early_close(13:00)" },
  { "name": "Christmas Eve", "date": "2026-12-24", "status": "early_close(13:00)" },
  { "name": "Christmas Day", "date": "2026-12-25", "status": "closed" }
]

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