Get the trading weekdays

GET/api/v2/markets/{market}/trading-weekdays

The weekdays the market trades on, in force on a date (for example Sun to Thu), with the dates that pattern starts and ends

One request: one schedule. A successful response counts as one request

Parameters

Name	In	Description
`market`required	path	Market id, as listed by `GET /markets` (for example `nyse`, `lse`, `cme-equity-futures`)Example: `nyse`
`date`optional	query	Date the schedule is in force, YYYY-MM-DD. Defaults to today in the market's time zoneExample: `2026-11-27`

Example

curl https://marketcalendars.com/api/v2/markets/tase/trading-weekdays?date=2025-06-01 \
  -H "Authorization: Bearer mc_live_..."

const res = await fetch("https://marketcalendars.com/api/v2/markets/tase/trading-weekdays?date=2025-06-01", {
  headers: { Authorization: `Bearer ${process.env.MARKETCALENDARS_KEY}` },
});
const data = await res.json();

import os, requests

res = requests.get(
    "https://marketcalendars.com/api/v2/markets/tase/trading-weekdays?date=2025-06-01",
    headers={"Authorization": f"Bearer {os.environ['MARKETCALENDARS_KEY']}"},
)
data = res.json()

GET /api/v2/markets/tase/trading-weekdays?date=2025-06-01200

{
  "market": "tase",
  "date": "2025-06-01",
  "effectiveFrom": null,
  "effectiveTo": "2026-01-04",
  "weekdays": [
    1,
    2,
    3,
    4,
    7
  ],
  "names": [
    "Monday",
    "Tuesday",
    "Wednesday",
    "Thursday",
    "Sunday"
  ],
  "label": "Mon–Thu, Sun",
  "weekmask": "1111001"
}

A live response from the API. Lists longer than seven items are cut to three here

Response fields

TradingWeekdays object. Fields marked | null are always present and may be null

Field	Type	Description
market	string	Market id
date	string (date)	Date the pattern is in force
effectiveFrom	string (date) \| null	First date of this weekly pattern. Null when it starts before our data
effectiveTo	string (date) \| null	Last date of this weekly pattern. Null when it runs past our data
weekdays	integer[]	ISO weekdays, 1 = Monday
names	string[]	Weekday names
label	string	Short label for display
weekmask	string	Seven 0/1 flags, Monday first

Errors

400invalid-parameterA path or query parameter is malformed, such as a date that is not YYYY-MM-DD
401unauthorizedThe Authorization header is missing, malformed, or names a revoked key
404unknown-marketNo market has that id. GET /markets lists every id
404out-of-rangeThe date or year is outside the market's coverage
429rate-limitedThe key sent more requests in a minute than its plan's burst limit
429quota-exceededThe plan's requests for this period are used up