{"uid":"cap_gOZ478TDq63KkDMRSNkWk","slug":"2s-io-sky-tonight-almanac-19ad7f9a","name":"2s.io Sky Tonight Almanac","description":"Observer-local sky almanac for any lat/lon and time (default now). Returns the Sun's next rise/set + current altitude/azimuth; the Moon's rise/set, current alt/az, phase angle, phase name (New → Full → Waning Crescent), illuminated fraction, and next moon quarter; and for all seven non-Earth planets (Mercury→Neptune): altitude, azimuth, RA/dec, distance (AU), apparent magnitude, and whether each is currently above the horizon. Computed from first principles (astronomy-engine, sub-arcminute) — no external service, no key. Stargazing, astrophotography planning, 'what's up right now', is-it-dark-yet. `at` accepts any ISO timestamp.","url":"https://2s.io/api/space/sky-tonight","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","queryParams"],"properties":{"type":{"const":"http"},"method":{"const":"GET"},"queryParams":{"required":["lat","lon"],"properties":{"at":{"type":"string","description":"Instant (ISO). Default: now."},"lat":{"type":"number","maximum":90,"minimum":-90},"lon":{"type":"number","maximum":180,"minimum":-180},"altitudeM":{"type":"number","description":"Observer elevation in meters (default 0)."}}}}}}},"responseSchema":null,"example":{"request":{"input":{"type":"http","method":"GET","queryParams":{"at":"2024-01-15T20:00:00Z","lat":40.7128,"lon":-74.006}}},"response":{"data":{"ok":true,"items":[{"sky":{"at":"2024-01-15T20:00:00.000Z","sun":{"set":"2024-01-15T21:52:51.954Z","rise":"2024-01-16T12:17:40.620Z","transit":null,"aboveHorizon":true,"azimuthNowDeg":222.09,"altitudeNowDeg":16.12},"moon":{"set":"2024-01-16T03:07:04.138Z","rise":"2024-01-16T15:34:44.734Z","transit":null,"phaseName":"Waxing Crescent","nextQuarter":{"at":"2024-01-25T17:54:43.297Z","name":"Full Moon"},"aboveHorizon":true,"azimuthNowDeg":158.96,"phaseAngleDeg":59.56,"altitudeNowDeg":42.41,"illuminationPercent":24.78},"planets":[{"name":"Mercury","magnitude":-0.27,"azimuthDeg":239.52,"distanceAu":1.0724,"altitudeDeg":0.82,"aboveHorizon":true,"declinationDeg":-22.33,"rightAscensionHours":18.14},{"name":"Venus","magnitude":-3.97,"azimuthDeg":247.59,"distanceAu":1.2719,"altitudeDeg":-6.76,"aboveHorizon":false,"declinationDeg":-21.72,"rightAscensionHours":17.34},{"name":"Mars","magnitude":1.36,"azimuthDeg":233.72,"distanceAu":2.3761,"altitudeDeg":3.98,"aboveHorizon":true,"declinationDeg":-23.86,"rightAscensionHours":18.61},{"name":"Jupiter","magnitude":-2.49,"azimuthDeg":105.48,"distanceAu":4.7079,"altitudeDeg":35.7,"aboveHorizon":true,"declinationDeg":12.47,"rightAscensionHours":2.27},{"name":"Saturn","magnitude":0.85,"azimuthDeg":184.52,"distanceAu":10.4718,"altitudeDeg":37.89,"aboveHorizon":true,"declinationDeg":-11.31,"rightAscensionHours":22.48},{"name":"Uranus","magnitude":5.69,"azimuthDeg":91.9,"distanceAu":19.1886,"altitudeDeg":29.2,"aboveHorizon":true,"declinationDeg":17.22,"rightAscensionHours":3.12},{"name":"Neptune","magnitude":7.92,"azimuthDeg":158.25,"distanceAu":30.378,"altitudeDeg":44.11,"aboveHorizon":true,"declinationDeg":-2.97,"rightAscensionHours":23.75}],"observer":{"lat":40.7128,"lon":-74.006,"altitudeM":0}}}],"total":1,"source":{"url":"https://github.com/cosinekitty/astronomy","license":"MIT — computed locally, no external data.","provider":"astronomy-engine (computed; VSOP87 / NOVAS-derived)"}},"meta":{"cost":{"usd":0.001,"tier":0},"caller":"x402","version":null,"endpoint":"space.sky-tonight","settlement":{"txHash":"0xceb807b23ec5e328fcecb9be4c858cd5422c459de0309d7d824946635ae3f5f4","network":"eip155:8453","success":true}}}},"exampleRequest":{"at":"2024-01-15T20:00:00Z","lat":40.7128,"lon":-74.006},"tags":["x402"],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","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.0025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8jwf9K12u0AiSRVbuO5Kd","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a full observer-local sky almanac for any latitude/longitude and time, including Sun and Moon positions/events and all seven non-Earth planets' current sky positions and visibility","exampleAgentPrompt":"What's up in the sky tonight from latitude 40.7128, longitude -74.0060? Give me the Sun's rise and set times, the Moon's phase and illumination, and which planets are currently above the horizon.","exampleUseCases":null,"resultDescription":"Returns a structured sky almanac including: Sun's next rise/set times and current altitude/azimuth; Moon's rise/set times, current altitude/azimuth, phase angle, phase name (e.g. Waning Crescent), illuminated fraction percentage, and next moon quarter; and for all seven non-Earth planets (Mercury through Neptune): altitude, azimuth, right ascension, declination, distance in AU, apparent magnitude, and a boolean indicating whether each is currently above the horizon.","failureModes":["Missing required lat/lon parameters returns a 400 error","Latitude out of range (-90 to 90) returns a validation error","Longitude out of range (-180 to 180) returns a validation error","Invalid ISO timestamp format for 'at' parameter returns a parse error","Payment failure or insufficient USDC balance blocks the request via x402","Extreme polar latitudes may produce unusual or undefined rise/set times (e.g. polar night/day)"],"whenToPreferThis":"Choose this endpoint when you need precise, observer-specific astronomical data computed from first principles without requiring an API key or external astronomy service. Ideal for stargazing apps, astrophotography planning tools, or any agent that needs to answer 'what's in the sky right now?' for a specific location and time. Preferred over general astronomy APIs when sub-arcminute accuracy, no-key access, and comprehensive planet/moon/sun data in one call are all needed.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:49:47.856Z","isFirstParty":false}