{"uid":"cap_2WZcvoVmICOj0eEDaGcPK","slug":"orbit-geo-time-sunrise-sunset-9a9a55ec","name":"orbit Geo & Time: Sunrise & Sunset","description":"Location and time data for agents: weather now + 7-day forecast (MET Norway), geocoding and reverse geocoding (OpenStreetMap Nominatim), sunrise/sunset, world time-zone conversion and public holidays (Nager.Date). Real open data fetched at call time, attribution included. $0.001 per call. By orbit-builder.","url":"https://orbit-geo.orbit-builder.workers.dev/v1/sun?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":[],"properties":{"lat":{"type":"number","description":"latitude"},"lon":{"type":"number","description":"longitude"},"date":{"type":"string","description":"YYYY-MM-DD (default today UTC)"},"place":{"type":"string","description":"or a place name, e.g. Almaty or Paris, France"},"offset":{"type":"string","description":"UTC offset for output, e.g. +05:00 (default +00:00)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"date":"2026-10-23","sunset":"2026-10-23T17:18+00:00","sunrise":"2026-10-23T09:05+00:00","location":{"lat":64.146,"lon":-21.9422},"day_length":"8h13m","solar_noon":"2026-10-23T13:12+00:00","solar_noon_elevation_deg":14.6}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_FIK6LSseYn845iHHumCSP","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns sunrise, sunset, solar noon (with elevation), and day length for any location and date using MET Norway's Sunrise 3.0 API","exampleAgentPrompt":"What time does the sun rise and set in Almaty, Kazakhstan tomorrow, and how long will the day be? Show times in UTC+5:00.","exampleUseCases":[{"title":"Outdoor event sunrise planning","prompt":"I'm planning an outdoor photo shoot in Santorini on June 15th — what time is sunrise and sunset there, and how long will the day be? Show times in UTC+2:00."},{"title":"Polar daylight check for travel","prompt":"We're visiting Tromsø, Norway on January 10th — will there be any sunlight at all? What are the sunrise and sunset times, or is it polar night?"},{"title":"Solar noon for rooftop solar panel study","prompt":"What is the solar noon time and sun elevation angle for coordinates 34.05 latitude, -118.24 longitude on March 21st? Use UTC-8:00 as the timezone offset."}],"resultDescription":"A JSON object containing the date, sunrise time, sunset time, solar noon time, solar noon elevation in degrees, day length as a human-readable string (e.g. '8h13m'), and the resolved location coordinates. For polar day or polar night, times are returned as null with an explanatory note.","failureModes":["Invalid or unrecognizable place name returns an error or falls back to example input","Coordinates outside valid ranges (lat -90 to 90, lon -180 to 180) may cause errors","Malformed date string (not YYYY-MM-DD) may return an error or use today's date","Polar regions during midnight sun or polar night return null sunrise/sunset times with a note","Invalid UTC offset format may cause incorrect time conversion or error","No parameters provided runs example input rather than returning an error"],"whenToPreferThis":"Choose this endpoint when you need authoritative solar timing data (sunrise, sunset, solar noon, day length, sun elevation) for any geographic point or named place on a specific date, especially when you need output in a specific UTC offset. It is backed by MET Norway's Sunrise 3.0 API and handles edge cases like polar day/night gracefully. Prefer it over generic weather APIs when the primary need is solar event timing rather than meteorological data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-30T07:03:04.077Z","isFirstParty":false,"canonicalSlug":"orbit-geo-time-sunrise-sunset-9a9a55ec"}