Duaer

Get started

Asteroid close approaches in Duaer

In Duaer: Upcoming asteroid and comet close approaches to Earth from NASA JPL, with date, distance in lunar distances, speed, and size. One successful search uses 1 credit.

What you get

Duaer Asteroid close approaches lists objects that will pass near Earth, soonest first, from the NASA JPL close-approach data.

Pick Duaer Data → Asteroid close approaches in the node creator, or open the data market. Related: Asteroids and comets (JPL), Space weather alerts.

When to use it

  • See which asteroids pass within ten lunar distances this month.
  • Report the closest upcoming flyby.

When not to use it

Search on the canvas

  1. Open the node creator and pick Duaer Data → Asteroid close approaches.
  2. Fill Days Ahead (such as 60). Optional: Max Lunar Distances.
  3. Limit defaults to 10, max 20. Execute.

A search uses 1 credit only when it returns rows. No rows, wrong input, or an upstream failure uses 0.

Call the API

  • GET https://api.duaer.com/v1/data/close-approaches?days=60&lunarDistances=10
  • Authorization: Bearer <Duaer key>

The call skill below matches Copy skill in the Duaer data market, with parameters, examples, and result fields.

Call skill

Same text as Copy skill.

---
name: duaer-close-approaches
description: >-
  Duaer Asteroid close approaches. Upcoming asteroid and comet close approaches to Earth from NASA JPL, with date, distance in lunar distances, speed, and size.
  One successful search uses 1 Duaer credit.
---

# Duaer Asteroid close approaches

Duaer Asteroid close approaches lists objects that will pass near Earth, soonest first, from the NASA JPL close-approach data.

## When to use

- See which asteroids pass within ten lunar distances this month.
- Report the closest upcoming flyby.

## When not to use

- Orbit and size of one object. Use https://skills.duaer.com/small-bodies.md.
- Space weather. Use https://skills.duaer.com/space-weather.md.

## Call

`GET https://api.duaer.com/v1/data/close-approaches?days=60&lunarDistances=10`

Header: `Authorization: Bearer <Duaer key>`

Use an account key or a model API key.

Get a Duaer key: https://skills.duaer.com/keys.md

## Parameters

Provide `days` or `lunarDistances`.

- `days` — Optional. From now through this many days, 1 to 365. Default 60.
- `lunarDistances` — Optional. Only approaches within this many Moon distances, 0.1 to 100. Default 10.
- `limit` — Optional. Rows to return, from 1 to 20. Default 10.

## Examples

- `GET https://api.duaer.com/v1/data/close-approaches?days=60&lunarDistances=10` — flybys within ten lunar distances in 60 days.
- `GET https://api.duaer.com/v1/data/close-approaches?days=365&lunarDistances=1` — objects passing closer than the Moon this year.

## Result

The response is `{ "items": [...] }`. Each item has `source`, `title`, `url`, and `summary`, plus:

- `designation`, `fullName` — object.
- `closeApproachUtc` — time of closest approach.
- `distanceAu`, `distanceKm`, `distanceLunar` — nominal distance.
- `relativeSpeedKms`, `absoluteMagnitude`, `diameterKm` — speed, brightness, and size when known.

Fields without a value are left out.

## Credits

A search that returns at least one row uses 1 credit.
An empty search, a search that finds nothing, or a failed search uses 0.
Wrong input returns 400 with a message and uses 0.
No remaining credits returns 402 and does not search.
A missing key returns 401.

## Related

- https://skills.duaer.com/small-bodies.md — Duaer Asteroids and comets (JPL)
- https://skills.duaer.com/space-weather.md — Duaer Space weather alerts

Questions

How many credits does a Asteroid close approaches search use in Duaer?

One credit when Duaer returns rows. A search with no rows or an error uses 0.

Which distance unit does Duaer Asteroid close approaches use?

Duaer Asteroid close approaches gives both astronomical units and lunar distances. Max Lunar Distances filters in lunar distances.

In this section

Get started

Asteroids and comets (JPL) in Duaer

In Duaer: One asteroid or comet from the NASA JPL Small-Body Database: orbit, size, rotation, albedo, and near-Earth and hazard flags. One successful search uses 1 credit.

Get started

Space weather alerts in Duaer

In Duaer: Alerts, watches, and warnings from the NOAA Space Weather Prediction Center: geomagnetic storms, solar radiation, and radio blackouts. One successful search uses 1 credit.