API Documentation

Market Open Time API

Coming Soon

Overview

Access real-time US stock market hours, holiday schedules, and trading day information through our REST API. All times are provided in UTC and include timezone conversion support.

Public API Coming Soon

The API is currently in development. Public access with API key authentication will be available soon. Contact us if you're interested in early access.

Base URL: https://us-market-hours-api-production.up.railway.app

GET/market-hours/today

Get current day market hours and status

Example Response

{
  "date": "2025-12-01",
  "day_of_week": "Monday",
  "is_open": true,
  "status": "OPEN",
  "open_time_utc": "2025-12-01T14:30:00Z",
  "close_time_utc": "2025-12-01T21:00:00Z",
  "notes": "Regular trading hours"
}

GET/market-hours/week

Get 7-day schedule starting from today

Example Response

{
  "days": [
    {
      "date": "2025-12-01",
      "day_of_week": "Monday",
      "is_open": true,
      "status": "OPEN",
      "open_time_utc": "2025-12-01T14:30:00Z",
      "close_time_utc": "2025-12-01T21:00:00Z",
      "notes": "Regular trading hours"
    }
  ]
}

GET/market-hours/date/{date}

Get market hours for a specific date

Parameters

date

string(required)

Date in YYYY-MM-DD format (e.g., 2025-12-25)

Example Response

{
  "date": "2025-12-25",
  "day_of_week": "Thursday",
  "is_open": false,
  "status": "CLOSED",
  "open_time_utc": null,
  "close_time_utc": null,
  "notes": "Christmas Day - Market Closed"
}

GET/market-hours/range

Get market hours for a date range

Parameters

start_date

string (query)(required)

Start date in YYYY-MM-DD format

end_date

string (query)(required)

End date in YYYY-MM-DD format

Example Response

{
  "start_date": "2025-12-01",
  "end_date": "2025-12-07",
  "days": [
    {
      "date": "2025-12-01",
      "is_open": true,
      "status": "OPEN"
    }
  ]
}

GET/news

Get latest market news from trusted financial sources

Example Response

{
  "articles": [
    {
      "title": "Market Update: Stocks Rally on Economic Data",
      "link": "https://example.com/article",
      "description": "US stocks climbed as economic indicators...",
      "pubDate": "2025-12-01T10:30:00Z",
      "source": "Reuters"
    }
  ]
}

GET/health

Health check endpoint

Example Response

{
  "status": "healthy"
}

API Authentication

When API authentication is enabled, all requests must include an API key in the header:

X-API-Key: your-api-key-here

API keys will be provided upon request during beta
Requests without valid API keys will receive 401/403 errors
Keep your API key secure and don't share it publicly

Important Notes

All times are returned in UTC format (ISO 8601)
Data is updated daily at 6:00 AM UTC
Currently in development - API subject to change
Rate limiting will be applied for public access