> 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/exoplanets.md).

# 在 Duaer 里查系外行星

在 Duaer 里：按行星或恒星名称、发现方法或年份检索 NASA 系外行星档案中的已确认行星，含半径、质量、轨道周期与距离。一次成功查询用 1 额度。
## 能拿到什么

Duaer 数据市场里的「系外行星」：按行星或恒星名称、发现方法或年份检索 NASA 系外行星档案中的已确认行星，含半径、质量、轨道周期与距离。查到结果时用 1 额度，结果交给数字组织的下一个节点。

从节点创建器选 Duaer 数据 → 系外行星，或打开 [数据市场](/zh/getting-started/data-market.md)。相关：[小行星与彗星（JPL）](/zh/getting-started/small-bodies.md)、[全球地磁 Kp 指数](/zh/getting-started/kp-index.md)。

## 适合做什么

- 查某恒星系统的已确认行星及其半径与轨道周期。
- 列出近年用凌星法发现的新行星。

## 在画布里检索

1. 打开节点创建器，选 Duaer 数据 → Exoplanets。
2. 填 Planet or Star（如 TRAPPIST）；Discovery Method（如 Transit）、Discovered Since 可选。
3. Limit 默认 10，最大 20。执行。

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

## 用 API 调用

- GET https://api.duaer.com/v1/data/exoplanets?words=TRAPPIST
- Authorization: Bearer <Duaer key>

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

## 调用技能（英文）

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

```
---
name: duaer-exoplanets
description: >-
  Duaer Exoplanets. Confirmed exoplanets from the NASA Exoplanet Archive by planet or star name, discovery method, or year, with size, mass, orbit, and distance.
  One successful search uses 1 Duaer credit.
---

# Duaer Exoplanets

Duaer Exoplanets searches the NASA Exoplanet Archive composite table of confirmed planets, newest discoveries first.

## When to use

- List planets in a system such as TRAPPIST-1.
- Find planets found by direct imaging since 2024.

## When not to use

- Asteroids and comets. Use https://skills.duaer.com/small-bodies.md.
- Papers about a planet. Use https://skills.duaer.com/inspire-hep.md.

## Call

`GET https://api.duaer.com/v1/data/exoplanets?words=TRAPPIST`

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 `words`, `method`, or `since`.

- `words` — Part of a planet or host star name, such as TRAPPIST or Kepler-452.
- `method` — Optional. Transit, Radial Velocity, Microlensing, Imaging, Astrometry, and other archive methods.
- `since` — Optional. Discovered in or after this year, such as 2024.
- `limit` — Optional. Rows to return, from 1 to 20. Default 10.

## Examples

- `GET https://api.duaer.com/v1/data/exoplanets?words=TRAPPIST` — the TRAPPIST-1 planets.
- `GET https://api.duaer.com/v1/data/exoplanets?method=Imaging&since=2024` — recent directly imaged planets.

## Result

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

- `planet`, `hostStar` — names.
- `discoveryYear`, `discoveryMethod`, `discoveryFacility` — discovery.
- `radiusEarth`, `massEarth`, `orbitalPeriodDays`, `equilibriumTempK` — planet properties.
- `distanceParsec` — distance to the system.

The archive can take several seconds to answer.

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/kp-index.md — Duaer Planetary Kp index

```
## Questions

### Duaer 的系外行星检索扣多少额度？

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

### Duaer 系外行星只包含已确认的行星吗？

是。Duaer 系外行星读取 NASA Exoplanet Archive 的已确认行星综合表，不含候选体。

## 相关

- [在 Duaer 里查小行星与彗星（JPL）](https://doc.duaer.com/zh/getting-started/small-bodies.md)
- [在 Duaer 里查全球地磁 Kp 指数](https://doc.duaer.com/zh/getting-started/kp-index.md)

