---
title: "查询证券生命周期当前状态"
description: "按北京时间日期查询待上市、近期上市及退出证券，并返回板块关联和权威来源。"
pageClass: gendangzou-doc
---

# 查询证券生命周期当前状态

`security.lifecycle.list`

按北京时间日期查询待上市、近期上市及退出证券，并返回板块关联和权威来源。

## 调用契约

| 项目 | 值 |
| --- | --- |
| Method | `GET` |
| Path | `/api/gendangzou/securities` |
| 业务域 | `security` |
| 数据更新 | hourly_official_exchange_and_cninfo_catalog |

受控意图：`list_prelisted_securities`、`list_new_listings`、`list_recent_delistings`、`inspect_security_lifecycle`

## 请求参数

| 参数 | 位置 | 类型 | 必填 | 约束与默认值 |
| --- | --- | --- | --- | --- |
| `date` | query | string | 否 | Lifecycle date; defaults to the current Beijing date；格式 `date` |
| `scope` | query | string | 否 | 默认 `recent_listed`；可选 `prelisted`、`recent_listed`、`departures` |
| `days` | query | integer | 否 | 默认 `30`；最小 1；最大 365 |
| `q` | query | string | 否 | 最短 1 字符；最长 100 字符 |
| `exchange` | query | string | 否 | 可选 `SSE`、`SZSE`、`BSE` |
| `board` | query | string | 否 | 可选 `MAIN`、`STAR`、`CHINEXT`、`BSE` |
| `sector_id` | query | string | 否 | 最短 2 字符；最长 128 字符 |
| `page` | query | integer | 否 | 从 1 开始的页码；默认 `1`；最小 1 |
| `page_size` | query | integer | 否 | 默认 `30`；最小 1；最大 100 |
| `snapshot_id` | query | string | 否 | 最短 8 字符；最长 128 字符 |
| `detail` | query | string | 否 | full 保留完整 Web 响应；compact 返回供 Agent 使用的稳定快照引用；默认 `full`；可选 `full`、`compact` |
| `include` | query | string | 否 | 逗号分隔的精简版本扩展：sector_dynamics、coverage；最长 80 字符 |

## 最小调用

```bash
curl --fail --silent --show-error \
  -H "Authorization: Bearer $MOBIUSQUANT_TOKEN" \
  "https://api.mobiusquant.ai/api/gendangzou/securities?page_size=10&detail=compact"
```



## 响应

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `business_date` | `string` | 是 | 本次查询使用的北京时间业务日期。 |
| `snapshot` | `SnapshotContext / SnapshotReference` | 是 | 本次查询实际使用的数据版本。 |
| `scope` | `string` | 是 | - |
| `window_days` | `integer` | 是 | - |
| `summary` | `SecurityLifecycleSummary` | 是 | 当前查询的聚合统计。 |
| `sector_impacts` | `array<SecurityLifecycleSectorImpact>` | 否 | - |
| `coverage` | `SecurityLifecycleCoverage` | 是 | 数据覆盖数量与完成度统计。 |
| `items` | `array<SecurityLifecycleItem>` | 是 | 当前查询返回的结果列表。 |
| `pagination` | `Pagination` | 是 | 分页位置、总数和总页数。 |

### `SecurityLifecycleSummary`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `prelisted` | `integer` | 是 | - |
| `recent_listed` | `integer` | 是 | - |
| `recent_departures` | `integer` | 是 | - |

### `SecurityLifecycleSectorImpact`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `sector_id` | `string` | 是 | 板块稳定标识。 |
| `sector_name` | `string` | 是 | 板块名称。 |
| `sector_layer` | `string` | 否 | 关系对应板块的层级。 |
| `event_count` | `integer` | 是 | - |
| `effective_count` | `integer` | 是 | - |
| `preview_count` | `integer` | 是 | - |
| `historical_count` | `integer` | 是 | - |
| `stock_codes` | `array<string>` | 否 | - |
| `stock_names` | `array<string>` | 否 | - |

### `SecurityLifecycleCoverage`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `last_verified_at` | `string` | 否 | - |
| `listed_exchanges` | `array<string>` | 否 | - |
| `delisted_exchanges` | `array<string>` | 否 | - |
| `prelisting_sources` | `array<string>` | 否 | - |
| `degraded_sources` | `array<string>` | 否 | - |
| `sources` | `array<SecurityLifecycleSourceHealth>` | 否 | 归并材料涉及的全部来源。 |

