{"uid":"cap_MFXOVZfivouAMYxyMNnN6","slug":"syntexa-agentshelf-timezone-lookup-c17089df","name":"Syntexa AgentShelf Timezone Lookup","description":"Call when an agent needs an IANA timezone, local_time ISO, utc_offset, and dst for coordinates or a city. Send lat and lon together (example 40.7128 and -74.006) or city (example New York). A city is geocoded first. Timezone data is offline. No arbitrary URL. Send JSON {\"lat\":40.7128,\"lon\":-74.006}. Exact $0.002 USDC on Base. Try unpaid POST /v1/sandbox/timezone first.","url":"https://agentshelf.syntexa.ch/v1/timezone?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"lat":{"type":"number","maximum":90,"minimum":-90,"examples":[40.7128],"description":"Latitude in decimal degrees, sent with lon. Example: 40.7128. Returns timezone, local_time, utc_offset, and dst. Omit lat and lon when sending city."},"lon":{"type":"number","maximum":180,"minimum":-180,"examples":[-74.006],"description":"Longitude in decimal degrees, sent with lat. Example: -74.006. Omit lon and lat when sending city."},"city":{"type":"string","maxLength":120,"minLength":1,"description":"City name to geocode, then resolve offline. Example: New York. Do not send city together with lat and lon. Returns timezone, local_time, utc_offset, and dst."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_t_hxCtIKAsJD_XeHZ5ilT","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns IANA timezone identifier, local ISO time, UTC offset, and DST flag for a given latitude/longitude pair or city name using offline timezone data.","exampleAgentPrompt":"What's the IANA timezone, current local time, UTC offset, and whether DST is active right now for coordinates 40.7128, -74.006?","exampleUseCases":[{"title":"Schedule meeting across time zones","prompt":"I need to know the IANA timezone and current UTC offset for London so I can schedule a meeting that works for our team there — can you look that up?"},{"title":"Log GPS coordinates with local time","prompt":"I have a GPS fix at latitude 35.6762 and longitude 139.6503 — what's the IANA timezone, local ISO time, and UTC offset there right now?"},{"title":"Check DST status for app localization","prompt":"Is daylight saving time currently active in Sydney? I need the IANA timezone name and UTC offset for my app's time display logic."}],"resultDescription":"Returns a JSON object containing the IANA timezone string (e.g. 'America/New_York'), the current local time in ISO 8601 format, the UTC offset as a signed string (e.g. '-05:00'), and a boolean DST flag indicating whether daylight saving time is currently in effect at the queried location.","failureModes":["Invalid or out-of-range latitude/longitude values return a validation error","Unrecognized or misspelled city names fail geocoding and return an error","Sending both city and lat/lon together is rejected as an invalid request","Missing both city and lat/lon returns a bad request error","Payment not attached or insufficient USDC results in a 402 Payment Required response"],"whenToPreferThis":"Choose this endpoint when an agent needs structured timezone data — IANA identifier, local ISO time, UTC offset, and DST status — from coordinates or a city name without relying on a live external API call, since timezone resolution is fully offline and fast. It is ideal for scheduling, logging, localization, or any workflow that must map a geographic location to its current time context. Use the free sandbox endpoint (/v1/sandbox/timezone) for testing before committing the $0.002 USDC per-call fee.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T06:51:29.310Z","isFirstParty":false,"canonicalSlug":"syntexa-agentshelf-timezone-lookup-c17089df"}