{"uid":"cap_-7CFL3Qj-Mfz309yWiY5Q","slug":"tickerlayer-market-holidays-calendar-1b9c0a61","name":"TickerLayer Market Holidays Calendar","description":"Get the market holiday and early-close calendar for a requested market and year or date range.","url":"https://x402.tickerlayer.com/v1/markets/holidays","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"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"end":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"year":{"type":"string","pattern":"^20\\d{2}$"},"asset":{"enum":["stocks","forex","crypto","commodities","indices","etfs","bonds"],"type":"string"},"start":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"market":{"type":"string","maxLength":20,"minLength":2},"symbol":{"type":"string","description":"Use COUNTRY_OR_MARKET:SYMBOL for stocks, for example US:AAPL."}},"additionalProperties":false}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["market","year","timezone","holidays","meta"],"properties":{"meta":{"type":"object","required":["calendar_version","start","end","data_notice","completeness"],"properties":{"end":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"start":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"data_notice":{"type":"string"},"completeness":{"enum":["full","partial"],"type":"string"},"calendar_version":{"type":"string"}},"additionalProperties":true},"year":{"type":"integer","maximum":2100,"minimum":2000},"market":{"type":"string"},"holidays":{"type":"array","items":{"type":"object"}},"timezone":{"type":"string"}},"additionalProperties":true}}}}},"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_busdPnMj40A4zPOWhkKaZ","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 market holiday and early-close calendar for a specified market and year or date range.","exampleAgentPrompt":"Can you pull the full holiday and early-close calendar for the US stocks market for 2025, so I know which days trading will be suspended or shortened?","exampleUseCases":[{"title":"Annual trading calendar for portfolio planning","prompt":"Give me the complete list of US stock market holidays and early-close days for 2025 — I want to plan my rebalancing schedule around them."},{"title":"Forex holiday check for automated trading bot","prompt":"What are all the forex market holidays between 2025-01-01 and 2025-06-30? I need to make sure my trading bot pauses on those days."},{"title":"Early-close detection for London equities","prompt":"Can you get me the holiday calendar for the London stock exchange for 2024, including any early-close days?"}],"resultDescription":"Returns a structured calendar object containing the market identifier, year, timezone, and an array of holiday entries (each with date, holiday name, and close type such as full close or early close), plus metadata including calendar version, date range covered, and completeness status (full or partial).","failureModes":["Invalid market identifier returns an error or empty result","Year outside supported range (before 2000 or after 2100) returns a validation error","Incompatible combination of year and start/end date parameters may cause a request error","Partial data availability for future years returns completeness='partial' flag","Unsupported asset class enum value returns a schema validation error","Missing required query parameters (market or year/date range) results in a 400-level error"],"whenToPreferThis":"Choose this endpoint when you need a complete, authoritative list of market holidays and early-close days for a specific exchange or asset class, particularly for scheduling automated trading, backtesting, or portfolio management workflows. It is preferable over generic financial data APIs when you need timezone-aware, market-specific calendar data with early-close granularity.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:31:55.213Z","isFirstParty":false}