Market Status API

Market Status & Holiday Calendar API

Q: Can I get holidays by year?

Yes. Call GET /markets/holidays with a year, and optionally a start and end date, to retrieve the holiday calendar for a market. This is useful for highlighting non-trading days in dashboards, scheduling jobs, or explaining why a market is closed.

Know exactly when crypto, forex, stocks, indices, ETFs, commodities, and CFD-style markets are open, closed, or in pre- and post-market. One REST call returns the current phase and the next open and close across every region you cover.

One REST call
UTC + local time
Regional calendars
Holidays & sessions

View API docsStart building freeDashboard

Live world market map

Every covered market on one map, colored by its current session phase. Hover a marker for the local time and the next open or close; click through for hours and holidays.

24-hour session timeline

The largest markets stacked on one clock, shown in your local time.

All covered markets

Session times are shown in each market’s own timezone. Open a market for its full schedule, auctions, and 2026 holiday calendar.

Market	Code	Local time	Trading hours (local)	Status	Details
United StatesNew York	`US`	—	09:30 – 16:00	—	→
ChinaShanghai	`CN`	—	09:30 – 11:30, 13:00 – 14:57	—	→
JapanTokyo	`JP`	—	09:00 – 11:30, 12:30 – 15:25	—	→
Hong KongHong Kong	`HK`	—	09:30 – 12:00, 13:00 – 16:00	—	→
CanadaToronto	`CA`	—	09:30 – 16:00	—	→
IndiaMumbai	`IN`	—	09:15 – 15:30	—	→
TaiwanTaipei	`TW`	—	09:00 – 13:25	—	→
United KingdomLondon	`GB`	—	08:00 – 16:30	—	→
GermanyFrankfurt	`DE`	—	09:00 – 17:30	—	→
FranceParis	`FR`	—	09:00 – 17:30	—	→

1–10 of 38 markets

Browse every market

Trading hours, session phases, auctions, and the 2026 holiday calendar for each covered market, grouped by region.

Status across every asset class

Each asset class maps to the same status shape the API returns, open, closed, or a session phase, with the next open and close. Mirror these states directly in your own dashboards and badges.

Crypto

—

Treated as continuously available, so status stays open unless a maintenance window applies.

24/7 session · UTC

Forex

—

Weekday UTC schedule that closes over the weekend, matching the global FX trading week.

Weekday window · closes on weekends

Stocks

—

Regional primary sessions with pre-market and post-market phases where the calendar models them.

Pre / primary / post · regional timezone

Indices & ETFs

—

Resolved against the same regional calendars using generic index and ETF codes from discovery.

Mapped to regional calendars

Commodities

—

A broad overnight reference window, Sunday 18:00 to Friday 17:00 New York with a daily one-hour pause, not an instrument-level venue schedule.

Reference window · metals, energy, ags

CFD-style feeds

—

Follow the same regional mapping as indices; unrecognized symbols return a safe unknown status.

Regional mapping · safe unknown fallback

Holiday calendar

Upcoming closures and early closes by region. Calendars can shift for local rule changes, special closures, or operational events, so treat each row as a planning reference rather than a guarantee.

Market	Date	Schedule	Notes
US	2026-11-27	Early close	Shortened primary session (model)
US	2026-12-25	Closed	Full-day closure (model)
DE	2026-04-03	Closed	Regional calendar entry
TR	2026-10-28	Early close	Half-day (model)

Market overview request

Use one request to check crypto, forex, regional stock calendars, selected index calendars, ETFs, and commodities.

Authenticate with your API key header, same as other REST routes.

Request

curl "https://api.tickerlayer.com/markets/status" \
  -H "x-api-key: YOUR_API_KEY"

GET/markets/statusResponse

{
  "server_time": "2026-05-04T13:44:27.672Z",
  "market": "mixed",
  "currencies": {
    "crypto": "open",
    "forex": "open"
  },
  "regions": {
    "us": "open",
    "gb": "open",
    "de": "open",
    "tr": "open",
    "in": "closed",
    "jp": "closed"
  }
}

Use cases

One status surface that keeps your UI honest and your integrations efficient, across every market you touch.

Smarter polling

Throttle or pause requests while a market is closed, then resume the moment it reopens.

Dashboard badges

Render accurate open, closed, pre-market, and post-market states straight from the API.

Job scheduling

Trigger syncs, alerts, and reports precisely around each market’s open and close.

Holiday awareness

Surface upcoming closures and early closes so workflows never run on a dark market.

Freshness controls

Validate data freshness against real trading hours instead of guessing from timestamps.

Multi-asset coverage

Track crypto, forex, stocks, indices, ETFs, and commodities through one consistent shape.

Coverage overview

What each asset class includes today across status, sessions, and holidays. Treat timings as a planning reference rather than a venue-level guarantee.

Asset class	Market status	Sessions	Holidays	Notes
Crypto	Always on	24/7	Not modeled	Continuous, aside from maintenance windows.
Forex	Weekly cycle	UTC windows	Not modeled	Opens on weekdays, closed over the weekend.
Stocks	Regional	Pre / primary / post	Seeded	Per-region calendars (US, GB, DE, and more).
Indices	Mapped	Regional	Where mapped	Resolved from generic index codes.
ETFs	Regional	Pre / primary / post	Seeded	Share the equities regional mapping.
Commodities	Reference	Overnight window	Not modeled	Broad metals and energy reference, not venue-specific.
CFDs	Mapped	Underlying	Where mapped	Follow the mapped underlying market.

Frequently asked questions

Is crypto always open?

Yes. Crypto markets are modeled as open 24/7, so the status endpoint reports them as continuously available. Treat brief gaps as operational maintenance rather than a market close, and always read the response timestamp before acting on a status.

Does forex close on weekends?

Yes. Forex follows a weekly trading window in UTC, so the market reports as closed over the weekend and reopens for the next session. The exact open and close times are returned with each status response, so your app can display them without hardcoding a schedule.

Can I get holidays by year?

Yes. Call GET /markets/holidays with a year, and optionally a start and end date, to retrieve the holiday calendar for a market. This is useful for highlighting non-trading days in dashboards, scheduling jobs, or explaining why a market is closed.

Are times returned in UTC?

Yes. All canonical timestamps are ISO-8601 in UTC, which keeps comparisons reliable across regions. Responses also include local timezone labels where applicable, so you can show users a familiar local time without converting it yourself.

Does the API support pre-market and post-market?

For regional equities where extended hours are modeled, a trading day can include pre-market, the primary session, and post-market phases. Each phase is labeled in the response so you can reflect the current session accurately instead of treating the day as a single open or closed state.

Is this endpoint available on the free plan?

Yes. Market status and holiday calendars are available to any valid API key, including free-tier keys, subject to standard rate limits. This makes it easy to add market awareness to a project before committing to a paid data feed.

Are these calendars official?

These calendars are provided for informational and integration use, not as an official exchange record. They are a practical reference and can change due to local rules, early closes, special closures, or operational events, so treat them as guidance rather than a regulatory source of truth.