{"uid":"cap_vaiBiT_cfI1iSDTyL1MTg","slug":"halowerk-satellite-pass-predictor-5012aa36","name":"Halowerk Satellite Pass Predictor","description":"Propagates a circular two-body orbit from altitude, inclination, RAAN, and initial orbital phase; rotates Earth at a fixed sidereal rate; and samples ground-station elevation. It ignores eccentricity, perturbations, epoch-dependent Greenwich angle, refraction, ellipsoid shape, terrain, and antenna masks, so it is a planning estimate rather than operational ephemeris.","url":"https://space.halowerk.com/v1/satellite-pass","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"raan_deg":{"type":"number","maximum":360,"minimum":-360,"description":"Right ascension of ascending node relative to Greenwich at t=0."},"altitude_km":{"type":"number","maximum":100000,"minimum":100,"description":"Circular altitude above a spherical Earth."},"step_seconds":{"type":"integer","maximum":3600,"minimum":10},"inclination_deg":{"type":"number","maximum":180,"minimum":0},"duration_seconds":{"type":"integer","maximum":172800,"minimum":10},"initial_phase_deg":{"type":"number","maximum":360,"minimum":-360,"description":"Argument of latitude at t=0."},"ground_latitude_deg":{"type":"number","maximum":90,"minimum":-90},"ground_longitude_deg":{"type":"number","maximum":180,"minimum":-180},"minimum_elevation_deg":{"type":"number","maximum":90,"minimum":-5}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.004","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.004/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.004","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_gDHIq6RPMWdIsTERHAD0w","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.004","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Propagates a circular two-body orbit from orbital elements and samples when a satellite is visible above the horizon from a specified ground station location.","exampleAgentPrompt":"Predict satellite pass windows for the next 24 hours (step every 60 seconds) for a circular orbit at 550 km altitude, 53-degree inclination, RAAN 45 degrees, initial phase 0 degrees, over my ground station at 37.4 degrees north latitude and -122.1 degrees longitude, with a minimum elevation of 5 degrees.","exampleUseCases":[{"title":"CubeSat downlink scheduling","prompt":"I need to schedule downlink windows for my CubeSat in a 400 km circular orbit, 97-degree inclination, RAAN 200 degrees, starting phase 0 degrees. My ground station is at 51.5 degrees north, -0.1 degrees longitude. Can you predict all passes over the next 6 hours with 30-second steps and a minimum elevation of 10 degrees?"},{"title":"Amateur satellite contact planning","prompt":"When will a satellite at 800 km altitude, 65-degree inclination, RAAN 90 degrees, and initial phase 30 degrees pass over my location at 48.8 degrees north, 2.3 degrees east in the next 12 hours? Use 60-second steps and only show passes above 5 degrees elevation."},{"title":"Mission concept feasibility check","prompt":"I'm designing a relay mission at 1200 km altitude with 45-degree inclination, RAAN 0 degrees, and initial phase 0 degrees. How many contact windows would a ground station at 34 degrees north, 118 degrees west see over 48 hours, stepping every 120 seconds, with a minimum elevation of 8 degrees?"}],"resultDescription":"A time-series list of sampled epochs indicating whether the satellite is above the specified minimum elevation angle from the ground station, along with computed elevation values at each step, effectively identifying pass windows (start, peak, end) within the simulation duration.","failureModes":["altitude_km below 100 or above 100000 returns validation error","duration_seconds or step_seconds outside allowed bounds returns 400","ground latitude or longitude out of range returns parameter error","missing required fields returns schema validation error","very short step_seconds with long duration may produce large payloads","result is a planning estimate only — perturbations, eccentricity, terrain, and real ephemeris not modeled"],"whenToPreferThis":"Choose this endpoint when you need a fast, simplified circular-orbit pass prediction for planning purposes and do not require high-fidelity perturbation modeling, epoch-based Greenwich angle, terrain masking, or ellipsoid Earth corrections. Ideal for early mission design, link budget scheduling, or educational simulations where a two-body Keplerian approximation is sufficient.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T12:41:54.353Z","isFirstParty":false}