{"uid":"cap_XlGg70pl8eUZwUkgt7HBZ","slug":"saylor-innovations-data-desk-jpl-horizons-ephemeris-8c898b4e","name":"Saylor Innovations Data Desk – JPL Horizons Ephemeris","description":"JPL Horizons sky position of the Sun, Moon, planets, Ceres or Vesta - right ascension, declination, apparent magnitude, distance in AU, range rate and elongation","url":"https://saylorinnovations.com/api/space/ephemeris?utm_source=zero.xyz","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"],"type":"string"},"queryParams":{"type":"object","required":["body"],"properties":{"body":{"type":"string","description":"sun, moon, mercury, venus, mars, jupiter, saturn, uranus, neptune, pluto, ceres or vesta"},"days":{"type":"string","description":"optional 1-30, default 3"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","required":["body","now","ephemeris"],"properties":{"now":{"type":"object","description":"Position at the first row: right ascension, declination, distance and magnitude"},"body":{"type":"string","description":"Main body text"},"days":{"type":"number","description":"Number of days"},"note":{"type":"string","description":"Caveat or context for reading the result"},"start":{"type":"string","description":"First date of the table"},"source":{"type":"string","description":"Data source the values come from"},"observer":{"type":"string","description":"Observer location the positions are computed for"},"ephemeris":{"type":"array","description":"Daily positions with RA and Dec in degrees, distance in AU, apparent magnitude and elongation"},"approaching":{"type":["boolean","null"],"description":"True when the body is getting closer to the observer"},"evening_visible_hint":{"type":["string","null"],"description":"Evening visible hint"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_oRJc1rOn5u2b5cuubDtLF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns JPL Horizons sky positions (RA, Dec, magnitude, AU distance, range rate, elongation) for the Sun, Moon, major planets, Ceres, or Vesta over 1–30 days","exampleAgentPrompt":"What is the current sky position of Jupiter — give me its right ascension, declination, apparent magnitude, and distance in AU, and show me a 5-day ephemeris table.","exampleUseCases":[{"title":"Tonight's planetary observing session","prompt":"I'm setting up my telescope tonight — can you get me the current right ascension, declination, apparent magnitude, and elongation for Saturn so I know where to point and whether it's well-placed?"},{"title":"Track Mars approach over two weeks","prompt":"Mars is supposed to be getting closer to Earth soon — can you pull a 14-day ephemeris for Mars showing its distance in AU and whether it's approaching or receding, so I can watch the brightening?"},{"title":"Comet and minor planet position lookup","prompt":"What's the current sky position of Ceres? I need its RA, Dec, apparent magnitude, and distance in AU for tonight's observation log."}],"resultDescription":"Returns a JSON object with: the target body name, current-epoch position snapshot (RA in degrees, Dec in degrees, distance in AU, apparent magnitude), an array of daily ephemeris rows covering the requested number of days (each with RA, Dec, distance, magnitude, elongation), the observer location used, data source attribution, an approaching boolean indicating whether the body is closing with Earth, and an optional evening-visible hint string.","failureModes":["Invalid body name (not one of the supported 13 targets) returns an error","days parameter outside 1–30 range is rejected","JPL Horizons upstream unavailable causes a service error","Missing required 'body' query parameter returns a validation error"],"whenToPreferThis":"Choose this endpoint when you need precise, authoritative JPL Horizons ephemeris data for solar system bodies — including right ascension, declination, apparent magnitude, AU distance, range rate, and elongation — over a multi-day window. Prefer it over generic astronomy APIs when you need the trusted JPL data source, coverage of minor planets Ceres and Vesta, or the approaching/evening-visible context flags. At $0.01 per call it is cost-effective for real-time observing planning or automated sky-monitoring workflows.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T19:25:45.955Z","isFirstParty":false,"canonicalSlug":"saylor-innovations-data-desk-jpl-horizons-ephemeris-8c898b4e"}