{
  "x402Version": 2,
  "id": 33284,
  "slug": "33284",
  "resource": "https://handelskalender-api.pages.dev/v1/trading-calendar",
  "description": "Use when an agent plans ahead and needs every closure of a stock exchange for a whole year: holiday names, half days, late openings, regular hours, count of trading days. 28 exchanges incl. NYSE, Nasdaq, LSE, Xetra, Euronext, SIX, Tokyo, HKEX, Shanghai, ASX. Official exchange calendars only; bad input or uncovered year: HTTP 400, no charge.",
  "type": "http",
  "serviceName": "Exchange Trading Calendar",
  "accepts": [
    {
      "scheme": "exact",
      "network": "eip155:8453",
      "payTo": "0x896baBcda513322AF2218fe7346353846835f978",
      "asset": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
      "amount": "2000",
      "amountUsd": 0.002,
      "maxTimeoutSeconds": 60
    }
  ],
  "outputSchema": {
    "properties": {
      "example": {
        "type": "object"
      },
      "type": {
        "type": "string"
      }
    },
    "required": [
      "type"
    ],
    "type": "object"
  },
  "extensions": {
    "bazaar": {
      "info": {
        "input": {
          "method": "GET",
          "queryParams": {
            "exchange": "XNYS",
            "year": "2026"
          },
          "type": "http"
        },
        "output": {
          "example": {
            "closed": [
              {
                "date": "2026-01-01",
                "name": "New Year's Day",
                "weekday": "Thursday"
              }
            ],
            "coverage": {
              "from": "2026-01-01",
              "to": "2028-12-31"
            },
            "exchange": {
              "country": "US",
              "mic": "XNYS",
              "name": "New York Stock Exchange",
              "timezone": "America/New_York"
            },
            "hoursNote": null,
            "regularHours": {
              "close": "16:00",
              "open": "09:30"
            },
            "sources": [
              "https://www.nyse.com/markets/hours-calendars"
            ],
            "specialSessions": [
              {
                "close": "13:00",
                "date": "2026-11-27",
                "name": "Day after Thanksgiving",
                "open": "09:30",
                "weekday": "Friday"
              }
            ],
            "tradingDays": 250,
            "year": 2026
          },
          "type": "json"
        }
      },
      "schema": {
        "$schema": "https://json-schema.org/draft/2020-12/schema",
        "properties": {
          "input": {
            "additionalProperties": false,
            "properties": {
              "method": {
                "enum": [
                  "GET"
                ],
                "type": "string"
              },
              "queryParams": {
                "additionalProperties": false,
                "properties": {
                  "exchange": {
                    "description": "Exchange MIC code, e.g. XNYS (NYSE), XNAS (Nasdaq), XLON (London), XETR (Xetra), XPAR (Paris), XTKS (Tokyo), XHKG (Hong Kong). Common names also work (NYSE, Xetra, LSE). Free list: GET /v1/exchanges.",
                    "type": "string"
                  },
                  "year": {
                    "description": "Year, e.g. 2026. Optional, default: current year.",
                    "type": "string"
                  }
                },
                "required": [
                  "exchange"
                ],
                "type": "object"
              },
              "type": {
                "const": "http",
                "type": "string"
              }
            },
            "required": [
              "type",
              "method"
            ],
            "type": "object"
          },
          "output": {
            "properties": {
              "example": {
                "type": "object"
              },
              "type": {
                "type": "string"
              }
            },
            "required": [
              "type"
            ],
            "type": "object"
          }
        },
        "required": [
          "input"
        ],
        "type": "object"
      }
    }
  },
  "tags": [
    "stock-exchange",
    "trading-calendar",
    "market-hours",
    "holidays",
    "nyse",
    "bazaar"
  ],
  "sourceHost": "handelskalender-api.pages.dev",
  "lastUpdated": "2026-10-13T11:46:29.485Z",
  "quality": {
    "calls30d": 3,
    "uniquePayers30d": 1,
    "lastCalledAt": "2026-10-13T11:46:29.293Z"
  },
  "metadata": {
    "serviceName": "Exchange Trading Calendar",
    "extensions": {
      "bazaar": {
        "info": {
          "input": {
            "method": "GET",
            "queryParams": {
              "exchange": "XNYS",
              "year": "2026"
            },
            "type": "http"
          },
          "output": {
            "example": {
              "closed": [
                {
                  "date": "2026-01-01",
                  "name": "New Year's Day",
                  "weekday": "Thursday"
                }
              ],
              "coverage": {
                "from": "2026-01-01",
                "to": "2028-12-31"
              },
              "exchange": {
                "country": "US",
                "mic": "XNYS",
                "name": "New York Stock Exchange",
                "timezone": "America/New_York"
              },
              "hoursNote": null,
              "regularHours": {
                "close": "16:00",
                "open": "09:30"
              },
              "sources": [
                "https://www.nyse.com/markets/hours-calendars"
              ],
              "specialSessions": [
                {
                  "close": "13:00",
                  "date": "2026-11-27",
                  "name": "Day after Thanksgiving",
                  "open": "09:30",
                  "weekday": "Friday"
                }
              ],
              "tradingDays": 250,
              "year": 2026
            },
            "type": "json"
          }
        },
        "schema": {
          "$schema": "https://json-schema.org/draft/2020-12/schema",
          "properties": {
            "input": {
              "additionalProperties": false,
              "properties": {
                "method": {
                  "enum": [
                    "GET"
                  ],
                  "type": "string"
                },
                "queryParams": {
                  "additionalProperties": false,
                  "properties": {
                    "exchange": {
                      "description": "Exchange MIC code, e.g. XNYS (NYSE), XNAS (Nasdaq), XLON (London), XETR (Xetra), XPAR (Paris), XTKS (Tokyo), XHKG (Hong Kong). Common names also work (NYSE, Xetra, LSE). Free list: GET /v1/exchanges.",
                      "type": "string"
                    },
                    "year": {
                      "description": "Year, e.g. 2026. Optional, default: current year.",
                      "type": "string"
                    }
                  },
                  "required": [
                    "exchange"
                  ],
                  "type": "object"
                },
                "type": {
                  "const": "http",
                  "type": "string"
                }
              },
              "required": [
                "type",
                "method"
              ],
              "type": "object"
            },
            "output": {
              "properties": {
                "example": {
                  "type": "object"
                },
                "type": {
                  "type": "string"
                }
              },
              "required": [
                "type"
              ],
              "type": "object"
            }
          },
          "required": [
            "input"
          ],
          "type": "object"
        }
      }
    }
  },
  "liveness": {
    "reliability": null
  },
  "verified": false,
  "featured": false,
  "provider": {
    "host": "handelskalender-api.pages.dev",
    "manifest_name": "handelskalender-api.pages.dev",
    "source": "cdp-mirror",
    "source_manifest_url": "https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources",
    "submitted_at": "2026-10-13T15:56:53.641Z"
  },
  "exampleResponse": {
    "example": {},
    "type": "string"
  }
}