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

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 字符

最小调用

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
• company.detail
• company.sectors.list
• sector.detail

机器可读契约

• 完整能力清单
• 在线能力详情