Market Infrastructure

The market infrastructure endpoints expose exchange-level data: which markets are available, whether they are currently open, their regular trading hours, and scheduled holidays. Use these to gate trading logic, display status indicators, or plan around market closures.

Endpoints

Endpoint	Summary	Key use case
`GET /stocks/markets`	Exchange metadata	Timezone, currency, working hours for each exchange
`GET /stocks/markets/status`	Current market status	Is this exchange open right now?
`GET /stocks/markets/hours`	Trading session hours	Regular open/close times, half-days
`GET /stocks/markets/holidays`	Market holidays	Planned closures within a date range
`GET /stocks/countries`	Available countries	Which markets are covered by the API

Exchanges

Endpoint: GET /stocks/markets Returns metadata for all exchanges available in the API. Each exchange is identified by its MIC code (Market Identifier Code, ISO 10383) — the global standard for identifying trading venues. Pass one or more comma-separated MIC codes via the mic parameter to filter results. Key fields

Field	Type	What it means
`mic`	string	ISO 10383 Market Identifier Code (e.g. `XNAS` for NASDAQ)
`exchange`	string	Full legal name of the exchange
`timezone`	string	IANA timezone identifier (e.g. `America/New_York`)
`currency_code`	string	ISO 4217 currency for this market
`open_time`	string	Regular session open time in local market time
`close_time`	string	Regular session close time in local market time
`working_days`	array	Days of the week the market operates
`dst`	boolean	Whether Daylight Saving Time is currently in effect
`previous_dst_transition`	string	Date of the most recent DST change
`next_dst_transition`	string	Date of the upcoming DST change

When to use

Building a market selector UI that shows exchange names, timezones, and currencies
Converting market open/close times to the user’s local timezone using the timezone field
Determining which currency a stock is quoted in

Example

# Get metadata for NYSE and NASDAQ
curl "https://api.tradewatch.io/stocks/markets?mic=XNYS,XNAS" \
  -H "api-key: YOUR_API_KEY"

Market Status

Endpoint: GET /stocks/markets/status Returns the current open/closed status for one or more exchanges. The status accounts for scheduled holidays and half-days but does not factor in circuit breakers, trading halts, or unscheduled closures. Key fields

Field	Type	What it means
`mic`	string	Market Identifier Code
`status`	string	Current status: `open` or `closed`
`is_business_day`	boolean	Whether today is a scheduled trading day
`is_early_close`	boolean	Whether today is a half-day with an early close
`holiday_name`	string	Name of the holiday if the market is closed for one
`local_time`	string	Current local time at the exchange
`open_time` / `close_time`	string	Today’s session times (adjusted for half-days)

When to use

Deciding whether to display a “Market Open” badge in your UI
Pausing data refresh loops when a market is closed
Showing a countdown to market open

Interpretation: A status: open response means the exchange is in a scheduled trading session. It does not guarantee that all individual stocks are actively trading — securities may be halted at the exchange or regulatory level. Circuit breakers and individual trading halts are not reflected in this endpoint. Example

curl "https://api.tradewatch.io/stocks/markets/status?mic=XNAS" \
  -H "api-key: YOUR_API_KEY"

Trading Hours & Holidays

Endpoints: GET /stocks/markets/hours · GET /stocks/markets/holidays /hours returns the regular trading session times for each exchange, including half-day schedules. /holidays returns planned market closures within a start/end date range (YYYY-MM-DD format). Both endpoints accept comma-separated mic codes to filter by exchange. Key fields — hours

Field	What it means
`open_time`	Normal session start
`close_time`	Normal session end
`early_close_time`	Close time on half-day sessions

Key fields — holidays

Field	What it means
`date`	Date of the holiday (YYYY-MM-DD)
`name`	Name of the holiday
`is_early_close`	Whether the market closes early rather than fully

When to use

Rendering a market calendar for users
Scheduling jobs that should not run during market closures
Displaying upcoming holidays or early-close days in a trading platform

Example

# NYSE holidays for a specific date range
curl "https://api.tradewatch.io/stocks/markets/holidays?mic=XNYS&start=2025-01-01&end=2025-12-31" \
  -H "api-key: YOUR_API_KEY"

# Trading hours for multiple exchanges
curl "https://api.tradewatch.io/stocks/markets/hours?mic=XNYS,XNAS,XLON" \
  -H "api-key: YOUR_API_KEY"

Platform

REST API reference

WebSocket API reference

Endpoints

Exchanges

Market Status

Trading Hours & Holidays

​Endpoints

​Exchanges

​Market Status

​Trading Hours & Holidays

Endpoints

Exchanges

Market Status

Trading Hours & Holidays