> For the complete documentation index, see [llms.txt](https://doc.duaer.com/zh/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://doc.duaer.com/zh/getting-started/close-approaches.md).

# 在 Duaer 里查小行星近地掠过

在 Duaer 里：NASA JPL 提供的即将发生的小行星与彗星近地掠过事件，含日期、以月地距离计的距离、相对速度与尺寸。一次成功查询用 1 额度。
## 能拿到什么

Duaer 数据市场里的「小行星近地掠过」：NASA JPL 提供的即将发生的小行星与彗星近地掠过事件，含日期、以月地距离计的距离、相对速度与尺寸。查到结果时用 1 额度，结果交给数字组织的下一个节点。

从节点创建器选 Duaer 数据 → 小行星近地掠过，或打开 [数据市场](/zh/getting-started/data-market.md)。相关：[小行星与彗星（JPL）](/zh/getting-started/small-bodies.md)、[空间天气预警](/zh/getting-started/space-weather.md)。

## 适合做什么

- 列出未来两个月掠过地球的小行星。
- 筛选距离小于几倍月地距离的近地天体。

## 在画布里检索

1. 打开节点创建器，选 Duaer 数据 → Asteroid close approaches。
2. 填 Days Ahead（如 60）；Max Lunar Distances 可选。
3. Limit 默认 10，最大 20。执行。

查到结果才扣 1 额度；没有结果、输入有误或上游失败都不扣。

## 用 API 调用

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

下方是与数据市场「复制技能」相同的英文技能，含参数、示例与返回字段。

## 调用技能（英文）

与数据市场「复制技能」一致。

```
---
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

### Duaer 的小行星近地掠过检索扣多少额度？

查到结果时扣 1 额度；没有结果或出错不扣。

### Duaer 小行星近地掠过的距离单位是什么？

Duaer 小行星近地掠过同时给出天文单位与月地距离；Max Lunar Distances 按月地距离过滤。

## 相关

- [在 Duaer 里查小行星与彗星（JPL）](https://doc.duaer.com/zh/getting-started/small-bodies.md)
- [在 Duaer 里查空间天气预警](https://doc.duaer.com/zh/getting-started/space-weather.md)