{"uid":"cap_ZXiqlY_vgEsO_vgx4Hijd","slug":"sunrise-sunset-moon-057c426f","name":"Sunrise, Sunset & Moon","description":"Sunrise, sunset, solar noon, day length, sun elevation, moonrise, moonset, moon phase and illumination for any place (name or coordinates) and date. Use for photography, prayer and event planning, solar or outdoor work.","url":"https://bess-x402.onrender.com/v1/geo/sun-moon?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","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"on":{"type":"string","description":"Date YYYY-MM-DD"},"lat":{"type":"number","description":"Latitude"},"lon":{"type":"number","description":"Longitude"},"place":{"type":"string","description":"City or address"},"utc_offset":{"type":"string","description":"Local UTC offset for the times, e.g. +04:00"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_XCxz_AYSQ4goyfiiNH8PD","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","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, day length, sun elevation, moonrise, moonset, moon phase, and illumination for any location and date.","exampleAgentPrompt":"What time does the sun rise and set in Kyoto, Japan on March 20, 2025, and what's the moon phase that night? Use UTC+9.","exampleUseCases":[{"title":"Golden hour planning for a photo shoot","prompt":"I'm doing a landscape shoot at the Grand Canyon on May 10, 2025 — can you tell me the exact sunrise and sunset times plus the sun elevation so I know when golden hour starts and ends?"},{"title":"Ramadan prayer time reference","prompt":"What are the sunrise and sunset times in Istanbul, Turkey for April 1, 2025? I need UTC+3 local times for fasting start and end."},{"title":"Full moon date check for an outdoor event","prompt":"I'm planning an outdoor night event in Austin, Texas on October 6, 2025 — can you tell me the moon phase, moonrise and moonset times, and how bright the moon will be that night?"}],"resultDescription":"Returns a structured JSON object with sunrise, sunset, solar noon, and day length times; sun elevation at solar noon; moonrise and moonset times; moon phase name (e.g. waxing gibbous, full moon); and moon illumination percentage — all expressed in the requested local UTC offset or UTC by default.","failureModes":["Missing both 'place' and 'lat'/'lon' parameters returns an error — at least one location method is required","Invalid date format (not YYYY-MM-DD) returns a parsing error","Unrecognized place name or address returns a geocoding failure","Invalid UTC offset format causes a time zone error","Service unavailable on Render cold start may cause slow or failed responses"],"whenToPreferThis":"Choose this endpoint when you need precise astronomical and lunar data for a specific location and date — especially when you need both solar and lunar data in one call. It covers sunrise/sunset, moon phase, and illumination together, making it ideal for photography planning, religious observance scheduling, outdoor event planning, and solar work scheduling. Prefer it over weather APIs that only incidentally include sunrise/sunset without lunar data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-28T06:44:26.987Z","isFirstParty":false,"canonicalSlug":"sunrise-sunset-moon-057c426f"}