{"uid":"cap_lvJ87kow7vKiYBkn_v2wI","slug":"tickerlayer-market-sessions-8b1ceef1","name":"TickerLayer Market Sessions","description":"Get timezone-aware trading sessions for a market or symbol on a requested calendar date.","url":"https://x402.tickerlayer.com/v1/markets/sessions","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":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"asset":{"enum":["stocks","forex","crypto","commodities","indices","etfs","bonds"],"type":"string"},"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","date","timezone","is_open","holiday","sessions","meta"],"properties":{"date":{"type":"string","pattern":"^\\d{4}-\\d{2}-\\d{2}$"},"meta":{"type":"object","required":["calendar_version"],"properties":{"data_notice":{"type":"string"},"calendar_version":{"type":"string"}},"additionalProperties":true},"market":{"type":"string"},"holiday":{"type":["object","null"]},"is_open":{"type":"boolean"},"sessions":{"type":"array","items":{"type":"object"}},"timezone":{"type":"string"}},"additionalProperties":true}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0KycZcAn-H_LFkq7mXXpA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns timezone-aware trading session windows (pre-market, regular, post-market, etc.) for a given market or symbol on a specific calendar date.","exampleAgentPrompt":"What are the trading sessions for US:AAPL on 2025-06-10 — I need to know the exact pre-market, regular, and after-hours windows in the correct timezone.","exampleUseCases":[{"title":"Algorithm trade timing for stocks","prompt":"I'm building a trading bot — can you get me the full session schedule for US:TSLA on 2025-07-14 so I know exactly when pre-market, regular, and after-hours trading windows open and close?"},{"title":"Forex session planning by date","prompt":"What are the trading sessions for the forex market on 2025-12-26? I want to know if it's open and when the main sessions run, with the correct timezone."},{"title":"Commodities holiday session check","prompt":"Can you check whether the commodities market has a full session schedule or early close on 2025-11-27, and show me whatever session windows are available?"}],"resultDescription":"Returns a JSON object containing the market identifier, the requested date, the market's timezone (IANA format), a boolean indicating whether the market is open, holiday details (if any), an array of session objects with session names and time windows, and metadata including the calendar version.","failureModes":["Invalid date format (must be YYYY-MM-DD) returns a validation error","Unknown or unsupported market/symbol returns an error or empty result","Requesting a date far in the future may return incomplete or missing holiday data","Network or payment authorization failure returns a 402 or 5xx error","Combining an asset enum with an incompatible symbol format may return no results"],"whenToPreferThis":"Use this endpoint when you need the precise timezone-aware session breakdown (pre-market, regular, post-market, etc.) for a specific date — not just whether a market is currently open. Prefer this over the open/closed status endpoint when you need the full day's session schedule for scheduling algorithms, trade timing, or calendar integrations. This endpoint is best when the date is known in advance and session window details matter.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:38:25.567Z","isFirstParty":false}