{"uid":"cap_dNGZ4biEVobYgZY7mAsou","slug":"foundry-sunrise-sunset-times-72ec43e9","name":"Foundry Sunrise & Sunset Times","description":"Sunrise and sunset times in UTC for a location and date, with day length. Input: 'lat,lon' or 'lat,lon,YYYY-MM-DD'.","url":"https://minty-sprout.onrender.com/v1/sunrise-sunset?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"input":{"type":"string","maxLength":8000,"description":"'lat,lon' or 'lat,lon,YYYY-MM-DD'"}}},"responseSchema":{"type":"json","example":{"lat":51.5072,"lon":-0.1276,"date":"2026-10-31","note":"UTC times; polar day or night returns null.","sunset_utc":"2026-10-31T16:35+00:00","sunrise_utc":"2026-10-31T06:51+00:00","day_length_hours":9.74}},"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_TcC3XXX-pgs4aIuzDzuIR","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 UTC sunrise and sunset times plus day length for a given geographic coordinate and optional date.","exampleAgentPrompt":"What time does the sun rise and set in Rome (41.9028, 12.4964) on June 21st, 2025, and how many hours of daylight will there be?","exampleUseCases":[{"title":"Outdoor event daylight planning","prompt":"I'm organizing an outdoor wedding in Florence, Italy (43.7696, 11.2558) on September 13, 2025 — can you tell me exactly what time sunrise and sunset will be in UTC and how many hours of daylight we'll have?"},{"title":"Polar night research check","prompt":"I'm traveling to Tromsø, Norway (69.6489, 18.9551) on December 10, 2025 — will there be any daylight at all? What are the sunrise and sunset times in UTC?"},{"title":"Photography golden hour lookup","prompt":"I want to do a sunrise photo shoot in Cape Town (−33.9249, 18.4241) on March 1, 2025 — what time does the sun come up and go down in UTC, and how long is the day?"}],"resultDescription":"A JSON object with the latitude, longitude, and date queried, plus UTC ISO-8601 timestamps for sunrise and sunset, the total day length in hours, and a note that times are in UTC (or null values if polar day or night conditions apply).","failureModes":["Invalid or out-of-range latitude/longitude returns an error","Malformed date string (not YYYY-MM-DD) causes a parse error","Polar day or night conditions return null for sunrise or sunset times","Network timeout if the Render.com host is cold-starting","Missing input field returns a validation error"],"whenToPreferThis":"Choose this endpoint when you need precise UTC sunrise/sunset times and day length for any geographic coordinate on any date, especially in automated agent workflows where a pay-per-call micro-payment model ($0.001 USDC via x402) is acceptable. Prefer it over weather APIs that include sunrise as a secondary field when solar timing is your primary need, and when you want clean, minimal JSON output without unnecessary weather data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-01T06:52:26.991Z","isFirstParty":false,"canonicalSlug":"foundry-sunrise-sunset-times-72ec43e9"}