JPL Solar System Dynamics

App · 20 actions

NASA JPL's data on asteroids, comets and the solar system: close approaches to Earth, fireballs, impact risks, the Small-Body Database, newly discovered objects, human-accessible asteroids, mission targets, radar data, Julian dates, and where any planet, moon, spacecraft or asteroid is from Horizons. No account or API key required.

Actions

ActionWhat it does
Convert date to Julian dayTurn a date and time (UTC) into its Julian day number, the count of days astronomers use, and its Modified Julian Date.
Convert Julian day to dateTurn a Julian day number into its calendar date and time (UTC), day of the week and day of the year.
Find asteroids and comets in a sky areaList the known asteroids and comets inside a square patch of sky at a given time, as seen from an observatory or a place on Earth: their positions, brightness and motion.
Get asteroid or cometLook up one asteroid or comet in JPL's Small-Body Database by name, number or designation: its orbit, orbit class, whether it is a near-Earth or potentially hazardous object, size, rotation, composition, discovery, moons and any possible Earth impacts.
Get human-accessible asteroidGet the round trips NHATS found to one near-Earth asteroid: the cheapest and the shortest, each with its launch date, legs, stay and fuel needs.
Get impact riskGet Sentry's impact assessment for one asteroid: every date it could hit Earth with the odds, hazard ratings and impact energy, plus its size and observation history.
Get newly discovered objectGet Scout's latest assessment of one newly discovered object by its temporary name.
Get position in spaceGet where a body is in space, as X, Y and Z position and velocity relative to the Sun, Earth or another center, at a moment or over a span of time, with its distance and light time.
Get sky positionFind where the Sun, a planet, a moon, a spacecraft, an asteroid or a comet appears in the sky at a moment or over a span of time: right ascension and declination, brightness, distance, constellation and, for a place on Earth, its direction and height above the horizon.
List asteroid moonsList the known moons of asteroids and comets, or of one of them, with each moon's name, discovery year, orbit and size where known.
List close approachesList asteroids and comets passing close to Earth (or another planet or the Moon) in a date range, with how close they come in lunar distances and kilometres, their speed and their likely size.
List fireballsList fireballs (exceptionally bright meteors) detected by US Government sensors: when and where each one exploded, how high, how fast, and its energy in kilotons of TNT.
List human-accessible asteroidsList near-Earth asteroids a crewed round trip could reach within your mission limits (fuel, length, stay, launch years), from NASA's NHATS study: the cheapest and the shortest trip to each, its size, and when it can next be observed.
List impact risksList the asteroids on NASA's Sentry risk list: objects with a possible (usually tiny) chance of hitting Earth in the next century or more, with their odds, hazard ratings, impact years and size.
List newly discovered objectsList objects discovered in the last few days that are waiting for confirmation, as JPL's Scout system rates them: how likely each is a near-Earth object, how close it may come, its impact rating and where it is in the sky.
List objects removed from the risk listList the asteroids Sentry took off its risk list because new observations ruled out every impact, most recently removed first.
List radar observationsList radar measurements of asteroids and comets (distance by echo delay, speed by Doppler shift) from stations such as Goldstone and Arecibo, newest first.
List spacecraft mission targetsList the asteroids and comets a robotic spacecraft could reach most easily for launches in the years you choose, with the best launch and arrival dates, flight time and fuel (delta-v) for each.
List three-body periodic orbitsList periodic orbits of one family in a three-body system, such as halo orbits around the Earth-Moon L1 point, from JPL's catalog: starting position and velocity, period in days, and stability.
Search asteroids and cometsFind every asteroid or comet in JPL's Small-Body Database that matches your filters (kind, near-Earth or hazardous, orbit class, moons, and constraints such as 'diameter > 100'), returning the fields you choose.

Convert date to Julian day

Turn a date and time (UTC) into its Julian day number, the count of days astronomers use, and its Modified Julian Date.

Inputs

Date and timedate_timedate and timeRequired
The moment to convert (UTC).

Outputs

calendar_datetext
The date and time converted, UTC
day_of_weektext
Day of the week
day_of_yearnumber
Day of the year
julian_datenumber
The Julian day number
modified_julian_datenumber
The Modified Julian Date (Julian day - 2400000.5)
summarytext
One line describing the result
Example output
{
  "calendar_date": "2026-10-19 14:30:15",
  "day_of_week": "Monday",
  "day_of_year": 292,
  "julian_date": 2461333.1043403,
  "modified_julian_date": 61332.6043403,
  "summary": "2026-10-19 14:30:15 UTC is Julian day 2461333.1043403."
}

Convert Julian day to date

Turn a Julian day number into its calendar date and time (UTC), day of the week and day of the year. Dates before 15 October 1582 are in the Julian calendar.

Inputs

Julian dayjulian_datenumberRequired
The Julian day number, such as 2451545.0 (noon on 1 January 2000).From -1931076.5 to 38245308.5.
Precisionprecisiontext
How precisely to give the time. Defaults to the nearest second.One of: s (Nearest second), s.3 (Milliseconds), m (Nearest minute), d (Nearest day).

Outputs

calendar_datetext
The date and time, UTC, e.g. 2000-01-01 12:30:45
datetext
The date, YYYY-MM-DD (the year can be negative)
day_of_weektext
Day of the week
day_of_yearnumber
Day of the year
isotext
The moment as ISO 8601, for years 0 to 9999
modified_julian_datenumber
The Modified Julian Date
monthnumber
Month number
month_nametext
Month, e.g. Jan
summarytext
One line describing the result
timetext
The time of day, UTC
yearnumber
Year
Example output
{
  "calendar_date": "2000-01-01 12:30:45",
  "date": "2000-01-01",
  "day_of_week": "Saturday",
  "day_of_year": 1,
  "iso": "2000-01-01T12:30:45Z",
  "modified_julian_date": 51544.5213542,
  "month": 1,
  "month_name": "Jan",
  "summary": "Julian day 2451545.0213542 is Saturday 2000-01-01 12:30:45 UTC.",
  "time": "12:30:45",
  "year": 2000
}

Find asteroids and comets in a sky area

List the known asteroids and comets inside a square patch of sky at a given time, as seen from an observatory or a place on Earth: their positions, brightness and motion. Useful for identifying something in a telescope image. Takes 20 seconds to a few minutes.

Inputs

Timeobservation_timedate and timeRequired
When the sky is observed (UTC).
Right ascension (degrees)right_ascension_degnumberRequired
The center of the area, 0 to 360 degrees (hours x 15).From 0 to 360.
Declination (degrees)declination_degnumberRequired
The center of the area, -90 to 90 degrees.From -90 to 90.
Half-width (degrees)half_width_degnumber
From the center to each edge, 0.01 to 10 degrees. Defaults to 0.5.From 0.01 to 10.
Observatory codeobservatory_codetext
The Minor Planet Center code of the observatory, such as 568 (Mauna Kea) or G96 (Mt. Lemmon). Or give a latitude and longitude instead.
Latitudelatitudenumber
Your latitude in degrees, -90 to 90 (north is positive).From -90 to 90.
Longitudelongitudenumber
Your longitude in degrees, -180 to 180 (east is positive).From -180 to 180.
Altitude (km)altitude_kmnumber
Your height above sea level in km, with a latitude and longitude.From -1 to 10.
Faintest magnitudemax_magnitudenumber
Skip objects fainter than this V magnitude. Defaults to 20.From -30 to 40.
Objectsgrouptext
Which objects to look for. Defaults to all asteroids and comets.One of: all (All asteroids and comets), neo (Near-Earth objects only), asteroids (Asteroids only), comets (Comets only).
Precise positionsprecisetrue/false
Compute exact positions (slower) instead of a quick estimate.

