{"uid":"cap_ZI02YCC7swscgqpNWG8k_","slug":"2s-io-stock-exchange-holiday-calendar-0beed9cb","name":"2s.io Stock Exchange Holiday Calendar","description":"Stock-exchange holiday calendar. Pass exchange (default US); returns the list of upcoming market holidays with the date, holiday name, whether the session is a full close or an early close, and the trading hours when partial. Use it to plan around non-trading days. Data by Finnhub.","url":"https://2s.io/api/markets/holiday","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"required":[],"properties":{"exchange":{"type":"string","description":"Exchange code, e.g. US."}}}}}}},"responseSchema":{"type":"json","schema":{"type":"object","properties":{"ok":{"type":"boolean"},"meta":{"type":"object","properties":{"exchange":{"type":"string"},"timezone":{"type":"string"}}},"items":{"type":"array","items":{"type":"object","properties":{"atDate":{"type":"string"},"eventName":{"type":"string"},"tradingHour":{"type":"string"}}}},"total":{"type":"integer"},"source":{"type":"object","properties":{"url":{"type":"string"},"license":{"type":"string"},"provider":{"type":"string"}}}}},"example":{"ok":true,"meta":{"exchange":"US","timezone":"America/New_York"},"items":[{"atDate":"2026-07-03","eventName":"Independence Day","tradingHour":""}],"total":1,"source":{"url":"https://finnhub.io","license":"Finnhub API terms (commercial market, fundamental & alternative data; attribution required)","provider":"Finnhub"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.0025","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.0025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oUxFt-EkK8iaOmMizWxvT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns upcoming market holidays for a given stock exchange, including date, holiday name, full/early close status, and partial trading hours.","exampleAgentPrompt":"What are the upcoming market holidays for the US stock exchange — include whether each day is a full close or just an early close, and what the trading hours are on partial days?","exampleUseCases":null,"resultDescription":"A list of upcoming market holidays for the specified exchange, each entry containing the holiday date, holiday name, whether the market session is a full close or early close, and the trading hours when the session is only partially closed.","failureModes":["Invalid or unsupported exchange code returns an error or empty list","Network or upstream Finnhub data unavailability returns a 5xx error","Malformed query parameter may return a 400 bad request","Data may lag if Finnhub has not yet published holidays for the next calendar year"],"whenToPreferThis":"Use this endpoint when you need to know which days a stock exchange is closed or has shortened hours, especially for scheduling trades, automating workflows around trading days, or building financial planning tools. Prefer this over a generic calendar API because it returns structured, exchange-specific market holiday data with partial session details powered by Finnhub.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T07:15:24.000Z","isFirstParty":false}