Skip to main content

​
Overview

The Trading Calendar API provides real-time metrics about NYSE (New York Stock Exchange) trading days and upcoming market holidays.

​
Features

Remaining Days

Trading days left in month and year

Next Holiday

Upcoming market closure information

Market Status

Is the market open today/tomorrow?

Holiday List

View upcoming market holidays

​
API Endpoint

​
GET /api/trading-calendar/metrics

Returns trading calendar metrics including remaining trading days and next market holiday. Authentication: None required. Response: 
{
  "success": true,
  "remaining_trading_days_month": 14,
  "remaining_trading_days_year": 36,
  "next_market_holiday": {
    "name": "Thanksgiving Day",
    "date": "2025-11-27"
  },
  "days_until_next_market_holiday": 19,
  "upcoming_holidays": [
    {
      "name": "Thanksgiving Day",
      "date": "2025-11-27",
      "days_until": 19
    },
    {
      "name": "Christmas Day",
      "date": "2025-12-25",
      "days_until": 47
    }
  ],
  "is_market_open_today": false,
  "is_market_open_tomorrow": false,
  "timezone": "America/New_York"
}

​
Response Fields

FieldTypeDescription
remaining_trading_days_monthintegerTrading days left in current month
remaining_trading_days_yearintegerTrading days left in current year
next_market_holidayobjectNext market closure info
days_until_next_market_holidayintegerDays until next closure
upcoming_holidaysarrayList of upcoming holidays (up to 10)
is_market_open_todaybooleanMarket open today?
is_market_open_tomorrowbooleanMarket open tomorrow?

​
Data Source

Uses pandas_market_calendars library for accurate NYSE calendar data.

​
Next Steps

API Reference

View full API documentation

Trading Analysis

Analyze trading performance