{"uid":"cap_OIPCIPoLcbJdiSBtnq-Vz","slug":"2s-io-sky-watch-integrated-sky-digest-f30c010e","name":"2s.io Sky Watch — Integrated Sky Digest","description":"One call → what's notable in YOUR sky right now, for a lat/lon. Synthesizes three sources: (1) the live almanac — sun up/down, moon phase + illumination, and which of the 7 naked-eye planets are currently above your horizon with their altitude/azimuth/magnitude; (2) near-Earth asteroid close approaches over the next 7 days (designation, date, distance in lunar distances); and (3) the ISS — its current sub-point, and whether it is above your horizon right now with look angles. Each section reports found/error independently. The \"is it dark, what's up, anything passing\" digest for stargazers and astrophotographers. For the raw almanac alone see /api/space/sky-tonight.","url":"https://2s.io/api/space/skywatch","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":{"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":{"lat":37.77,"lon":-122.42,"altitudeM":0}}},"response":{"data":{"at":"2026-06-10T04:30:03.400Z","iss":{"look":{"rangeKm":6392.18,"azimuthDeg":261.71,"aboveHorizon":false,"elevationDeg":-25.74},"error":null,"found":true,"geodetic":{"latitude":13.08805,"longitude":178.12608,"altitudeKm":413},"aboveHorizon":false},"sky":{"sun":{"nextSet":"2026-06-11T03:31:13.046Z","nextRise":"2026-06-10T12:47:21.676Z","altitudeDeg":-9.82,"aboveHorizon":false},"moon":{"phaseName":"Last Quarter","altitudeDeg":-43.26,"aboveHorizon":false,"illuminationPercent":31.47},"isDark":false,"planetsUp":[{"name":"Mercury","magnitude":0.04,"azimuthDeg":295.08,"altitudeDeg":7.98},{"name":"Venus","magnitude":-3.99,"azimuthDeg":285.75,"altitudeDeg":17.59},{"name":"Jupiter","magnitude":-1.85,"azimuthDeg":284.82,"altitudeDeg":16.21}]},"sources":[{"url":"https://github.com/cosinekitty/astronomy","license":"MIT — computed locally, no external data.","provider":"astronomy-engine (computed; VSOP87 / NOVAS-derived)"},{"url":"https://ssd-api.jpl.nasa.gov/doc/cad.html","license":"Public domain (NASA/JPL-Caltech).","provider":"NASA JPL Close-Approach Data (CAD) API"},{"url":"https://celestrak.org/NORAD/elements/","license":"Public-domain orbital data (US Space Force / 18 SDS, redistributed by Celestrak).","provider":"Celestrak GP element sets + SGP4 propagation (satellite.js)"}],"observer":{"lat":37.77,"lon":-122.42,"altitudeM":0},"closeApproaches":{"count":3,"error":null,"found":true,"approaches":[{"date":"2026-Jun-10 10:01","distanceLd":0.73,"designation":"2026 LB1","relativeVelocityKmS":3.65438132129752},{"date":"2026-Jun-16 05:22","distanceLd":3.13,"designation":"2026 LV","relativeVelocityKmS":5.62527327442124},{"date":"2026-Jun-12 18:59","distanceLd":16.01,"designation":"530520","relativeVelocityKmS":14.5695296473862}]}},"meta":{"cost":{"usd":0.00288,"tier":0},"caller":"x402","version":null,"endpoint":"space.skywatch","settlement":{"txHash":"0x5ef835b1e99b1d194a0d599092e9e899180912a32908e51ff1d9c61b704b5c8e","network":"eip155:8453","success":true}}}},"exampleRequest":{"lat":37.77,"lon":-122.42,"altitudeM":0},"tags":["x402"],"displayCostAmount":"0.00288","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.00288/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0072","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.0072","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_Wp6JEYPVyjRNNgMdVGwwL","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.0072","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a synthesized sky digest for a given lat/lon: sun/moon almanac, visible naked-eye planets above the horizon, near-Earth asteroid close approaches for the next 7 days, and live ISS position with visibility check.","exampleAgentPrompt":"What's worth looking at in the sky right now from latitude 37.77 and longitude -122.42 — what planets are up, is the ISS visible, and are there any asteroid flybys this week?","exampleUseCases":null,"resultDescription":"A structured digest with three independent sections: (1) almanac — sun rise/set, moon phase and illumination percentage, and a list of naked-eye planets currently above the horizon with altitude, azimuth, and magnitude; (2) asteroid close approaches — list of near-Earth objects over the next 7 days with designation, closest approach date, and distance in lunar distances; (3) ISS — current ground sub-point coordinates and whether it is presently above the observer's horizon with look angles (azimuth, elevation). Each section reports success or error independently.","failureModes":["Missing lat or lon query parameters returns an error for those sections","Invalid lat/lon values outside -90/90 and -180/180 range cause validation failure","Upstream NASA or ISS data source temporarily unavailable — affected section reports error while others succeed","Extreme observer elevations may produce edge-case horizon calculations"],"whenToPreferThis":"Use this endpoint when you need a single, synthesized sky overview combining planets, moon, sun, ISS, and asteroid data for a specific observer location — rather than calling separate astronomy APIs. Prefer /api/space/sky-tonight if you only need the raw almanac without ISS or asteroid data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T19:06:55.058Z","isFirstParty":false}