{"uid":"cap_D-FBYTJJtP1LFMmtRmOg1","slug":"date-math-stock-exchange-market-calendar-4625d16a","name":"Date Math – Stock Exchange Market Calendar","description":"Date Math: Stock exchange calendar for NYSE/Nasdaq, London (LSE) and Tokyo (JPX): is the market open now, today's session (early closes, lunch break), next open and close, holidays, previous/next trading day, and the trade settlement date (T+1/T+2). Use for trading agents, order timing and settlement.","url":"https://date-math.datemath.workers.dev/v1/market?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"at":{"type":"string","description":"Instant for the open/closed status: ISO 8601 with offset (default: now)"},"date":{"type":"string","example":"2026-11-07","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"exchange":{"type":"string","example":"NYSE","description":"XNYS or NYSE, XNAS or NASDAQ, XLON or LSE, XTKS or TSE/JPX"},"list_year":{"type":"integer","maximum":2050,"minimum":2000,"description":"Also list that year's holidays and early closes"}}},"responseSchema":{"type":"json","example":{"date":"2026-11-27","name":"New York Stock Exchange (same holidays as Nasdaq)","note":"Regular sessions only (no pre/after-hours). Unscheduled closures (e.g. national mourning days) are added when announced.","reason":null,"status":{"at":"2026-11-27T17:00:00Z","local":"2026-11-27T12:00:00-05:00","phase":"open","is_open":true,"next_open":"2026-11-30T14:30:00Z","next_close":"2026-11-27T18:00:00Z"},"holiday":null,"session":{"open":"2026-11-27T09:30:00-05:00","break":null,"close":"2026-11-27T13:00:00-05:00","open_utc":"2026-11-27T14:30:00Z","close_utc":"2026-11-27T18:00:00Z"},"weekday":"Friday","calendar":null,"exchange":"XNYS","timezone":"America/New_York","settlement":{"note":"US equities settle T+1 (since 2024-05-28); settlement also skips Columbus Day and Veterans Day, when markets are open but banks are closed.","cycle":"T+1","settlement_date":"2026-11-30"},"early_close":"Day after Thanksgiving","is_trading_day":true,"next_trading_day":"2026-11-30","previous_trading_day":"2026-11-25"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_HG3Yy3edOLwfPEBuBjyth","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time and scheduled market status (open/closed, session times, holidays, early closes, next/previous trading day, settlement date) for NYSE, Nasdaq, LSE, and JPX exchanges.","exampleAgentPrompt":"Is the NYSE open right now, and if not, when does it next open? Also tell me the settlement date if I place a trade today.","exampleUseCases":[{"title":"Order timing before market close","prompt":"It's 3:45pm ET on Friday November 27 — is the NYSE still open, or has it already closed early for the day after Thanksgiving? And what's the next trading session?"},{"title":"Trade settlement date calculation","prompt":"I'm placing an equity trade on the Nasdaq today, November 27, 2026. What will the T+1 settlement date be, accounting for any bank holidays?"},{"title":"Holiday calendar for trading bot","prompt":"Pull the full list of NYSE holidays and early-close days for 2026 so my trading bot knows when to skip order submissions."}],"resultDescription":"A JSON object with the exchange name, current market phase (open/pre/post/closed), session open and close times in both local and UTC, whether today is a trading day, any holiday or early-close reason, next and previous trading days, and the settlement date (T+1 for US, T+2 for others). Optionally includes the full holiday/early-close calendar for a requested year.","failureModes":["Unsupported exchange code returns an error or empty response","Invalid date format (not YYYY-MM-DD) causes a validation error","Unscheduled closures (e.g. national mourning days) may not be reflected until officially announced","list_year outside 2000-2050 range is rejected","Missing or malformed ISO 8601 'at' field falls back to server current time, which may differ from user's intent"],"whenToPreferThis":"Use this endpoint when you need authoritative, exchange-specific market hours data including holiday schedules, early closes, session phases, and settlement dates for NYSE, Nasdaq, LSE, or JPX. It is purpose-built for trading agents, order timing logic, and settlement calculations — prefer it over generic business-day APIs that do not understand exchange-specific rules like Columbus Day bank holidays or the JPX lunch break.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-21T12:36:39.026Z","isFirstParty":false,"canonicalSlug":"date-math-stock-exchange-market-calendar-4625d16a"}