{"uid":"cap_XM4YzorNwgP_WrT9kNKLW","slug":"nasa-exoplanets-nearest-planets-lookup-f67ebc53","name":"NASA Exoplanets - Nearest Planets Lookup","description":"Closest known exoplanets to the Sun in light-years, optional size filter, with star type, orbit and habitable-zone position.","url":"https://exoplanets-nasa.x402tookit.com/nearest-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"],"type":"string"},"queryParams":{"type":"object","required":[],"properties":{"limit":{"type":"integer","description":"Planets returned, 1 to 50 (default 15)"},"maxDistancePc":{"type":"number","description":"Search out to this many parsecs, 1 to 25 (default 10; 1 pc = 3.26 light-years)"},"maxRadiusEarth":{"type":"number","description":"Only planets at most this many Earth radii, 0.1 to 30 (use 1.6 for likely rocky)"},"minRadiusEarth":{"type":"number","description":"Only planets at least this many Earth radii, 0.1 to 30"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"asOf":{"type":["null","string"]},"source":{"type":["null","string"]},"planets":{"type":["array","null"],"items":{"type":"object","properties":{"host":{"type":["null","string"]},"name":{"type":["null","string"]},"massEarth":{"type":["null","number"]},"sizeClass":{"type":["null","string"]},"radiusEarth":{"type":["null","number"]},"discoveryYear":{"type":["null","number"]},"massIsMinimum":{"type":["boolean","null"]},"discoveryMethod":{"type":["null","string"]},"distanceParsecs":{"type":["null","number"]},"insolationEarth":{"type":["null","number"]},"semiMajorAxisAu":{"type":["null","number"]},"equilibriumTempK":{"type":["null","number"]},"starSpectralType":{"type":["null","string"]},"orbitalPeriodDays":{"type":["null","number"]},"distanceLightYears":{"type":["null","number"]},"habitableZonePosition":{"type":["null","string"]}}}},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"returned":{"type":["null","number"]},"sourceUrl":{"type":["null","string"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"totalMatches":{"type":["null","number"]},"maxDistancePc":{"type":["null","number"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fGRBPvBvIH1ContlYW-Hp","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns the closest known exoplanets to the Sun sorted by distance in light-years, with optional size filtering, star type, orbital parameters, and habitable-zone position.","exampleAgentPrompt":"Show me the 20 closest known exoplanets to our Sun, but only include ones between 0.5 and 1.6 Earth radii so they're likely rocky — I want to see their star types, orbital periods, and whether they're in the habitable zone.","exampleUseCases":[{"title":"Hunting nearby rocky exoplanet candidates","prompt":"Give me the 15 closest exoplanets that are likely rocky — so no bigger than 1.6 Earth radii — and tell me which ones fall in their star's habitable zone."},{"title":"Surveying nearest star systems for planets","prompt":"List all confirmed exoplanets within 5 parsecs of the Sun, up to 50 results, so I can see what's in our stellar neighborhood and what types of stars host them."},{"title":"Filtering for Earth-sized worlds nearby","prompt":"Find me exoplanets within 10 parsecs that are between 0.8 and 1.25 Earth radii — I want to see their equilibrium temperatures and habitable zone positions to gauge which ones are most Earth-like."}],"resultDescription":"A JSON array of up to 50 exoplanets sorted by proximity to the Sun, each entry including planet name, host star name, distance in both light-years and parsecs, star spectral type, planet radius and mass in Earth units, size class label, orbital period in days, semi-major axis in AU, insolation relative to Earth, equilibrium temperature in Kelvin, habitable zone position, discovery year and method. Also includes a summary, verdict, data source URL, and timestamp.","failureModes":["No planets found matching filters (e.g. very narrow radius range with small search radius) — returns empty planets array","Invalid parameter values outside allowed ranges (e.g. limit > 50, maxDistancePc > 25) — returns validation error","Upstream NASA Exoplanet Archive unavailable — may return degraded=true with cached or partial data","minRadiusEarth greater than maxRadiusEarth — returns error or empty result"],"whenToPreferThis":"Use this endpoint when you need a ranked, proximity-sorted list of confirmed exoplanets near the Sun with rich physical and orbital metadata. Ideal when filtering by planet size is important (e.g. selecting likely rocky worlds). Prefer over general exoplanet search endpoints when distance from Earth is the primary sorting criterion and you want habitable-zone context included automatically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T13:14:28.247Z","isFirstParty":false,"canonicalSlug":"nasa-exoplanets-nearest-planets-lookup-f67ebc53"}