Outputs

countnumber
How many are in this result
field_centertext
The center of the area, as JPL writes it
locationtext
Where the sky was seen from
objectslist
The objects found, nearest the center first
observation_timetext
The time used, as JPL writes it
summarytext
One line describing the result
Example output
{
  "count": 1,
  "field_center": "02:00:00.00, +10 00'00.00\" (J2000)",
  "location": "Mauna Kea",
  "objects": [
    {
      "dec_rate_arcsec_per_hour": 4.755,
      "declination": "+09 56'27\"",
      "distance_from_center_arcsec": 231.8,
      "error_dec_arcsec": 49.85,
      "error_ra_arcsec": 49.85,
      "magnitude": 17.9,
      "name": "90321 (2003 FZ67)",
      "offset_dec_arcsec": -213.0,
      "offset_ra_arcsec": 92.2,
      "ra_rate_arcsec_per_hour": -43.06,
      "right_ascension": "02:00:06"
    }
  ],
  "observation_time": "2026-Oct-19 08:00:00 (2461332.833333 UT)",
  "summary": "1 known object in the 0.4\u00b0 field at RA 30\u00b0, Dec 10\u00b0 seen from Mauna Kea at 2026-10-19 08:00 UTC; nearest the center: 90321 (2003 FZ67)."
}

Get asteroid or comet

Look up one asteroid or comet in JPL's Small-Body Database by name, number or designation: its orbit, orbit class, whether it is a near-Earth or potentially hazardous object, size, rotation, composition, discovery, moons and any possible Earth impacts.

Inputs

Asteroid or cometobject_nametextRequired
A name, number or designation, such as Eros, 433, 2000 SG344 or 1P.
Include close approachesinclude_close_approachestrue/false
Also list its past and future close approaches to the planets.

Outputs

close_approacheslist
Its close approaches, when asked for
designationtext
Primary designation, e.g. 433 or 2000 SG344
discoveryobject
How it was discovered (numbered objects only)
is_neotrue/false
True for a near-Earth object
is_phatrue/false
True for a potentially hazardous asteroid
kindtext
numbered asteroid, unnumbered asteroid, numbered comet or unnumbered comet
nametext
Full name, e.g. 433 Eros (A898 PA)
orbitobject
Its orbit
orbit_classtext
Orbit class, e.g. Amor or Main-belt Asteroid
orbit_class_codetext
Orbit class code, e.g. AMO or MBA
physicalobject
Its main physical properties, where measured
physical_parameterslist
Every physical parameter JPL holds, with its source
potential_impactslist
Possible Earth impacts Sentry lists for it
satelliteslist
Its known moons
sbdb_urltext
The object's page in JPL's Small-Body Database Lookup
short_nametext
Short name, e.g. 433 Eros
spk_idtext
JPL's numeric id for it (SPK-ID)
summarytext
One line describing the result
Example output
{
  "close_approaches": [
    {
      "approach_time": "2056-Jan-24 08:26",
      "approach_time_iso": "2056-01-24T08:26:00Z",
      "body": "Earth",
      "distance_au": 0.15,
      "distance_ld": 58.374,
      "relative_velocity_km_s": 5.95
    }
  ],
  "designation": "433",
  "discovery": {
    "citation": null,
    "date": "1898-Aug-13",
    "discoverer": "Witt, G.",
    "location": "Berlin",
    "site": null,
    "text": "Discovered 1898-08-13 by Witt, G. at Berlin"
  },
  "is_neo": true,
  "is_pha": false,
  "kind": "numbered asteroid",
  "name": "433 Eros (A898 PA)",
  "orbit": {
    "aphelion_distance_au": 1.78,
    "ascending_node_deg": 304.0,
    "condition_code": 0,
    "data_arc_days": 46582,
    "earth_moid_au": 0.149,
    "earth_moid_ld": 57.987,
    "eccentricity": 0.223,
    "epoch": "2026-Jun-09.0",
    "epoch_jd": 2461200.5,
    "first_observation": "1893-10-29",
    "inclination_deg": 10.8,
    "jupiter_moid_au": 3.3,
    "last_observation": "2021-05-13",
    "mean_anomaly_deg": 62.5,
    "mean_motion_deg_per_day": 0.56,
    "observations_used": 9130,
    "orbit_id": "659",
    "perihelion_argument_deg": 179.0,
    "perihelion_distance_au": 1.13,
    "perihelion_time": "2026-Feb-17.313",
    "perihelion_time_jd": 2461088.813,
    "period_days": 643.0,
    "period_years": 1.76,
    "semi_major_axis_au": 1.46,
    "solution_date": "2021-05-24 17:55:05",
    "tisserand_jupiter": 4.582
  },
  "orbit_class": "Amor",
  "orbit_class_code": "AMO",
  "physical": {
    "absolute_magnitude": 10.4,
    "albedo": 0.25,
    "color_b_v": 0.921,
    "color_u_b": 0.531,
    "density_g_cm3": 2.67,
    "diameter_km": 16.84,
    "dimensions_km": "34.4x11.2x11.2",
    "gm_km3_s2": 0.0004463,
    "magnitude_slope": 0.46,
    "pole_direction": "11.37/17.22",
    "rotation_period_hours": 5.27,
    "spectral_type_smassii": "S",
    "spectral_type_tholen": "S"
  },
  "physical_parameters": [
    {
      "name": "diameter",
      "reference": "Yeomans et al. (2000) Science v.289,pp.2085-2088",
      "sigma": "0.06",
      "title": "diameter",
      "units": "km",
      "value": "16.84"
    }
  ],
  "potential_impacts": [],
  "satellites": [],
  "sbdb_url": "https://ssd.jpl.nasa.gov/tools/sbdb_lookup.html#/?sstr=20000433",
  "short_name": "433 Eros",
  "spk_id": "20000433",
  "summary": "433 Eros (A898 PA): numbered asteroid, Amor orbit, 1.76 year orbit, 16.84 km across, near-Earth object"
}

Get human-accessible asteroid

Get the round trips NHATS found to one near-Earth asteroid: the cheapest and the shortest, each with its launch date, legs, stay and fuel needs. 'meets_limits' is false when no trip fits the limits given.

Inputs