### `SecurityLifecycleSourceHealth`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `source_id` | `string` | 是 | 材料来源标识。 |
| `exchange` | `string` | 是 | 上市交易所。 |
| `status` | `string` | 是 | 对象或关系的当前状态。 |
| `row_count` | `integer` | 是 | - |
| `last_success_at` | `string` | 否 | - |

### `SecurityLifecycleItem`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `stock_code` | `string` | 是 | 保留前导零的六位 A 股代码。 |
| `stock_name` | `string` | 是 | 上市公司简称。 |
| `company_name` | `string` | 否 | 交易所名册记录的公司全称。 |
| `exchange` | `string` | 是 | 上市交易所。 |
| `board` | `string` | 是 | A 股上市板标识。 |
| `lifecycle_status` | `string` | 是 | 当前对象的生命周期状态。 |
| `lifecycle_stage` | `string` | 是 | 政策材料在征求意见、正式发布等生命周期中的阶段。 |
| `status_effective_date` | `string` | 是 | - |
| `planned_listing_date` | `string / null` | 否 | - |
| `listing_date` | `string / null` | 否 | - |
| `delisting_date` | `string / null` | 否 | - |
| `first_seen_at` | `string` | 是 | 系统首次发现材料的时间。 |
| `last_seen_at` | `string` | 是 | - |
| `source_id` | `string` | 是 | 材料来源标识。 |
| `source_url` | `string` | 否 | - |
| `reason` | `string` | 是 | - |
| `evidence_count` | `integer` | 否 | 支撑当前结果的可溯源证据数量。 |
| `latest_evidence` | `SecurityLifecycleEvidence / null` | 否 | - |
| `sector_count` | `integer` | 否 | 当前结果关联的板块数量。 |
| `sectors` | `array<SecurityLifecycleSector>` | 否 | 当前对象关联的板块摘要或映射结果。 |

### `SecurityLifecycleEvidence`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `evidence_id` | `string` | 是 | 可溯源证据标识。 |
| `source_id` | `string` | 是 | 材料来源标识。 |
| `evidence_type` | `string` | 是 | - |
| `effective_date` | `string` | 是 | 该序列点实际生效的日期。 |
| `title` | `string` | 是 | 原始材料标题。 |
| `source_url` | `string` | 否 | - |
| `observed_at` | `string` | 是 | - |

### `SecurityLifecycleSector`

| 字段 | 类型 | 必有 | 含义 |
| --- | --- | --- | --- |
| `relation_id` | `string` | 是 | 公司与板块关系的稳定标识，用于继续查询证据。 |
| `sector_id` | `string` | 是 | 板块稳定标识。 |
| `sector_name` | `string` | 是 | 板块名称。 |
| `sector_layer` | `string` | 否 | 关系对应板块的层级。 |
| `relation_type` | `string` | 是 | 公司与板块的业务关系或市场关系。 |
| `relation_status` | `string` | 是 | 公司板块关系在当前版本中的状态。 |
| `score` | `number` | 是 | 公司业务事实与板块定义的关系强度。 |
| `confidence` | `number` | 是 | 结果置信度；不能与关系分或热度分互换。 |
| `evidence_count` | `integer` | 否 | 支撑当前结果的可溯源证据数量。 |
| `mapping_state` | `string` | 是 | 板块映射处于预览、生效或历史状态。 |

## 调用要点

- Agent 建议使用 `detail=compact` 控制上下文体积。
- 分页从 `page_size=10` 开始，确认需要后再继续翻页。
- 需要解释结论时，再调用关联证据能力。

## 关联能力

- [`security.lifecycle.changes`](/zh/gendangzou/capabilities/security.lifecycle.changes)
- [`company.detail`](/zh/gendangzou/capabilities/company.detail)
- [`company.sectors.list`](/zh/gendangzou/capabilities/company.sectors.list)
- [`sector.detail`](/zh/gendangzou/capabilities/sector.detail)

## 机器可读契约

- [完整能力清单](/zh/gendangzou/agent-manifest.json)
- [在线能力详情](https://api.mobiusquant.ai/api/gendangzou/capabilities/security.lifecycle.list)