> ## Documentation Index > Fetch the complete documentation index at: https://docs.arrays.org/llms.txt > Use this file to discover all available pages before exploring further. # Get US Market Calendar > [OpenAPI JSON Spec](/docs/output/v1_stocks_market-calendar_get.json) Retrieve the upcoming US equity market holidays and early closes. **Feature Overview** Lists every announced upcoming date on which a US venue is closed all day or closes early. Dates not listed follow the normal schedule (pre-market 04:00, regular 09:30-16:00, after-hours until 20:00 America/New_York, Monday to Friday). **Main Use Cases** - **Market Status**: Tell whether the market is open now and when it opens next - **Scheduling**: Skip holidays when computing trading-day deadlines **Response Data Structure** Each event includes: - **date**: Exchange-local trade date (YYYY-MM-DD) - **exchange**: NYSE, NASDAQ or OTC; the same date is listed once per venue - **name**: Holiday name - **status**: `closed` or `early_close` - **open_time** / **close_time**: Bounds of that day's shortened session in Unix seconds, only for `early_close` Events are ordered by date, then exchange. Past dates are not included. The list only covers the provider's forward horizon (a few months to about a year) and lists exceptions only: weekends and normal days never appear, and a date that is absent, or beyond the last listed date, is not guaranteed to be a normal trading day. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/stocks/market-calendar openapi: 3.0.0 info: contact: {} description: >- Welcome to Arrays! Arrays is a unified financial data layer for both financial institutions and retail users, delivering comprehensive market data across crypto and equity markets. Our datasets cover fundamentals, ETFs, options, crypto, and more. Visit [arrays.org](https://arrays.org) to request an API key and start your free trial. You can explore our full API offerings in the documentation below. For any questions regarding APIs or pricing, please contact support@arrays.org. title: Arrays API version: '1.0' servers: - url: https://data-tools.prd.arrays.org/api security: [] paths: /v1/stocks/market-calendar: get: tags: - Stock summary: Get US Market Calendar description: >- [OpenAPI JSON Spec](/docs/output/v1_stocks_market-calendar_get.json) Retrieve the upcoming US equity market holidays and early closes. **Feature Overview** Lists every announced upcoming date on which a US venue is closed all day or closes early. Dates not listed follow the normal schedule (pre-market 04:00, regular 09:30-16:00, after-hours until 20:00 America/New_York, Monday to Friday). **Main Use Cases** - **Market Status**: Tell whether the market is open now and when it opens next - **Scheduling**: Skip holidays when computing trading-day deadlines **Response Data Structure** Each event includes: - **date**: Exchange-local trade date (YYYY-MM-DD) - **exchange**: NYSE, NASDAQ or OTC; the same date is listed once per venue - **name**: Holiday name - **status**: `closed` or `early_close` - **open_time** / **close_time**: Bounds of that day's shortened session in Unix seconds, only for `early_close` Events are ordered by date, then exchange. Past dates are not included. The list only covers the provider's forward horizon (a few months to about a year) and lists exceptions only: weekends and normal days never appear, and a date that is absent, or beyond the last listed date, is not guaranteed to be a normal trading day. responses: '200': description: Successfully retrieved the market calendar content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: data: items: $ref: '#/components/schemas/model.MarketHolidayEvent' type: array type: object '500': description: Internal server error content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: error: $ref: '#/components/schemas/model.APIError' type: object '503': description: Upstream unavailable content: application/json: schema: allOf: - $ref: '#/components/schemas/model.APIResponse' - properties: error: $ref: '#/components/schemas/model.APIError' type: object security: - ApiKeyAuth: [] components: schemas: model.APIResponse: properties: data: {} error: $ref: '#/components/schemas/model.APIError' metadata: {} pagination: {} request_id: type: string success: type: boolean type: object model.MarketHolidayEvent: properties: close_time: description: >- Close of the day's shortened session (Unix seconds); only for early_close example: 1795802400 type: integer date: description: Exchange-local (America/New_York) trade date (YYYY-MM-DD) example: '2026-11-27' type: string exchange: description: 'Venue: NYSE, NASDAQ or OTC; the same date is listed once per venue' example: NYSE type: string name: description: Holiday name example: Thanksgiving type: string open_time: description: >- Open of the day's shortened session (Unix seconds); only for early_close example: 1795789800 type: integer status: description: closed or early_close example: early_close type: string type: object model.APIError: properties: code: example: RESOURCE_NOT_FOUND type: string details: items: $ref: '#/components/schemas/model.APIErrorDetail' type: array docs_url: type: string examples: items: type: string type: array hint: type: string message: example: The requested resource was not found. type: string suggestions: items: type: string type: array type: object model.APIErrorDetail: properties: field: type: string got: type: string reason: type: string type: object securitySchemes: ApiKeyAuth: description: 'API Key authentication. Example: "your-api-key-here"' in: header name: X-API-Key type: apiKey ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.