{"uid":"cap_Xt3FIsLje9IZRIyLuBsZQ","slug":"sun-position-solar-event-calculator-c9f12628","name":"Sun Position & Solar Event Calculator","description":"Compute sunrise, sunset, solar noon and day length for a latitude/longitude (east-positive) and date, using the NOAA sunrise equation. All times are UTC ISO-8601. Locations in polar day or night return null rise/set with a `polar` flag — a successful result, not an error.","url":"https://astro.openverbs.com/v1/sun","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["lat","lon","year","month","day"],"properties":{"day":{"type":"integer","maximum":31,"minimum":1},"lat":{"type":"number","maximum":90,"minimum":-90,"description":"Latitude (north-positive)."},"lon":{"type":"number","maximum":180,"minimum":-180,"description":"Longitude (east-positive)."},"year":{"type":"integer","maximum":9999,"minimum":1},"month":{"type":"integer","maximum":12,"minimum":1}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Cn-5Rrk9bOnR7O_8-Pamr","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculates sun position, sunrise, sunset, and other solar events for a given geographic location and date","exampleAgentPrompt":"What time does the sun rise and set at latitude 40.7128, longitude -74.0060 on June 21, 2025?","exampleUseCases":[{"title":"Sunset planning for outdoor event","prompt":"When exactly does the sun set at latitude 34.0522, longitude -118.2437 on July 4th, 2025? I need to plan lighting for an outdoor event."},{"title":"Winter solstice daylight hours","prompt":"How many hours of daylight will there be at latitude 51.5074, longitude -0.1278 on December 21, 2025? I want to know how short the day is in London on the winter solstice."},{"title":"Sunrise alert for agriculture","prompt":"What time does the sun rise at latitude 36.7783, longitude -119.4179 on March 15, 2025? I need to schedule irrigation to start right at sunrise for my farm in California's Central Valley."}],"resultDescription":"Returns solar event data for the specified location and date, including sunrise time, sunset time, solar noon, day length, and potentially sun azimuth/altitude data, all computed for the exact latitude/longitude coordinates provided.","failureModes":["Invalid latitude (outside -90 to 90) or longitude (outside -180 to 180) returns validation error","Invalid date components (e.g. month 13, day 32) return validation error","Payment failure or insufficient funds returns 402 error","Missing required fields (lat, lon, year, month, day) returns 400 error","Extreme edge cases like polar regions during midnight sun or polar night may return unusual values"],"whenToPreferThis":"Use this endpoint when you need precise solar event calculations (sunrise, sunset, solar noon) for a specific geographic coordinate and date. Ideal for applications in agriculture, photography planning, event scheduling, navigation, or any use case requiring accurate daylight information. Prefer this over general weather APIs that only approximate sunrise/sunset times, especially when exact timing and full solar position data are needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:30:28.053Z","isFirstParty":false}