{"uid":"cap_aP80hxcFPrTRZkDYHdDpd","slug":"trading-time-api-dst-gap-weeks-d26cdd57","name":"Trading Time API – DST Gap Weeks","description":"Returns the weeks of a year in which the clock difference between the US and Europe (or other pairs) is shifted by daylight-saving changes, so foreign market opens move by one hour.","url":"https://trading-time-api.onrender.com/v1/dst-gap?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":["year"],"properties":{"pair":{"type":"string","description":"Zone pair: US-EU, US-UK, US-CH or EU-AU. Default US-EU."},"year":{"type":"string","description":"Calendar year, e.g. 2027"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.012","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.012/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.012","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7wx9ncAcx6VMScPEGNIMg","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.012","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the calendar weeks in a given year when daylight-saving time shifts cause a one-hour difference in foreign market open times between a specified timezone pair (e.g. US-EU).","exampleAgentPrompt":"Which weeks in 2025 will the European market open an hour earlier than usual for US traders, due to the US-EU daylight saving gap?","exampleUseCases":[{"title":"Automated trading schedule adjustment","prompt":"Can you tell me which weeks in 2026 the US-EU daylight saving gap kicks in, so I know when the Frankfurt open shifts by an hour relative to New York?"},{"title":"Algorithmic trading calendar planning","prompt":"I'm setting up my trading bot for 2027 — which weeks will the London market open at a different US time than normal because of DST mismatches between the US and UK?"},{"title":"Annual DST impact report for investors","prompt":"Give me all the weeks in 2025 where the clock difference between the US and Europe shifts due to daylight saving, using the US-EU pair."}],"resultDescription":"A list of calendar weeks in the specified year during which the daylight-saving time rules for the selected timezone pair (e.g. US-EU) diverge, causing foreign market open times to shift by one hour. Includes week identifiers and the nature of the shift.","failureModes":["Missing required 'year' query parameter returns a validation error","Invalid or unsupported 'pair' value returns an error (only US-EU, US-UK, US-CH, EU-AU accepted)","Non-numeric or out-of-range year value may return a 400 error","Payment not provided or insufficient USDC balance triggers a 402 Payment Required response","Service may be temporarily unavailable on Render's free tier (cold start latency or downtime)"],"whenToPreferThis":"Use this endpoint when you need to proactively identify in advance which weeks of a year will have a DST-induced one-hour shift between a US and European (or Australian) timezone pair, rather than checking a single specific timestamp. Prefer this over the point-in-time DST gap check when building annual trading calendars, scheduling algorithms, or batch planning tools that need the full list of affected weeks upfront.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-19T12:30:04.265Z","isFirstParty":false,"canonicalSlug":"trading-time-api-dst-gap-weeks-d26cdd57"}