API Documentation

REST API for US stock market hours data

Coming Soon

Overview

Access real-time US stock market hours, holiday schedules, and trading day information through our REST API. All times are returned in UTC (ISO 8601).

Planned API Specification

Endpoints shown below are planned specifications — not yet publicly operational. Contact mopentime@gmail.com to express interest or request early access when the API launches.

Planned /market-hours/today

Current day market hours and status

Example Response

{
  "date": "2026-07-04",
  "day_of_week": "Saturday",
  "is_open": false,
  "status": "CLOSED",
  "open_time_utc": null,
  "close_time_utc": null,
  "notes": "Weekend - Market Closed"
}

Planned /market-hours/week

7-day schedule starting from today

Example Response

{
  "days": [
    {
      "date": "2026-07-06",
      "day_of_week": "Monday",
      "is_open": true,
      "status": "OPEN",
      "open_time_utc": "2026-07-06T13:30:00Z",
      "close_time_utc": "2026-07-06T20:00:00Z",
      "notes": "Regular trading hours"
    }
  ]
}

Planned /market-hours/date/{date}

Market hours for a specific date

Parameters

date

string(required)

Date in YYYY-MM-DD format

Example Response

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

Planned /market-hours/range

Market hours for a date range

Parameters

start_date

string (query)(required)

Start date (YYYY-MM-DD)

end_date

string (query)(required)

End date (YYYY-MM-DD)

Example Response

{
  "start_date": "2026-07-06",
  "end_date": "2026-07-10",
  "days": [
    {
      "date": "2026-07-06",
      "is_open": true,
      "status": "OPEN"
    }
  ]
}

Planned /insights

Latest market insights articles (paginated)

Parameters

limit

integer (query)

Results per page (default 20, max 100)

offset

integer (query)

Pagination offset (default 0)

Example Response

{
  "articles": [
    {
      "id": 1,
      "slug": "example-article",
      "title": "Example Title",
      "description": "Article summary...",
      "source": "Reuters",
      "author": "Market Open Time",
      "published_at": "2026-03-30T10:30:00Z"
    }
  ],
  "total": 42,
  "limit": 20,
  "offset": 0
}

Planned /insights/{slug}

Single article by slug

Parameters

slug

string(required)

Article URL slug

Example Response

{
  "id": 1,
  "slug": "example-article",
  "title": "Example Title",
  "description": "Article summary...",
  "content": "Full article content...",
  "source": "Reuters",
  "source_url": "https://reuters.com/article/...",
  "author": "Market Open Time",
  "published_at": "2026-03-30T10:30:00Z"
}

Planned /health

Health check

Example Response

{
  "status": "healthy"
}

Authentication

When authentication is enabled, include your API key as a header:

X-API-Key: your-api-key

Requests without a valid key return 401
Keep your key secure and out of client-side code
Contact mopentime@gmail.com to request a key

Notes

This specification is subject to change before launch
All times will be returned in UTC (ISO 8601)
Data will refresh daily from official exchange calendars
Rate limits and authentication will be determined before public launch