{"uid":"cap_scDGFqNpyeSKPFi3n-wvt","slug":"site-climate-day-length-solar-times-7ebaa31f","name":"Site Climate Day Length & Solar Times","description":"Day length, sunrise, sunset (UTC) and solar noon for a latitude, longitude and date, including polar day and night.","url":"https://site-climate.x402tookit.com/daylength?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","date"],"properties":{"lat":{"type":"number","description":"Latitude, -90 to 90"},"lon":{"type":"number","description":"Longitude, -180 to 180"},"date":{"type":"string","description":"Date as YYYY-MM-DD"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"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"]},"latitude":{"type":["null","number"]},"dayOfYear":{"type":["null","number"]},"longitude":{"type":["null","number"]},"sunsetUtc":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"sunriseUtc":{"type":["null","string"]},"daylengthHm":{"type":["null","string"]},"solarNoonUtc":{"type":["null","string"]},"daylengthHours":{"type":["null","number"]},"solarDeclinationDeg":{"type":["null","number"]}}}}}}},"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_KwuETt--OQmz_tUPGJRVY","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 day length, sunrise, sunset, and solar noon times (UTC) for a given latitude, longitude, and date, including handling of polar day and polar night conditions.","exampleAgentPrompt":"How many hours of daylight will there be in Tromsø, Norway (latitude 69.65, longitude 18.96) on December 21, 2024, and what are the exact sunrise and sunset times in UTC?","exampleUseCases":[{"title":"Polar expedition daylight planning","prompt":"I'm heading to Svalbard (lat 78.22, lon 15.63) on June 15, 2025 — will it be polar day, and if not, what are the sunrise and sunset times in UTC?"},{"title":"Solar panel daily output estimate","prompt":"What's the day length and solar noon time at latitude 34.05, longitude -118.24 on March 20, 2025? I need it to estimate how many peak sun hours my panels will get."},{"title":"Outdoor photography golden hour lookup","prompt":"I'm shooting outdoors in Reykjavik (lat 64.13, lon -21.93) on August 10, 2025 — can you tell me the exact sunrise and sunset times in UTC and how long the day will be?"}],"resultDescription":"Returns a JSON object containing sunrise time in UTC, sunset time in UTC, solar noon in UTC, day length as a decimal hour value and as an HH:MM string, solar declination in degrees, day of year, the input latitude/longitude and date, and a summary noting any polar day or polar night condition. May include degraded status and disclaimer fields.","failureModes":["Missing required query parameters (lat, lon, date) returns an error","Latitude out of range (-90 to 90) or longitude out of range (-180 to 180) returns a validation error","Date not in YYYY-MM-DD format causes a parse error","Payment failure or insufficient USDC balance blocks the request","Polar locations near the boundary of polar day/night may return degraded or approximate results"],"whenToPreferThis":"Choose this endpoint when you need precise solar time data (sunrise, sunset, solar noon, day length) for any geographic coordinate and date, especially for locations that may experience polar day or polar night. It is ideal for planning outdoor activities, energy calculations, astronomical queries, or environmental analysis. Prefer it over general weather APIs when solar geometry is the primary concern rather than temperature or precipitation.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-21T07:20:02.459Z","isFirstParty":false,"canonicalSlug":"site-climate-day-length-solar-times-7ebaa31f"}