> ## Documentation Index
> Fetch the complete documentation index at: https://docs.miningwood.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Trading Calendar

> Real-time market trading days and holiday information

## Overview

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

## Features

<CardGroup cols={2}>
  <Card title="Remaining Days" icon="calendar-days">
    Trading days left in month and year
  </Card>

  <Card title="Next Holiday" icon="flag">
    Upcoming market closure information
  </Card>

  <Card title="Market Status" icon="clock">
    Is the market open today/tomorrow?
  </Card>

  <Card title="Holiday List" icon="list">
    View upcoming market holidays
  </Card>
</CardGroup>

## API Endpoint

### GET /api/trading-calendar/metrics

Returns trading calendar metrics including remaining trading days and next market holiday.

**Authentication**: None required.

**Response**:

```json theme={null}
{
  "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

| Field                            | Type    | Description                          |
| -------------------------------- | ------- | ------------------------------------ |
| `remaining_trading_days_month`   | integer | Trading days left in current month   |
| `remaining_trading_days_year`    | integer | Trading days left in current year    |
| `next_market_holiday`            | object  | Next market closure info             |
| `days_until_next_market_holiday` | integer | Days until next closure              |
| `upcoming_holidays`              | array   | List of upcoming holidays (up to 10) |
| `is_market_open_today`           | boolean | Market open today?                   |
| `is_market_open_tomorrow`        | boolean | Market open tomorrow?                |

## Data Source

Uses `pandas_market_calendars` library for accurate NYSE calendar data.

## Next Steps

<CardGroup cols={2}>
  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    View full API documentation
  </Card>

  <Card title="Trading Analysis" icon="chart-line" href="/features/trading-analysis">
    Analyze trading performance
  </Card>
</CardGroup>