{"uid":"cap_8qQzLN8RfLKCDobHefSR-","slug":"touchstone-sky-astronomical-ephemeris-api-c6fa0eca","name":"Touchstone Sky — Astronomical Ephemeris API","description":"Deterministic ephemeris snapshot (one location/time). Free sample, no payment required: GET /play/sky","url":"https://touchstone.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_mKxP2gJMgIXIoWvXmgI1O","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 sun, moon, planetary body positions, twilight times, and next seasonal event for a given lat/lon and optional time","exampleAgentPrompt":"What are the sunrise, sunset, and twilight times today at latitude 37.77 and longitude -122.42, and when is the next solstice or equinox?","exampleUseCases":null,"resultDescription":"Returns a JSON object with sun data (rise, set, azimuth, altitude), moon data (rise, set, phase, illumination), positions of other planetary bodies, an array of twilight events (civil, nautical, astronomical), the next upcoming seasonal event (solstice/equinox), and metadata about the computation engine and kernel. The response is deterministic for a given input.","failureModes":["Missing lat or lon parameters returns a 400/422 validation error","Latitude out of range -90 to 90 or longitude out of range -180 to 180 returns schema validation error","Malformed or non-ISO-8601 'when' timestamp results in parse error","Payment not provided or insufficient for x402 protocol returns 402 Payment Required","Elevation value out of reasonable range may cause computation anomalies"],"whenToPreferThis":"Use this endpoint when you need precise, physics-based astronomical ephemeris data for a geographic location — including sun/moon rise/set times, planetary positions, twilight windows, and seasonal events. It is preferable over weather APIs (which focus on atmospheric data) or simple sunrise APIs (which lack moon, planets, and twilight breakdown). Best suited for stargazing apps, navigation tools, astronomical planning, outdoor activity scheduling, or any application requiring precise celestial timing.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:40:11.436Z","isFirstParty":false}