{"uid":"cap_5QKJBrc8EBHOjBaqCI3Cr","slug":"sampled-geometric-observing-window-celestial-visibility-8ef66858","name":"Sampled Geometric Observing Window - Celestial Visibility","description":"Deterministic approximate GMST geometry at supplied UTC samples, site and frozen equatorial positions; no refraction, weather, live data or continuous visibility claims. New modular adapter: retained result recovery for 24 hours, minimal receipt metadata for 90 days. Existing live route unchanged.","url":"https://www.mahastrategies.com/api/v1/celestial/observations/sampled-windows?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"site":{"type":"object"},"times":{"type":"array","maxItems":64,"minItems":1},"targets":{"type":"array","maxItems":12,"minItems":1},"dataClass":{"enum":["public","synthetic"],"type":"string"},"minimumAltitudeMicrodeg":{"type":"integer","maximum":90000000,"minimum":-90000000}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.100013","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.100013/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.100013","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.100013","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_B1WsS-HFFpmaT0S8h9e7h","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.100013","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Computes deterministic approximate GMST-based celestial geometry (altitude/visibility) for a set of UTC time samples, an observer site, and frozen equatorial target positions, without refraction or live atmospheric data.","exampleAgentPrompt":"Can you check whether my telescope targets at equatorial coordinates RA 10h 45m Dec +14° and RA 22h 30m Dec -5° will be above 15 degrees altitude from my site in Tucson (32.2°N, 110.9°W, 750m elevation) for these 8 UTC timestamps tomorrow night? Use public data class.","exampleUseCases":[{"title":"Nightly observation planning for amateur astronomer","prompt":"I want to observe three deep-sky objects tonight from my backyard in Santa Fe, NM (35.7°N, 105.9°W, 2100m). Can you check their altitudes for every hour between 22:00 and 04:00 UTC, with a minimum altitude of 20 degrees, using public data class?"},{"title":"Automated observatory target scheduling","prompt":"We need to schedule our robotic observatory at lat 28.3°N lon -16.5°W alt 2400m. Please evaluate 12 candidate targets across 24 UTC sample times tonight and flag any that rise above 30 degrees altitude — using public data class."},{"title":"Synthetic dataset generation for astronomy software testing","prompt":"I'm testing my planetarium app and need deterministic celestial geometry data — can you compute altitudes for 5 test targets from a site at 51.5°N 0.0°W 10m elevation across 10 evenly-spaced UTC samples using the synthetic data class, with no minimum altitude filter?"}],"resultDescription":"Returns a structured set of sampled celestial geometry results for each (time, target) pair: including approximate altitude and GMST-derived positional geometry. Results are retained for 24 hours; minimal receipt metadata is retained for 90 days. No atmospheric refraction, weather corrections, or live ephemeris data are included.","failureModes":["Too many time samples (>64) or targets (>12) — request rejected with validation error","Invalid site coordinates or missing required site fields — schema validation failure","Altitude threshold outside valid range (-90° to +90° in microdegrees) — rejected","Invalid or missing dataClass enum value — validation error","Malformed or missing times array — request rejected","Service unavailability returns 402 or 5xx errors depending on payment/routing layer"],"whenToPreferThis":"Choose this endpoint when you need deterministic, reproducible celestial geometry calculations at specific sampled UTC times for a fixed observer site and frozen equatorial target coordinates — especially when atmospheric refraction and live ephemeris accuracy are not required. It is ideal for planning, scheduling, synthetic dataset generation, and software testing where exact repeatability matters more than full precision. Prefer alternatives when you need real-time tracking, refraction-corrected altitudes, or continuous visibility curves.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-16T12:44:13.378Z","isFirstParty":false,"canonicalSlug":"sampled-geometric-observing-window-celestial-visibility-8ef66858"}