Asteroid or cometdesignationtextRequired
Its number or designation, such as 99942, 2000 SG344 or 1P (a name like Apophis works only in 'Get asteroid or comet').
Most delta-vmax_delta_vtext
The most total delta-v (fuel) a round trip may need. Defaults to 12 km/s.One of: 4 (4 km/s), 5 (5 km/s), 6 (6 km/s), 7 (7 km/s), 8 (8 km/s), 9 (9 km/s), 10 (10 km/s), 11 (11 km/s), 12 (12 km/s).
Longest missionmax_duration_daystext
The longest a round trip may take. Defaults to 450 days.One of: 60 (60 days), 90 (90 days), 120 (120 days), 150 (150 days), 180 (180 days), 210 (210 days), 240 (240 days), 270 (270 days), 300 (300 days), 330 (330 days), and 4 more.
Shortest staymin_stay_daystext
The least time to spend at the asteroid. Defaults to 8 days.One of: 8 (8 days), 16 (16 days), 24 (24 days), 32 (32 days).
Launch yearslaunch_windowtext
When the mission launches. Defaults to 2020 to 2045.One of: 2020-2045 (2020 to 2045), 2020-2025 (2020 to 2025), 2025-2030 (2025 to 2030), 2030-2035 (2030 to 2035), 2035-2040 (2035 to 2040), 2040-2045 (2040 to 2045).

Outputs

absolute_magnitudenumber
Absolute magnitude H
computedtext
When NHATS computed the trajectories
designationtext
The asteroid's designation
diameter_mnumber
Measured diameter, metres, when known
max_diameter_mnumber
Largest likely diameter, metres
meets_limitstrue/false
False when no round trip meets the limits given
min_delta_v_duration_daysnumber
Length of that lowest delta-v round trip, days
min_delta_v_km_snumber
Lowest total delta-v of any round trip, km/s
min_delta_v_trajectoryobject
The round trip needing the least delta-v
min_diameter_mnumber
Smallest likely diameter, metres
min_duration_daysnumber
Shortest round trip, days
min_duration_delta_v_km_snumber
Delta-v of that shortest round trip, km/s
min_duration_trajectoryobject
The shortest round trip
nametext
Its full name
next_optical_magnitudenumber
Its brightness (V magnitude) in that window
next_optical_window_endtext
End of that window
next_optical_window_starttext
Start of the next good window to observe it with telescopes
next_radar_date_goldstonetext
Next date Goldstone radar could observe it
orbit_condition_codenumber
Orbit uncertainty, 0 (good) to 9 (poor)
sbdb_urltext
The object's page in JPL's Small-Body Database Lookup
summarytext
One line describing the result
viable_trajectoriesnumber
How many round trips meet the limits
Example output
{
  "absolute_magnitude": 24.7,
  "computed": "2021-04-19",
  "designation": "2000 SG344",
  "diameter_m": null,
  "max_diameter_m": 89.0,
  "meets_limits": true,
  "min_delta_v_duration_days": 370,
  "min_delta_v_km_s": 3.549,
  "min_delta_v_trajectory": {
    "arrival_delta_v_km_s": 0.137,
    "asteroid_departure_delta_v_km_s": 0.166,
    "departure_declination_deg": -11.923,
    "departure_v_infinity_km_s": 1.227,
    "earth_departure_delta_v_km_s": 3.246,
    "earth_return_delta_v_km_s": 0.0,
    "entry_speed_km_s": 11.15,
    "launch_date": "2029-10-12",
    "launch_energy_c3_km2_s2": 1.507,
    "outbound_days": 201,
    "return_days": 161,
    "return_declination_deg": -13.06,
    "stay_days": 8,
    "total_delta_v_km_s": 3.549,
    "total_duration_days": 370,
    "trajectory_id": "2280521"
  },
  "min_diameter_m": 20.0,
  "min_duration_days": 34,
  "min_duration_delta_v_km_s": 11.402,
  "min_duration_trajectory": {
    "arrival_delta_v_km_s": 0.137,
    "asteroid_departure_delta_v_km_s": 0.166,
    "departure_declination_deg": -11.923,
    "departure_v_infinity_km_s": 1.227,
    "earth_departure_delta_v_km_s": 3.246,
    "earth_return_delta_v_km_s": 0.0,
    "entry_speed_km_s": 11.15,
    "launch_date": "2028-04-08",
    "launch_energy_c3_km2_s2": 1.507,
    "outbound_days": 201,
    "return_days": 161,
    "return_declination_deg": -13.06,
    "stay_days": 8,
    "total_delta_v_km_s": 11.402,
    "total_duration_days": 34,
    "trajectory_id": "2280521"
  },
  "name": "(2000 SG344)",
  "next_optical_magnitude": 19.11,
  "next_optical_window_end": "2028-09-11",
  "next_optical_window_start": "2028-04-28",
  "next_radar_date_goldstone": "2028-05-07",
  "orbit_condition_code": 3,
  "sbdb_url": "https://ssd.jpl.nasa.gov/tools/sbdb_lookup.html#/?sstr=2000%20SG344",
  "summary": "2000 SG344: cheapest round trip launches 2029-10-12, 3.549 km/s over 370 days.",
  "viable_trajectories": 3302685
}

Get impact risk

Get Sentry's impact assessment for one asteroid: every date it could hit Earth with the odds, hazard ratings and impact energy, plus its size and observation history. An object Sentry does not list comes back with 'on_risk_list' false, saying whether it was removed and when.

Inputs

Asteroid or cometdesignationtextRequired
Its number or designation, such as 99942, 2000 SG344 or 1P (a name like Apophis works only in 'Get asteroid or comet').

Outputs

absolute_magnitudenumber
Absolute magnitude H
computed_attext
When Sentry last analysed it (Pacific time)
designationtext
The object's designation
diameter_kmnumber
Estimated diameter, km
first_observedtext
Date of the first observation used
impact_energy_megatonsnumber
Impact energy in megatons of TNT
impact_probabilitynumber
Chance of any of its possible impacts, 0 to 1
impact_velocity_km_snumber
Speed at atmospheric entry, km/s
impactslist
Each possible impact
last_observedtext
Date of the last observation used
mass_kgnumber
Estimated mass, kg
methodtext
Sentry's analysis method, e.g. IOBS
nametext
Its full name
observation_arc_daysnumber
Days spanned by the observations
observationsnumber
Number of observations used
on_risk_listtrue/false
True while Sentry lists possible impacts for it
palermo_scale_cumulativenumber
Palermo scale over all possible impacts
palermo_scale_maxnumber
Palermo scale of its most threatening impact
potential_impactsnumber
How many possible impact dates Sentry found
removedtrue/false
True when it was on the list and later removed
removed_attext
When it was removed (UTC), if it was
sbdb_urltext
The object's page in JPL's Small-Body Database Lookup
summarytext
One line describing the result
torino_scale_maxnumber
Highest Torino scale rating, 0 to 10
velocity_infinity_km_snumber
Speed relative to Earth ignoring its gravity, km/s
Example output
{
  "absolute_magnitude": 17.94,
  "computed_at": "2026-10-06 11:25:37",
  "designation": "29075",
  "diameter_km": 1.3,
  "first_observed": "1950-02-23",
  "impact_energy_megatons": 75200.0,
  "impact_probability": 0.0003633,
  "impact_velocity_km_s": 17.97,
  "impacts": [
    {
      "date": "2880-03-16.99",
      "energy_megatons": 75200.0,
      "impact_probability": 0.0003633,
      "palermo_scale": -0.95,
      "sigma": 4.0738,
      "torino_scale": null
    }
  ],
  "last_observed": "2026-10-05",
  "mass_kg": 1960000000000.0,
  "method": "IOBS",
  "name": "29075 (1950 DA)",
  "observation_arc_days": 27983.0,
  "observations": 1184,
  "on_risk_list": true,
  "palermo_scale_cumulative": -0.95,
  "palermo_scale_max": -0.95,
  "potential_impacts": 1,
  "removed": false,
  "removed_at": null,
  "sbdb_url": "https://ssd.jpl.nasa.gov/tools/sbdb_lookup.html#/?sstr=29075",
  "summary": "29075 (1950 DA): 1 in 2,753 of hitting Earth over 1 possible impact date, the first on 2880-03-16; Palermo -0.95.",
  "torino_scale_max": null,
  "velocity_infinity_km_s": 14.1
}

