{"uid":"cap_3S_kqaF8dPigQVGOQBd15","slug":"sun-times-by-coordinates-5b062bc8","name":"Sun Times by Coordinates","description":"Sunrise, sunset, civil twilight and day length for a latitude/longitude and date, in UTC and a chosen UTC offset.","url":"https://land-survey.x402tookit.com/sun-times?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"],"type":"string"},"queryParams":{"type":"object","required":["lat","lon"],"properties":{"lat":{"type":"number","description":"Latitude"},"lon":{"type":"number","description":"Longitude"},"date":{"type":"string","description":"YYYY-MM-DD, default today (UTC)"},"utc_offset_hours":{"type":"number","description":"Show local clock times at this offset, e.g. -6"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"lat":{"type":["null","number"]},"lon":{"type":["null","number"]},"asOf":{"type":["null","string"]},"date":{"type":["null","string"]},"source":{"type":["null","string"]},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"sunsetUtc":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"sunriseUtc":{"type":["null","string"]},"sunsetLocal":{"type":["null","string"]},"solarNoonUtc":{"type":["null","string"]},"sunriseLocal":{"type":["null","string"]},"utcOffsetHours":{"type":["null","number"]},"dayLengthMinutes":{"type":["null","number"]},"civilTwilightEndUtc":{"type":["null","string"]},"civilTwilightEndLocal":{"type":["null","string"]},"civilTwilightStartUtc":{"type":["null","string"]},"civilTwilightStartLocal":{"type":["null","string"]}}}}}}},"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_rnsunnBgLgG3e5C3DtZje","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 sunrise, sunset, civil twilight times, solar noon, and day length for a given latitude/longitude and date, in both UTC and a specified local UTC offset.","exampleAgentPrompt":"What time is sunrise and sunset at latitude 37.7749, longitude -122.4194 on June 21, 2025, and show me the local times at UTC-7?","exampleUseCases":[{"title":"Construction site daylight planning","prompt":"For our construction site at lat 40.6501, lon -73.9496, what are the sunrise and sunset times on March 15, 2025? Show me local times using UTC-5 so I know how long the crew can work."},{"title":"Outdoor photography golden hour scouting","prompt":"I'm shooting at a location at latitude 51.5074, longitude -0.1278 on August 10, 2025 — what are the civil twilight start and end times in local London time (UTC+1)?"},{"title":"Solar panel feasibility day-length check","prompt":"How many minutes of daylight will there be at latitude 64.1355, longitude -21.8954 on December 21, 2025? Give me the full breakdown including civil twilight times in UTC."}],"resultDescription":"A JSON object containing sunrise and sunset times in UTC and local clock time, civil twilight start and end in both UTC and local time, solar noon in UTC, total day length in minutes, the requested date, coordinates, and UTC offset used. May include degraded-data flags, reasons, and a summary verdict if data quality issues exist.","failureModes":["Missing required lat or lon parameters returns an error","Invalid date format (not YYYY-MM-DD) causes a parse error","Coordinates outside valid range (-90 to 90 lat, -180 to 180 lon) may return errors","Polar locations on dates with midnight sun or polar night may return edge-case or null sunrise/sunset values","Network or service downtime returns a non-200 response"],"whenToPreferThis":"Use this endpoint when you need precise astronomical sun-times (sunrise, sunset, civil twilight, solar noon, day length) for any geographic coordinate and date, especially when both UTC and local-clock-time representations are needed in the same response. It is ideal for land survey workflows, outdoor scheduling, solar energy assessments, and construction planning where the x402 micropayment model is already in use.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:15:01.326Z","isFirstParty":false,"canonicalSlug":"sun-times-by-coordinates-5b062bc8"}