{"uid":"cap_W2gbTBNxIl6fyfIRA3ZKi","slug":"market-hours-api-holidays-early-close-days-41f374d4","name":"Market Hours API – Holidays & Early-Close Days","description":"Returns closed weekdays (holidays) and early-close days of a stock exchange or futures market within a date range of up to two years.","url":"https://market-hours-api.onrender.com/v1/holidays?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":["market","start","end"],"properties":{"end":{"type":"string","description":"End date YYYY-MM-DD"},"start":{"type":"string","description":"Start date YYYY-MM-DD"},"market":{"type":"string","description":"Market code: XNYS, XNAS, XLON, XETR, XSWX, XTKS, XHKG, XSHG, XASX, CME_EQUITY, EUREX_INDEX"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_GNpxQYy3k-bYMj-AfPVkb","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the list of closed weekdays (public holidays) and early-close days for a specified stock exchange or futures market within a given date range.","exampleAgentPrompt":"Can you pull all the trading holidays and early-close days for NYSE (XNYS) from January 1, 2025 to December 31, 2025 so I know which weekdays the market will be closed or closing early?","exampleUseCases":[{"title":"Trading bot holiday schedule","prompt":"I'm building an automated trading bot and need to know every day the NASDAQ (XNAS) will be closed or have an early close between July 1, 2025 and June 30, 2026 — can you get that list for me?"},{"title":"Cross-market settlement calendar","prompt":"I need to reconcile settlement dates across both the London Stock Exchange (XLON) and the Frankfurt exchange (XETR) — can you fetch all their holidays and early-close days from January 1, 2025 through December 31, 2025?"},{"title":"Earnings calendar blackout dates","prompt":"Before I schedule my earnings alert automations, can you look up all the CME Equity futures holidays and early closes between now and the end of the year — specifically from September 1, 2025 to December 31, 2025?"}],"resultDescription":"A structured list of dates within the requested range on which the specified market is either fully closed (holidays falling on weekdays) or closes early, along with relevant metadata such as the market code and date details for each affected day.","failureModes":["Invalid market code returns an error or empty result — only supported codes (XNYS, XNAS, XLON, XETR, XSWX, XTKS, XHKG, XSHG, XASX, CME_EQUITY, EUREX_INDEX) are accepted","Date range exceeding two years may be rejected or return partial results","Malformed date format (not YYYY-MM-DD) causes a validation error","Start date after end date returns an error","Payment failure (x402) prevents the response from being returned","Network timeout from the Render-hosted service during high load"],"whenToPreferThis":"Use this endpoint when you need a definitive, machine-readable list of non-trading weekdays (holidays) and early-close days for a specific supported exchange or futures market, particularly for automating trading logic, scheduling jobs around market closures, or building financial calendars. It covers a curated set of major global markets (US, UK, German, Swiss, Japanese, Hong Kong, Chinese, Australian, and key futures venues) and is ideal when you need forward-looking or historical holiday data across up to two years.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T12:35:12.755Z","isFirstParty":false,"canonicalSlug":"market-hours-api-holidays-early-close-days-41f374d4"}