{"uid":"cap__Qf3f83I0Y7dbjH3VH6No","slug":"almanac-sky-api-celestial-positions-solar-lunar-data-29b7c222","name":"Almanac Sky API – Celestial Positions & Solar/Lunar Data","description":"Deterministic ephemeris snapshot (one location/time).","url":"https://almanac.locomot.io/sky","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":["lat","lon"],"properties":{"lat":{"type":"number","maximum":90,"minimum":-90},"lon":{"type":"number","maximum":180,"minimum":-180},"when":{"type":"string","description":"ISO-8601 UTC; default now"},"elevation_m":{"type":"number","description":"optional, default 0"}}}},"additionalProperties":false},"output":{"type":"object","properties":{"sun":{"type":"object"},"moon":{"type":"object"},"query":{"type":"object"},"bodies":{"type":"object"},"engine":{"type":"string"},"kernel":{"type":"string"},"twilight":{"type":"array"},"visible_now":{"type":"object"},"deterministic":{"type":"boolean"},"next_season_event":{"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.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_lCRbbItNyyaZ3ed5DNnxN","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns real-time or scheduled solar, lunar, planetary body positions, twilight times, and next seasonal event for a given geographic location and time.","exampleAgentPrompt":"What are the exact sunrise, sunset, moonrise, moonset, and twilight times for London (51.5074° N, -0.1278° W) tomorrow, May 20, 2025, at sea level?","exampleUseCases":null,"resultDescription":"A JSON object containing sun data (rise, set, azimuth, elevation), moon data (rise, set, phase, illumination), planetary body positions, an array of twilight intervals, a next_season_event object (e.g. next solstice), the astronomical engine and ephemeris kernel used, and a flag indicating whether the result is deterministic — all computed for the requested lat/lon and time.","failureModes":["Missing required lat or lon query params → 400 Bad Request","lat out of range [-90, 90] or lon out of range [-180, 180] → validation error","Invalid ISO-8601 format for 'when' → parsing error","Payment not provided or insufficient → 402 Payment Required","Server-side ephemeris computation failure → 500 Internal Server Error"],"whenToPreferThis":"Choose this endpoint when you need precise, computation-backed astronomical data (sun/moon positions, twilight, planetary bodies, seasonal events) for any geographic coordinate and arbitrary time. Prefer it over weather APIs (which may include basic sunrise/sunset but lack planetary positions and twilight breakdowns) and over static almanac tables (which are not real-time or coordinate-specific). Ideal for agents building stargazing planners, solar energy tools, photography golden-hour finders, or any app needing authoritative ephemeris-based celestial data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:36:21.214Z","isFirstParty":false}