Market Holidays API

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

GET /v1/market-holidays

Quick Copy & Paste

https://api.earningsapi.com/v1/market-holidays?apikey=YOUR_API_KEY

Parameters

Query

Parameter	Type	Required	Description
`apikey`	string	Yes	Your API key

No additional parameters required. This endpoint returns an array of holiday objects.

Response Example

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

Holiday Object Fields

Field	Type	Description
`name`	string	Holiday name (may include "Observed")
`date`	string	Date in YYYY-MM-DD format
`status`	string	`closed` or `early_close(13:00)`

cURL Example

curl "https://api.earningsapi.com/v1/market-holidays?apikey=YOUR_API_KEY"

Rate Limiting

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