Get newly discovered object

Get Scout's latest assessment of one newly discovered object by its temporary name. Objects leave Scout once they are confirmed and designated.

Inputs

Temporary nametemporary_designationtextRequired
Its temporary name, such as P22rrse, from 'List newly discovered objects'.

Outputs

absolute_magnitudenumber
Absolute magnitude H (rough)
arc_hoursnumber
Hours between the first and last observation
close_approach_ldnumber
Closest approach to Earth, lunar distances (rough)
comet_scorenumber
Chance of a comet-like orbit, 0-100
declinationtext
Current declination, degrees
earth_moid_aunumber
Closest distance between its orbit and Earth's, au (rough)
ephemeris_timetext
Time the position fields refer to (UTC)
fit_rmsnumber
How well the orbit fits the observations (normalised RMS)
geocentric_scorenumber
Chance it orbits Earth (often space debris), 0-100
impact_ratingnumber
Scout's impact rating, 0 (negligible) to 4 (elevated)
impact_rating_labeltext
The rating in words: negligible, small, modest, moderate or elevated
interior_earth_scorenumber
Chance its orbit lies inside Earth's, 0-100
last_runtext
When Scout last analysed it (UTC)
magnitudenumber
Current brightness (V magnitude)
motion_arcsec_per_minnumber
How fast it moves across the sky, arcseconds per minute
neo_1km_scorenumber
Chance it is a near-Earth object over 1 km, 0-100
neo_scorenumber
Chance it is a near-Earth object, 0-100
observationsnumber
Observations so far
pha_scorenumber
Chance it is a potentially hazardous asteroid, 0-100
right_ascensiontext
Current right ascension, hh:mm
solar_elongation_degnumber
Angle from the Sun in the sky, degrees
summarytext
One line describing the result
temporary_designationtext
Its temporary name on the confirmation page, e.g. P22rrse
uncertainty_arcminnumber
Current position uncertainty (1-sigma), arcminutes
uncertainty_tomorrow_arcminnumber
Position uncertainty a day from now, arcminutes
velocity_infinity_km_snumber
Speed relative to Earth, km/s
Example output
{
  "absolute_magnitude": 23.4,
  "arc_hours": 0.5,
  "close_approach_ld": 12.0,
  "comet_score": 35,
  "declination": "+18",
  "earth_moid_au": 0.08,
  "ephemeris_time": "2026-10-20 00:00",
  "fit_rms": 0.14,
  "geocentric_score": 0,
  "impact_rating": 0,
  "impact_rating_label": "negligible",
  "interior_earth_score": 0,
  "last_run": "2026-10-19 22:12",
  "magnitude": 21.0,
  "motion_arcsec_per_min": 6.3,
  "neo_1km_score": 0,
  "neo_score": 94,
  "observations": 3,
  "pha_score": 1,
  "right_ascension": "03:24",
  "solar_elongation_deg": 153.0,
  "summary": "P22rrse: 94% likely a near-Earth object, may pass within 12 lunar distances, impact rating negligible",
  "temporary_designation": "P22rrse",
  "uncertainty_arcmin": 4.2,
  "uncertainty_tomorrow_arcmin": 34.0,
  "velocity_infinity_km_s": null
}

Get position in space

Get where a body is in space, as X, Y and Z position and velocity relative to the Sun, Earth or another center, at a moment or over a span of time, with its distance and light time. From JPL's Horizons system.

Inputs

