---
title: "Next open/close times"
method: GET
path: "/v5/schedule"
tags: ["Market State"]
---

# Next open/close times

`GET /v5/schedule`

## Request

- Base URL: `https://headlessoracle.com`
- URL: `https://headlessoracle.com/v5/schedule`
- Auth: none declared

Schedule-based next session open and close times in UTC. Not signed. Does not reflect real-time halts or KV overrides. For authoritative status use /v5/demo or /v5/status.

## Query parameters

- `mic` string

## Response `200`

Schedule data

- object
  - `mic` string
  - `name` string
  - `timezone` string: IANA timezone name.
  - `queried_at` string, date-time
  - `current_status` 'OPEN' | 'CLOSED' | 'HALTED' | 'UNKNOWN': UNKNOWN MUST be treated as CLOSED. Halt all execution.
  - `next_open` string, date-time, nullable
  - `next_close` string, date-time, nullable
  - `lunch_break` object, nullable: Null if no lunch break. start/end are local exchange time (HH:MM). See timezone field.
    - `start` string
    - `end` string
  - `note` string

## Other responses

- `400`: Unknown MIC

---

[API](https://skmtc.dev/headlessoracle/apis/headless-oracle.md) · [All operations](https://skmtc.dev/headlessoracle/apis/headless-oracle/llms.txt) · [OpenAPI document](https://skmtc.dev/headlessoracle/apis/headless-oracle/revisions/4e82fe332f29?raw)