{"uid":"cap_YGaTeBsC8kfNZOQV1fvPH","slug":"sunrise-sunset-times-82345791","name":"Sunrise & Sunset Times","description":"Use when an agent needs sunrise and sunset times for coordinates and a date: solar noon, civil dawn/dusk, morning and evening golden hour and day length in local time; polar day/night flagged. Offline astronomy. $0.01 USDC on Base; charged only on 2xx, never for invalid input.","url":"https://api.facts402.com/sun?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"lat":{"type":"number","title":"Lat","maximum":90,"minimum":-90,"description":"Latitude in decimal degrees (WGS84)"},"lon":{"type":"number","title":"Lon","maximum":180,"minimum":-180,"description":"Longitude in decimal degrees (WGS84)"},"date":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"title":"Date","default":null,"description":"YYYY-MM-DD; default: today locally"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oy5Q79-SQL-XYQlKzknVe","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","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, golden hour windows, civil dawn/dusk, and day length for any latitude/longitude and date in the location's local time zone, with polar day/night detection.","exampleAgentPrompt":"What time is sunrise, sunset, and golden hour this Saturday at coordinates 45.4654° N, 9.1859° E (Milan), including how long the day will be and whether civil twilight applies?","exampleUseCases":[{"title":"Photography golden hour planning","prompt":"I'm doing a landscape shoot at 36.1069° N, 112.1129° W (Grand Canyon South Rim) on October 14th — what are the morning and evening golden hour windows, and when exactly does the sun rise and set that day?"},{"title":"Outdoor event scheduling at venue","prompt":"We're hosting an outdoor wedding ceremony at 51.5014° N, 0.1419° W in London on July 5th — can you tell me what time sunset and civil dusk are so we know when to move indoors?"},{"title":"Polar night travel check","prompt":"I'm traveling to Tromsø, Norway (69.6496° N, 18.9560° E) on January 15th — will there be any daylight at all, or is it polar night? And if there is sunlight, when exactly does it rise and set?"}],"resultDescription":"Returns local-time timestamps for sunrise, sunset, solar noon, civil dawn and dusk, morning and evening golden hour start/end, total day length, and a polar day/night flag — all expressed in the location's local time zone.","failureModes":["Invalid latitude (outside -90 to 90) or longitude (outside -180 to 180) returns a validation error","Malformed date string (not YYYY-MM-DD) returns a parsing error","Extreme polar coordinates near 90°/-90° may produce edge-case outputs around solstices","Missing required lat/lon fields returns a 422 or equivalent bad-request error","Network timeout or service unavailability returns a 5xx error"],"whenToPreferThis":"Choose this endpoint when you need precise, offline-computed solar event times (sunrise, sunset, golden hour, civil twilight) for any coordinate and date without relying on a weather or mapping API. It is ideal for photography planning, event scheduling, travel itineraries, and outdoor activity agents. Prefer it over general weather APIs when solar timing is the primary need rather than atmospheric conditions.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:39:52.807Z","isFirstParty":false,"canonicalSlug":"sunrise-sunset-times-82345791"}