BodytargettextRequired
Pick the Sun, a planet, a moon or a spacecraft, or type any asteroid, comet or body Horizons knows: Apophis, 2024 YR4, C/2023 A3, or an id such as 499.
Relative tocentertext
The center the position is measured from. Defaults to the Sun.One of: 500@10 (Sun), 500@0 (Solar System barycenter), 500@399 (Earth), 500@301 (Moon), 500@499 (Mars), 500@599 (Jupiter).
Fromstartdate and time
The first moment (UTC). Leave 'Until' blank for this one moment. Blank means now.
Untilstopdate and time
The last moment (UTC), for a table over a span of time.
Everystep_sizenumber
The gap between rows, with 'Step unit'. Defaults to 1. At most 500 rows.From 1 to 100000.
Step unitstep_unittext
Minutes, hours or days. Defaults to days.One of: m (Minutes), h (Hours), d (Days).
Unitsunitstext
Astronomical units and au/day, or km and km/s. Defaults to au.One of: AU-D (Astronomical units and au/day), KM-S (Kilometres and km/s).
Reference planereference_planetext
The plane X and Y lie in. Defaults to the ecliptic.One of: ECLIPTIC (Ecliptic (the plane of Earth's orbit)), FRAME (Earth's equator (ICRF)).

Outputs

centertext
The center, e.g. Sun
countnumber
How many are in this result
distance_unittext
au or km
speed_unittext
au/day or km/s
summarytext
One line describing the result
targettext
The body, as Horizons names it
target_idtext
The body's Horizons id
vectorslist
One row per moment (TDB)
Example output
{
  "center": "Sun",
  "count": 1,
  "distance_unit": "au",
  "speed_unit": "au/day",
  "summary": "Earth is 0.996212 au from the Sun at 2026-10-19 00:00 TDB.",
  "target": "Earth",
  "target_id": "399",
  "vectors": [
    {
      "distance": 0.9962121831279669,
      "julian_date_tdb": 2461332.5,
      "light_time": 0.005753641725656441,
      "range_rate": -0.0002863822685707341,
      "time_iso": "2026-10-19T00:00:00Z",
      "time_tdb": "2026-Oct-19 00:00:00.0000",
      "vx": -0.007624353454157118,
      "vy": 0.01549229503382759,
      "vz": -1.45245444532166e-06,
      "x": 0.9010052432373891,
      "y": 0.4250038406545623,
      "z": -3.000324072405501e-05
    }
  ]
}

Get sky position

Find where the Sun, a planet, a moon, a spacecraft, an asteroid or a comet appears in the sky at a moment or over a span of time: right ascension and declination, brightness, distance, constellation and, for a place on Earth, its direction and height above the horizon. From JPL's Horizons system.

Inputs

BodytargettextRequired
Pick the Sun, a planet, a moon or a spacecraft, or type any asteroid, comet or body Horizons knows: Apophis, 2024 YR4, C/2023 A3, or an id such as 499.
Fromstartdate and time
The first moment (UTC). Leave 'Until' blank for this one moment. Blank means now.
Untilstopdate and time
The last moment (UTC), for a table over a span of time.
Everystep_sizenumber
The gap between rows, with 'Step unit'. Defaults to 1. At most 500 rows.From 1 to 100000.
Step unitstep_unittext
Minutes, hours or days. Defaults to days.One of: m (Minutes), h (Hours), d (Days).
Latitudelatitudenumber
Your latitude, -90 to 90. Leave blank to see from Earth's center.From -90 to 90.
Longitudelongitudenumber
Your longitude, -180 to 180 (east is positive).From -180 to 180.
Elevation (m)elevation_mnumber
Your height above sea level in metres.From -500 to 10000.

Outputs

countnumber
How many are in this result
observertext
Where it is seen from
positionslist
One row per moment
summarytext
One line describing the result
targettext
The body, as Horizons names it
target_idtext
The body's Horizons id
Example output
{
  "count": 1,
  "observer": "38.89, -77.03",
  "positions": [
    {
      "azimuth_deg": 355.258366,
      "constellation": "Cancer",
      "constellation_code": "Cnc",
      "dec_deg": 18.63198,
      "declination": "+18\u00b0 37\u2032 55.1\u2033",
      "distance_au": 1.53492737091502,
      "distance_km": 229621866,
      "elevation_deg": -32.445419,
      "illuminated_percent": 89.78624,
      "magnitude": 0.986,
      "nuclear_magnitude": null,
      "ra_deg": 134.29506,
      "range_rate_km_s": -13.1911125,
      "right_ascension": "08h 57m 10.81s",
      "sky": "morning sky",
      "solar_elongation_deg": 73.8057,
      "sun": "night",
      "surface_brightness": 4.533,
      "time": "2026-Oct-19 00:00",
      "time_iso": "2026-10-19T00:00:00Z"
    }
  ],
  "summary": "Mars at 2026-10-19 00:00 UTC: RA 08h 57m 10.81s, Dec +18\u00b0 37\u2032 55.1\u2033, 32.4\u00b0 below the horizon, magnitude 0.986, in Cancer.",
  "target": "Mars",
  "target_id": "499"
}

List asteroid moons

List the known moons of asteroids and comets, or of one of them, with each moon's name, discovery year, orbit and size where known.

Inputs

Asteroid or cometdesignationtext
Only the moons of this one, such as 22 (Kalliope) or 65803 (Didymos).
Object typeobject_typetext
Only moons of asteroids, numbered or unnumbered asteroids, or comets.One of: a (Asteroids), an (Numbered asteroids), au (Unnumbered asteroids), c (Comets).
Confirmedconfirmedtext
Only confirmed or only unconfirmed moons. Leave blank with one asteroid.One of: Y (Confirmed only), N (Unconfirmed only).
Maximum resultslimitnumber
How many to return, 1 to 1000.From 1 to 1000.

Outputs

countnumber
How many are in this result
moonslist
The moons
summarytext
One line describing the result
totalnumber
How many match in all, before the limit
Example output
{
  "count": 1,
  "moons": [
    {
      "confirmed": true,
      "density_g_cm3": null,
      "diameter_km": null,
      "discovery_year": 2001,
      "iau_name": "Linus",
      "name": "(22) Kalliope I Linus",
      "notes": null,
      "orbit": {
        "eccentricity": null,
        "inclination_deg": 93.4,
        "period_hours": 86.296,
        "reference": "Margot and Brown (2003), Science 300",
        "semi_major_axis_km": 1063.0
      },
      "primary_designation": "22",
      "primary_name": "22 Kalliope (A852 WA)",
      "primary_orbit_class": "Main-belt Asteroid",
      "reference": "Merline and Menard (2001), IAUC 7703",
      "rotation_period_hours": null
    }
  ],
  "summary": "1 moon of 1 asteroid or comet (showing 1); first: (22) Kalliope I Linus.",
  "total": 1
}

List close approaches

List asteroids and comets passing close to Earth (or another planet or the Moon) in a date range, with how close they come in lunar distances and kilometres, their speed and their likely size. Leave the dates blank for the next 60 days.

Inputs

Fromfrom_datedate
The first day to include. Defaults to today.
Untilto_datedate
The last day to include. Defaults to 60 days after 'From'.
Closer than (lunar distances)max_distance_ldnumber
Only approaches nearer than this many lunar distances (1 is the Moon's distance, about 384,400 km). Defaults to about 19.5.From 0.001 to 20000.
Passingbodytext
The planet or moon they pass. Defaults to Earth.One of: Earth, Moon, Merc (Mercury), Venus, Mars, Juptr (Jupiter), Satrn (Saturn), Urnus (Uranus), Neptn (Neptune), Pluto, ALL (Any planet or the Moon).
Objectsgrouptext
Which objects to include. Defaults to near-Earth objects.One of: neo (Near-Earth objects), pha (Potentially hazardous asteroids), nea (Near-Earth asteroids), comet (Comets), all (Any asteroid or comet).
Only this objectdesignationtext
A number or designation, such as 99942 or 2000 SG344.
Brightest magnitude (H)max_absolute_magnitudenumber
Only objects with an absolute magnitude H at most this; lower H is bigger (H 22 is roughly 140 m or more).From -5 to 40.
Ordersorttext
Defaults to soonest first.One of: date (Soonest first), -date (Latest first), dist (Closest first), h (Largest first), -v-rel (Fastest first).
Maximum resultslimitnumber
How many to return, 1 to 1000.From 1 to 1000.

Outputs

close_approacheslist
The close approaches
countnumber
How many are in this result
summarytext
One line describing the result
totalnumber
How many match in all, before the limit
Example output
{
  "close_approaches": [
    {
      "absolute_magnitude": 27.177,
      "approach_time": "2026-Oct-12 15:25",
      "approach_time_iso": "2026-10-12T15:25:00Z",
      "body": "Earth",
      "designation": "2026 TN77",
      "diameter_km": null,
      "distance_au": 0.00037043,
      "distance_km": 55416,
      "distance_ld": 0.144,
      "estimated_diameter_max_m": 21.8,
      "estimated_diameter_min_m": 9.8,
      "julian_date": 2461326.142275298,
      "max_distance_ld": 0.145,
      "min_distance_ld": 0.144,
      "name": "(2026 TN77)",
      "orbit_id": "3",
      "relative_velocity_km_s": 15.302,
      "sbdb_url": "https://ssd.jpl.nasa.gov/tools/sbdb_lookup.html#/?sstr=2026%20TN77",
      "summary": "2026 TN77 comes within 0.144 lunar distances (55,416 km) of Earth on 2026-Oct-12 15:25 TDB at 15.302 km/s, about 9.8-21.8 m across",
      "time_uncertainty": "00:04",
      "velocity_infinity_km_s": 14.824
    }
  ],
  "count": 1,
  "summary": "1 close approach match (showing all). Closest: 2026 TN77 at 0.144 lunar distances on 2026-Oct-12 15:25.",
  "total": 1
}

List fireballs

List fireballs (exceptionally bright meteors) detected by US Government sensors: when and where each one exploded, how high, how fast, and its energy in kilotons of TNT. Newest first.

Inputs

Fromfrom_datedate
Only fireballs on or after this day.
Untilto_datedate
Only fireballs on or before this day.
At least (kilotons)min_impact_energy_ktnumber
Only fireballs with at least this impact energy, in kilotons of TNT.At least 0.
Only with a locationrequire_locationtrue/false
Skip fireballs reported without a latitude and longitude.
Only with an altituderequire_altitudetrue/false
Skip fireballs reported without a height.
Ordersorttext
Defaults to newest first.One of: -date (Newest first), date (Oldest first), -impact-e (Most energetic first), -vel (Fastest first), -alt (Highest first).
Maximum resultslimitnumber
How many to return, 1 to 1000. Defaults to 20.From 1 to 1000.

Outputs

countnumber
How many are in this result
fireballslist
The fireballs
summarytext
One line describing the result
Example output
{
  "count": 1,
  "fireballs": [
    {
      "altitude_km": 26.9,
      "date": "2026-10-04 03:14:45",
      "date_iso": "2026-10-04T03:14:45Z",
      "impact_energy_kt": 0.18,
      "latitude": -41.8,
      "location": "41.8\u00b0S, 173.1\u00b0W",
      "longitude": -173.1,
      "radiated_energy_joules": 54000000000.0,
      "summary": "Fireball on 2026-10-04 03:14:45 UTC over 41.8\u00b0S, 173.1\u00b0W, about 0.18 kt of TNT, 26.9 km up, 13.8 km/s",
      "velocity_km_s": 13.8,
      "velocity_x_km_s": 14.8,
      "velocity_y_km_s": 2.9,
      "velocity_z_km_s": 2.2
    }
  ],
  "summary": "1 fireball; the most recent was on 2026-10-04 03:14:45 UTC."
}

List human-accessible asteroids

List near-Earth asteroids a crewed round trip could reach within your mission limits (fuel, length, stay, launch years), from NASA's NHATS study: the cheapest and the shortest trip to each, its size, and when it can next be observed.

Inputs

Most delta-vmax_delta_vtext
The most total delta-v (fuel) a round trip may need. Defaults to 12 km/s.One of: 4 (4 km/s), 5 (5 km/s), 6 (6 km/s), 7 (7 km/s), 8 (8 km/s), 9 (9 km/s), 10 (10 km/s), 11 (11 km/s), 12 (12 km/s).
Longest missionmax_duration_daystext
The longest a round trip may take. Defaults to 450 days.One of: 60 (60 days), 90 (90 days), 120 (120 days), 150 (150 days), 180 (180 days), 210 (210 days), 240 (240 days), 270 (270 days), 300 (300 days), 330 (330 days), and 4 more.
Shortest staymin_stay_daystext
The least time to spend at the asteroid. Defaults to 8 days.One of: 8 (8 days), 16 (16 days), 24 (24 days), 32 (32 days).
Launch yearslaunch_windowtext
When the mission launches. Defaults to 2020 to 2045.One of: 2020-2045 (2020 to 2045), 2020-2025 (2020 to 2025), 2025-2030 (2025 to 2030), 2030-2035 (2030 to 2035), 2035-2040 (2035 to 2040), 2040-2045 (2040 to 2045).
Brightest magnitude (H)max_absolute_magnitudetext
Only asteroids with H at most this (lower H is bigger).One of: 16 (H 16), 17 (H 17), 18 (H 18), 19 (H 19), 20 (H 20), 21 (H 21), 22 (H 22), 23 (H 23), 24 (H 24), 25 (H 25), and 5 more.
Orbit uncertainty at mostmax_orbit_condition_codetext
Only asteroids whose orbit is known at least this well (0 is best).One of: 0, 1, 2, 3, 4, 5, 6, 7, 8.
Ordersorttext
Defaults to lowest delta-v first.One of: delta_v (Lowest delta-v first), duration (Shortest mission first), trajectories (Most mission options first), size (Largest first).
Maximum resultslimitnumber
How many to return, 1 to 5000. Defaults to 50.From 1 to 5000.

Outputs

asteroidslist
The accessible asteroids
countnumber
How many are in this result
summarytext
One line describing the result
totalnumber
How many match in all, before the limit
Example output
{
  "asteroids": [
    {
      "absolute_magnitude": 24.7,
      "designation": "2000 SG344",
      "diameter_m": null,
      "max_diameter_m": 89.0,
      "min_delta_v_duration_days": 370,
      "min_delta_v_km_s": 3.549,
      "min_diameter_m": 20.0,
      "min_duration_days": 34,
      "min_duration_delta_v_km_s": 11.402,
      "name": "(2000 SG344)",
      "next_optical_magnitude": 19.11,
      "next_optical_window_end": "2028-09-11",
      "next_optical_window_start": "2028-04-28",
      "next_radar_date_goldstone": "2028-05-07",
      "orbit_condition_code": 3,
      "sbdb_url": "https://ssd.jpl.nasa.gov/tools/sbdb_lookup.html#/?sstr=2000%20SG344",
      "summary": "2000 SG344: round trip from 3.549 km/s delta-v (370 days), shortest 34 days; 20-89 m across",
      "viable_trajectories": 3302685
    }
  ],
  "count": 1,
  "summary": "622 accessible asteroids (showing 1); first: 2000 SG344: round trip from 3.549 km/s delta-v (370 days), shortest 34 days; 20-89 m across.",
  "total": 622
}

List impact risks

List the asteroids on NASA's Sentry risk list: objects with a possible (usually tiny) chance of hitting Earth in the next century or more, with their odds, hazard ratings, impact years and size. Highest hazard first.

Inputs

Palermo scale at leastmin_palermo_scalenumber
Only objects rated at least this on the Palermo hazard scale, -20 to 20 (below -2 is no concern; above 0 merits attention).From -20 to 20.
Impact probability at leastmin_impact_probabilitynumber
Only objects at least this likely to hit, e.g. 0.0001 for 1 in 10,000.From 1e-10 to 1.
Brightest magnitude (H)max_absolute_magnitudenumber
Only objects with H at most this; lower H is bigger.From -10 to 100.
Observed in the last (days)observed_within_daysnumber
Only objects observed in the last this many days (more than 6). A negative number means not observed for that long.
Ordersorttext
Defaults to highest hazard first.One of: palermo (Highest hazard (Palermo scale) first), probability (Most likely impact first), year (Soonest possible impact first), size (Largest first), observed (Most recently observed first).
Maximum resultslimitnumber
How many to return, 1 to 5000. Defaults to 50.From 1 to 5000.

Outputs

countnumber
How many are in this result
objectslist
The objects on the risk list
summarytext
One line describing the result
totalnumber
How many match in all, before the limit
Example output
{
  "count": 1,
  "objects": [
    {
      "absolute_magnitude": 20.63,
      "designation": "101955",
      "diameter_km": 0.49,
      "first_year": 2178,
      "impact_probability": 0.0005717,
      "last_observed": "2020-10-3.80160",
      "last_year": 2290,
      "name": "101955 Bennu (1999 RQ36)",
      "palermo_scale_cumulative": -1.4,
      "palermo_scale_max": -1.58,
      "potential_impacts": 157,
      "sbdb_url": "https://ssd.jpl.nasa.gov/tools/sbdb_lookup.html#/?sstr=101955",
      "summary": "101955 Bennu (1999 RQ36): 1 in 1,749 of hitting Earth (157 possible impacts, 2178-2290), Palermo scale -1.4",
      "torino_scale_max": null,
      "velocity_infinity_km_s": 5.992,
      "years": "2178-2290"
    }
  ],
  "summary": "2,222 objects on the risk list match (showing 1); top: 101955 Bennu (1999 RQ36): 1 in 1,749 of hitting Earth (157 possible impacts, 2178-2290), Palermo scale -1.4.",
  "total": 2222
}

List newly discovered objects

List objects discovered in the last few days that are waiting for confirmation, as JPL's Scout system rates them: how likely each is a near-Earth object, how close it may come, its impact rating and where it is in the sky.

Inputs

NEO likelihood at leastmin_neo_scorenumber
Only objects at least this likely (0-100) to be near-Earth objects.From 0 to 100.
Ordersorttext
Defaults to most recently updated first.One of: updated (Most recently updated first), neo_score (Most likely near-Earth object first), rating (Highest impact rating first), closest (Closest approach first), brightest (Brightest first).
Maximum resultslimitnumber
How many to return, 1 to 500. Defaults to 100.From 1 to 500.

Outputs

countnumber
How many are in this result
objectslist
The new objects
summarytext
One line describing the result
totalnumber
How many match in all, before the limit
Example output
{
  "count": 1,
  "objects": [
    {
      "absolute_magnitude": 23.4,
      "arc_hours": 0.5,
      "close_approach_ld": 12.0,
      "comet_score": 35,
      "declination": "+18",
      "earth_moid_au": 0.08,
      "ephemeris_time": "2026-10-20 00:00",
      "fit_rms": 0.14,
      "geocentric_score": 0,
      "impact_rating": 0,
      "impact_rating_label": "negligible",
      "interior_earth_score": 0,
      "last_run": "2026-10-19 22:12",
      "magnitude": 21.0,
      "motion_arcsec_per_min": 6.3,
      "neo_1km_score": 0,
      "neo_score": 94,
      "observations": 3,
      "pha_score": 1,
      "right_ascension": "03:24",
      "solar_elongation_deg": 153.0,
      "summary": "P22rrse: 94% likely a near-Earth object, may pass within 12 lunar distances, impact rating negligible",
      "temporary_designation": "P22rrse",
      "uncertainty_arcmin": 4.2,
      "uncertainty_tomorrow_arcmin": 34.0,
      "velocity_infinity_km_s": null
    }
  ],
  "summary": "55 new objects awaiting confirmation (showing 1); first: P22rrse: 94% likely a near-Earth object, may pass within 12 lunar distances, impact rating negligible.",
  "total": 55
}

List objects removed from the risk list

List the asteroids Sentry took off its risk list because new observations ruled out every impact, most recently removed first.

Inputs

Removed sincesincedate
Only objects removed on or after this day.
Maximum resultslimitnumber
How many to return, 1 to 5000. Defaults to 50.From 1 to 5000.

Outputs

countnumber
How many are in this result
objectslist
The removed objects
summarytext
One line describing the result
totalnumber
How many match in all, before the limit
Example output
{
  "count": 1,
  "objects": [
    {
      "designation": "2026 TM6",
      "removed_at": "2026-10-19 14:52:36",
      "removed_at_iso": "2026-10-19T14:52:36Z"
    }
  ],
  "summary": "13 objects removed since 2026-10-01 (showing 1); latest: 2026 TM6 on 2026-10-19 14:52:36 UTC.",
  "total": 13
}

List radar observations

List radar measurements of asteroids and comets (distance by echo delay, speed by Doppler shift) from stations such as Goldstone and Arecibo, newest first.

Inputs

Only this objectdesignationtext
A number or designation, such as 433 or 2004 VB.
Object typeobject_typetext
Only asteroids, numbered or unnumbered asteroids, or comets.One of: a (Asteroids), an (Numbered asteroids), au (Unnumbered asteroids), c (Comets).
Measurementmeasurement_typetext
Only delay (distance) or only Doppler (speed) measurements.One of: R (Delay (distance)), P (Doppler (speed)).
Maximum resultslimitnumber
How many to return, 1 to 5000. Defaults to 100.From 1 to 5000.

Outputs

countnumber
How many are in this result
observationslist
The measurements, newest first
summarytext
One line describing the result
totalnumber
How many match in all, before the limit
Example output
{
  "count": 1,
  "observations": [
    {
      "bounce_point": "center of mass",
      "designation": "433",
      "epoch": "2019-01-08 10:50:00",
      "epoch_iso": "2019-01-08T10:50:00Z",
      "frequency_mhz": 8560.0,
      "measurement": "delay",
      "name": "433 Eros (A898 PA)",
      "notes": "GSSR, delay correction based on 20 and 25 usec bauds and 15 length code.",
      "observers": "M. Brozovic,S. P. Naidu,L. A. M. Benner",
      "receiver": "DSS-14 (70-m)",
      "receiver_code": "-14",
      "sigma": 20.0,
      "transmitter": "DSS-14 (70-m)",
      "transmitter_code": "-14",
      "units": "us",
      "value": 210312110.7
    }
  ],
  "summary": "6 radar measurements of 1 object (showing 1); latest: 433 on 2019-01-08 10:50:00 UTC.",
  "total": 6
}

List spacecraft mission targets

List the asteroids and comets a robotic spacecraft could reach most easily for launches in the years you choose, with the best launch and arrival dates, flight time and fuel (delta-v) for each.

Inputs

First launch yearfirst_launch_yearnumber
Defaults to this year.From 1950 to 2100.
Last launch yearlast_launch_yearnumber
Defaults to four years after the first. At most 21 years in all.From 1950 to 2100.
Best meanscriteriontext
How missions are ranked. Defaults to lowest launch energy.One of: 1 (Lowest launch energy (departure V-infinity)), 2 (Slowest arrival (arrival V-infinity)), 3 (Lowest total delta-v), 4 (Shortest flight, then lowest launch energy), 5 (Shortest flight, then slowest arrival), 6 (Shortest flight, then lowest total delta-v).
Groupgrouptext
Only near-Earth objects, or only potentially hazardous asteroids.One of: neo (Near-Earth objects), pha (Potentially hazardous asteroids).
Orbit classesorbit_classeslist
Only these orbit classes.One or more of: IEO (Atira (inside Earth's orbit)), ATE (Aten), APO (Apollo), AMO (Amor), MCA (Mars-crossing asteroid), IMB (Inner main-belt asteroid), MBA (Main-belt asteroid), OMB (Outer main-belt asteroid), TJN (Jupiter Trojan), AST (Other asteroid), and 12 more.
Maximum resultslimitnumber
How many to return, 1 to 1000. Defaults to 50.From 1 to 1000.

Outputs

countnumber
How many are in this result
launch_yearstext
The launch years searched, e.g. 2027-2029
summarytext
One line describing the result
targetslist
The targets, best first
Example output
{
  "count": 1,
  "launch_years": "2027-2029",
  "summary": "1 target for launches in 2027-2029; best: 292220 (2006 SU49), launch 2027-04-05, arrive 2029-01-24 (5.064 km/s total delta-v).",
  "targets": [
    {
      "absolute_magnitude": 19.39,
      "arrival_date": "2029-01-24",
      "arrival_v_infinity_km_s": 5.061,
      "condition_code": 0,
      "departure_date": "2027-04-05",
      "departure_v_infinity_km_s": 0.003,
      "designation": "292220",
      "flight_time_days": 660,
      "is_binary": false,
      "is_neo": true,
      "is_pha": true,
      "launch_energy_c3_km2_s2": 9e-06,
      "name": "292220 (2006 SU49)",
      "orbit_class": "APO",
      "sbdb_url": "https://ssd.jpl.nasa.gov/tools/sbdb_lookup.html#/?sstr=292220",
      "total_delta_v_km_s": 5.064
    }
  ]
}

List three-body periodic orbits

List periodic orbits of one family in a three-body system, such as halo orbits around the Earth-Moon L1 point, from JPL's catalog: starting position and velocity, period in days, and stability.

Inputs

SystemsystemtextRequired
The two bodies, such as Earth-Moon.One of: earth-moon, sun-earth, sun-mars, mars-phobos, jupiter-europa, saturn-enceladus, saturn-titan.
Orbit familyfamilytextRequired
The kind of orbit. The labels say which also need a libration point or branch.One of: halo (Halo (L1, L2 or L3; north or south branch)), lyapunov (Lyapunov (L1, L2 or L3)), vertical (Vertical (any libration point)), axial (Axial (any libration point)), longp (Long-period (L4 or L5)), short (Short-period (L4 or L5)), dro (Distant retrograde (DRO)), dpo (Distant prograde (DPO)), lpo (Low prograde (LPO; east or west branch)), butterfly (Butterfly (north or south branch)), dragonfly (Dragonfly (north or south branch)), resonant (Resonant (branch such as 21 for 2:1)).
Libration pointlibration_pointtext
Required for halo, Lyapunov, vertical, axial, long- and short-period orbits.One of: 1 (L1), 2 (L2), 3 (L3), 4 (L4), 5 (L5).
Branchbranchtext
N or S for halo, butterfly and dragonfly; E or W for low prograde; digits such as 21 (2:1) for resonant orbits.
Shortest period (days)min_period_daysnumber
Only orbits with at least this period.At least 0.
Longest period (days)max_period_daysnumber
Only orbits with at most this period.At least 0.
Stable onlystable_onlytrue/false
Only stable orbits (stability index 1 or less).
Maximum resultslimitnumber
How many to return, 1 to 1000. Defaults to 20.From 1 to 1000.

Outputs

branchtext
The branch, if any
countnumber
How many are in this result
familytext
The orbit family
length_unit_kmnumber
The normalised length unit in km (the distance between the bodies)
libration_pointtext
The libration point, if any
mass_rationumber
Mass of the smaller body over the total
orbitslist
The orbits
summarytext
One line describing the result
systemtext
The system, e.g. Earth-Moon
time_unit_secondsnumber
The normalised time unit in seconds
totalnumber
How many match in all, before the limit
Example output
{
  "branch": "N",
  "count": 1,
  "family": "halo",
  "length_unit_km": 389703.264829278,
  "libration_point": "1",
  "mass_ratio": 0.01215058560962404,
  "orbits": [
    {
      "jacobi_constant": 0.195162730858155,
      "period": 3.123314392276159,
      "period_days": 13.8446,
      "stability_index": 243.405726813375,
      "stable": false,
      "vx": 0.0,
      "vy": 1.4076145460136695,
      "vz": 0.0,
      "x": -0.4145618480314011,
      "x_km": -161556.1,
      "y": 0.0,
      "z": 0.9075312043329506,
      "z_km": 353667.9
    }
  ],
  "summary": "5731 halo orbits in the Earth-Moon system (showing 1); first has a 13.8446-day period.",
  "system": "Earth-Moon",
  "time_unit_seconds": 382981.289129055,
  "total": 5731
}

Search asteroids and comets

Find every asteroid or comet in JPL's Small-Body Database that matches your filters (kind, near-Earth or hazardous, orbit class, moons, and constraints such as 'diameter > 100'), returning the fields you choose.

Inputs

Fieldsfieldslist
The fields to return for each object. Defaults to name, class, size and orbit basics.One or more of: spkid (SPK-ID), full_name (Full name), pdes (Primary designation), name (IAU name), prefix (Comet prefix), kind (Kind (an, au, cn, cu)), class (Orbit class), neo (Near-Earth object), pha (Potentially hazardous), H (Absolute magnitude (H)), and 35 more.
Object typeobject_typetext
Asteroids or comets. Leave blank for both.One of: a (Asteroids), c (Comets).
Numberednumberedtext
Only numbered (well-observed) or only unnumbered objects.One of: n (Numbered only), u (Unnumbered only).
Groupgrouptext
Only near-Earth objects, or only potentially hazardous asteroids.One of: neo (Near-Earth objects), pha (Potentially hazardous asteroids).
Orbit classesorbit_classeslist
Only these orbit classes.One or more of: IEO (Atira (inside Earth's orbit)), ATE (Aten), APO (Apollo), AMO (Amor), MCA (Mars-crossing asteroid), IMB (Inner main-belt asteroid), MBA (Main-belt asteroid), OMB (Outer main-belt asteroid), TJN (Jupiter Trojan), AST (Other asteroid), and 12 more.
Only with moonshas_satellitestrue/false
Only objects with at least one known moon.
Leave out comet fragmentsexclude_fragmentstrue/false
Skip fragments of broken-up comets.
Constraintsconstraintstext
One per line, all of which must hold, e.g. 'diameter > 100', 'i between 5 and 10', 'albedo defined', 'spec_B matches ^C'. Fields include H, diameter, albedo, rot_per, a, e, i, q, moid.
Sort bysorttext
Up to three field names, with - for descending, e.g. -diameter or H.
Maximum resultslimitnumber
How many to return, 1 to 1000. Defaults to 50.From 1 to 1000.
Skipoffsetnumber
How many matches to skip, to page through a long list.At least 0.

Outputs

bodieslist
The matching objects, keyed by the fields asked for (the default fields shown)
countnumber
How many are in this result
fieldslist
The fields each object carries
summarytext
One line describing the result
totalnumber
How many match in all, before the limit
Example output
{
  "bodies": [
    {
      "H": 3.34,
      "a": 2.766,
      "albedo": 0.09,
      "class": "MBA",
      "diameter": 939.4,
      "e": 0.0797,
      "full_name": "1 Ceres (A801 AA)",
      "i": 10.59,
      "moid_ld": 615.0,
      "name": "Ceres",
      "neo": false,
      "pdes": "1",
      "pha": false
    }
  ],
  "count": 1,
  "fields": [
    "full_name",
    "pdes",
    "name",
    "class",
    "neo",
    "pha",
    "H",
    "diameter",
    "albedo",
    "a",
    "e",
    "i",
    "moid_ld"
  ],
  "summary": "9 asteroids and comets match (showing 1); first: 1 Ceres (A801 AA).",
  "total": 9
}

On this page