{"uid":"cap_XtbUkiaSk5nsuI4l00wHB","slug":"saylor-innovations-planets-visible-tonight-ed0d3113","name":"Saylor Innovations Planets Visible Tonight","description":"Planets Visible Tonight (times, altitude, direction) — Science","url":"https://saylorinnovations.com/api/sky/planets?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","POST","PUT","PATCH","DELETE","HEAD"],"type":"string"},"queryParams":{"type":"object","properties":{"lat":{"type":"string","description":"latitude (query)"},"lon":{"type":"string","description":"longitude (query)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string","const":"json"},"example":{"type":"object","required":["planets"],"properties":{"planets":{"type":"array","items":{"type":"object"}},"visible_count":{"type":"number"}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.001","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.001/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__o5QvH7afZ7lawky2Xq83","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns which planets are visible tonight from a given location, including best viewing time, maximum altitude, compass direction, hours above 10°, and elongation from the Sun.","exampleAgentPrompt":"What planets can I see tonight from Austin, Texas — I want to know the best time to look, which direction to face, and how high they'll get above the horizon.","exampleUseCases":[{"title":"Backyard stargazing session planning","prompt":"I'm heading out to stargaze tonight from my backyard in Denver, Colorado — can you tell me which planets will be visible, when to look, and which direction to face for each one?"},{"title":"Astrophotography golden window finder","prompt":"I want to photograph planets tonight from London — can you find out which planets will be up, their maximum altitude, and the best time each one peaks so I can plan my shots?"},{"title":"Classroom astronomy activity","prompt":"I'm teaching a class in Sydney tomorrow morning and want to show students which planets are visible pre-dawn — can you look up what planets will be above 10 degrees and in which direction from our location at latitude -33.87 and longitude 151.21?"}],"resultDescription":"Returns an array of planet objects each containing the planet's name, best viewing time, maximum altitude in degrees, compass direction, number of hours it will be above 10 degrees, and its elongation from the Sun. Also includes a count of how many planets are visible tonight.","failureModes":["Missing or invalid latitude/longitude returns an error or empty planet list","Coordinates outside valid range (-90 to 90 lat, -180 to 180 lon) may cause computation errors","If no planets are visible tonight from the location, visible_count may be 0 with an empty array","Network or payment failure (x402) may prevent the response from being returned"],"whenToPreferThis":"Use this endpoint when you need real-time, location-specific planetary visibility data for any night, especially when you need computed details like altitude, azimuth, viewing window hours, and solar elongation in a single call. Prefer this over generic astronomy APIs when you need actionable observing guidance (best time, compass direction) rather than raw ephemeris data.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T12:54:11.454Z","isFirstParty":false,"canonicalSlug":"saylor-innovations-planets-visible-tonight-ed0d3113"}