{"schema_version":"gendangzou-capabilities-v1","contract_version":"gendangzou-api-v2","capability":{"id":"security.lifecycle.list","domain":"security","title":"查询证券生命周期当前状态","summary":"按北京时间日期查询待上市、近期上市及退出证券，并返回板块关联和权威来源。","intents":["list_prelisted_securities","list_new_listings","list_recent_delistings","inspect_security_lifecycle"],"path":"/api/gendangzou/securities","snapshot_bound":false,"compact_supported":true,"method":"GET","detail_url":"/api/gendangzou/capabilities/security.lifecycle.list","parameters":["date","scope","days","q","exchange","board","sector_id","snapshot_id","page","page_size","detail","include"],"response_fields":["business_date","snapshot","scope","window_days","summary","sector_impacts","coverage","items","pagination"],"related_capabilities":["security.lifecycle.changes","company.detail","company.sectors.list","sector.detail"],"freshness":"hourly_official_exchange_and_cninfo_catalog","pagination":true,"documentation_url":"https://docs.mobiusquant.ai/zh/gendangzou/capabilities/security.lifecycle.list","agent_hints":{"reuse_snapshot_id_for_follow_up":false,"fetch_evidence_on_demand":true,"recommended_detail":"compact","compact_scope":"snapshot_context","recommended_page_size":10},"request":{"parameters":[{"name":"date","in":"query","required":false,"schema":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"description":"Lifecycle date; defaults to the current Beijing date"}},{"name":"scope","in":"query","required":false,"schema":{"default":"recent_listed","enum":["prelisted","recent_listed","departures"],"type":"string"}},{"name":"days","in":"query","required":false,"schema":{"default":30,"maximum":365,"minimum":1,"type":"integer"}},{"name":"q","in":"query","required":false,"schema":{"anyOf":[{"maxLength":100,"minLength":1,"type":"string"},{"type":"null"}],"default":null}},{"name":"exchange","in":"query","required":false,"schema":{"anyOf":[{"enum":["SSE","SZSE","BSE"],"type":"string"},{"type":"null"}],"default":null}},{"name":"board","in":"query","required":false,"schema":{"anyOf":[{"enum":["MAIN","STAR","CHINEXT","BSE"],"type":"string"},{"type":"null"}],"default":null}},{"name":"sector_id","in":"query","required":false,"schema":{"anyOf":[{"maxLength":128,"minLength":2,"type":"string"},{"type":"null"}],"default":null}},{"name":"page","in":"query","required":false,"schema":{"default":1,"description":"1-based page number","minimum":1,"type":"integer"}},{"name":"page_size","in":"query","required":false,"schema":{"default":30,"maximum":100,"minimum":1,"type":"integer"}},{"name":"snapshot_id","in":"query","required":false,"schema":{"anyOf":[{"maxLength":128,"minLength":8,"type":"string"},{"type":"null"}],"default":null}},{"name":"detail","in":"query","required":false,"schema":{"default":"full","description":"full preserves the complete web response; compact returns the stable snapshot reference intended for agents","enum":["full","compact"],"type":"string"}},{"name":"include","in":"query","required":false,"schema":{"anyOf":[{"maxLength":80,"type":"string"},{"type":"null"}],"default":null,"description":"Comma-separated compact snapshot expansions: sector_dynamics,coverage"}}]},"response":{"model":"SecurityLifecycleListResponse","top_level_fields":[{"name":"business_date","required":true},{"name":"snapshot","required":true},{"name":"scope","required":true},{"name":"window_days","required":true},{"name":"summary","required":true},{"name":"sector_impacts","required":false},{"name":"coverage","required":true},{"name":"items","required":true},{"name":"pagination","required":true}],"schema":{"properties":{"business_date":{"title":"Business Date","type":"string"},"snapshot":{"anyOf":[{"$ref":"#/$defs/SnapshotContext"},{"$ref":"#/$defs/SnapshotReference"}],"title":"Snapshot"},"scope":{"enum":["prelisted","recent_listed","departures"],"title":"Scope","type":"string"},"window_days":{"title":"Window Days","type":"integer"},"summary":{"$ref":"#/$defs/SecurityLifecycleSummary"},"sector_impacts":{"items":{"$ref":"#/$defs/SecurityLifecycleSectorImpact"},"title":"Sector Impacts","type":"array"},"coverage":{"$ref":"#/$defs/SecurityLifecycleCoverage"},"items":{"items":{"$ref":"#/$defs/SecurityLifecycleItem"},"title":"Items","type":"array"},"pagination":{"$ref":"#/$defs/Pagination"}},"required":["business_date","snapshot","scope","window_days","summary","coverage","items","pagination"],"title":"SecurityLifecycleListResponse","type":"object","$defs":{"SecurityLifecycleCoverage":{"properties":{"last_verified_at":{"default":"","title":"Last Verified At","type":"string"},"listed_exchanges":{"items":{"type":"string"},"title":"Listed Exchanges","type":"array"},"delisted_exchanges":{"items":{"type":"string"},"title":"Delisted Exchanges","type":"array"},"prelisting_sources":{"items":{"type":"string"},"title":"Prelisting Sources","type":"array"},"degraded_sources":{"items":{"type":"string"},"title":"Degraded Sources","type":"array"},"sources":{"items":{"$ref":"#/$defs/SecurityLifecycleSourceHealth"},"title":"Sources","type":"array"}},"title":"SecurityLifecycleCoverage","type":"object"},"SecurityLifecycleSourceHealth":{"properties":{"source_id":{"title":"Source Id","type":"string"},"exchange":{"title":"Exchange","type":"string"},"status":{"title":"Status","type":"string"},"row_count":{"title":"Row Count","type":"integer"},"last_success_at":{"default":"","title":"Last Success At","type":"string"}},"required":["source_id","exchange","status","row_count"],"title":"SecurityLifecycleSourceHealth","type":"object"},"SnapshotReference":{"additionalProperties":false,"properties":{"snapshot_id":{"title":"Snapshot Id","type":"string"},"namespace":{"title":"Namespace","type":"string"},"as_of":{"title":"As Of","type":"string"},"release_id":{"title":"Release Id","type":"string"},"taxonomy_version":{"title":"Taxonomy Version","type":"string"},"heat_run_id":{"title":"Heat Run Id","type":"string"},"mapping_run_id":{"title":"Mapping Run Id","type":"string"},"etf_run_id":{"default":"","title":"Etf Run Id","type":"string"},"market_run_id":{"default":"","title":"Market Run Id","type":"string"},"market_trade_date":{"default":"","title":"Market Trade Date","type":"string"},"market_status":{"default":"unavailable","enum":["fresh","carried_forward","reaggregated","unavailable"],"title":"Market Status","type":"string"},"market_age_days":{"default":0,"title":"Market Age Days","type":"integer"},"market_mapping_reaggregated":{"default":false,"title":"Market Mapping Reaggregated","type":"boolean"},"published_at":{"title":"Published At","type":"string"},"publication_mode":{"enum":["published","derived"],"title":"Publication Mode","type":"string"},"data_status":{"const":"complete","default":"complete","title":"Data Status","type":"string"},"response_profile":{"const":"compact","default":"compact","title":"Response Profile","type":"string"},"sector_dynamics":{"anyOf":[{"$ref":"#/$defs/SnapshotSectorDynamics"},{"type":"null"}],"default":null},"coverage":{"anyOf":[{"additionalProperties":{"type":"integer"},"type":"object"},{"type":"null"}],"default":null,"title":"Coverage"}},"required":["snapshot_id","namespace","as_of","release_id","taxonomy_version","heat_run_id","mapping_run_id","published_at","publication_mode"],"title":"SnapshotReference","type":"object"},"SnapshotSectorDynamics":{"additionalProperties":false,"properties":{"schema_version":{"title":"Schema Version","type":"string"},"dynamics_run_id":{"title":"Dynamics Run Id","type":"string"},"as_of":{"title":"As Of","type":"string"},"trade_date":{"title":"Trade Date","type":"string"},"formula_version":{"title":"Formula Version","type":"string"},"market_context":{"additionalProperties":true,"title":"Market Context","type":"object"},"summary":{"additionalProperties":true,"title":"Summary","type":"object"},"historical_readiness":{"additionalProperties":true,"title":"Historical Readiness","type":"object"},"items":{"items":{"$ref":"#/$defs/SectorAnomalySummary"},"title":"Items","type":"array"},"links":{"items":{"$ref":"#/$defs/SectorLinkageSummary"},"title":"Links","type":"array"}},"required":["schema_version","dynamics_run_id","as_of","trade_date","formula_version"],"title":"SnapshotSectorDynamics","type":"object"},"SectorLinkageSummary":{"additionalProperties":false,"properties":{"source_sector_id":{"title":"Source Sector Id","type":"string"},"source_sector_name":{"title":"Source Sector Name","type":"string"},"target_sector_id":{"title":"Target Sector Id","type":"string"},"target_sector_name":{"title":"Target Sector Name","type":"string"},"relation_kind":{"enum":["hierarchy","taxonomy_semantic"],"title":"Relation Kind","type":"string"},"relation":{"title":"Relation","type":"string"},"pattern":{"enum":["same_day_resonance","same_day_divergence","hierarchy_divergence","structural_overlap"],"title":"Pattern","type":"string"},"linkage_score":{"title":"Linkage Score","type":"number"},"confidence":{"title":"Confidence","type":"number"},"stock_overlap":{"title":"Stock Overlap","type":"number"},"independent_signal":{"title":"Independent Signal","type":"boolean"},"rationale":{"default":"","title":"Rationale","type":"string"}},"required":["source_sector_id","source_sector_name","target_sector_id","target_sector_name","relation_kind","relation","pattern","linkage_score","confidence","stock_overlap","independent_signal"],"title":"SectorLinkageSummary","type":"object"},"SectorAnomalySummary":{"additionalProperties":false,"properties":{"sector_id":{"title":"Sector Id","type":"string"},"sector_name":{"title":"Sector Name","type":"string"},"layer":{"title":"Layer","type":"string"},"relative_direction":{"enum":["stronger","weaker","neutral"],"title":"Relative Direction","type":"string"},"absolute_direction":{"enum":["positive","negative","neutral"],"title":"Absolute Direction","type":"string"},"anomaly_type":{"enum":["counter_trend","relative_resilience","relative_weakness","broad_internal_move","flow_price_divergence","concentrated_move","cross_section_outlier"],"title":"Anomaly Type","type":"string"},"anomaly_score":{"title":"Anomaly Score","type":"number"},"attention_score":{"title":"Attention Score","type":"number"},"internal_confirmation":{"title":"Internal Confirmation","type":"number"},"linkage_score":{"title":"Linkage Score","type":"number"},"linkage_confirmation":{"title":"Linkage Confirmation","type":"number"},"confidence":{"title":"Confidence","type":"number"},"sector_return":{"title":"Sector Return","type":"number"},"market_return":{"title":"Market Return","type":"number"},"excess_return":{"title":"Excess Return","type":"number"},"sector_breadth":{"title":"Sector Breadth","type":"number"},"market_breadth":{"title":"Market Breadth","type":"number"},"breadth_gap":{"title":"Breadth Gap","type":"number"},"effective_sample_size":{"title":"Effective Sample Size","type":"number"},"top1_weight":{"title":"Top1 Weight","type":"number"},"covered_stock_count":{"title":"Covered Stock Count","type":"integer"},"explanation":{"default":"","title":"Explanation","type":"string"},"linked_sectors":{"items":{"additionalProperties":true,"type":"object"},"title":"Linked Sectors","type":"array"}},"required":["sector_id","sector_name","layer","relative_direction","absolute_direction","anomaly_type","anomaly_score","attention_score","internal_confirmation","linkage_score","linkage_confirmation","confidence","sector_return","market_return","excess_return","sector_breadth","market_breadth","breadth_gap","effective_sample_size","top1_weight","covered_stock_count"],"title":"SectorAnomalySummary","type":"object"},"SecurityLifecycleItem":{"properties":{"stock_code":{"title":"Stock Code","type":"string"},"stock_name":{"title":"Stock Name","type":"string"},"company_name":{"default":"","title":"Company Name","type":"string"},"exchange":{"enum":["SSE","SZSE","BSE"],"title":"Exchange","type":"string"},"board":{"title":"Board","type":"string"},"lifecycle_status":{"enum":["prelisted","listed","delisted","cancelled"],"title":"Lifecycle Status","type":"string"},"lifecycle_stage":{"title":"Lifecycle Stage","type":"string"},"status_effective_date":{"title":"Status Effective Date","type":"string"},"planned_listing_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Planned Listing Date"},"listing_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Listing Date"},"delisting_date":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Delisting Date"},"first_seen_at":{"title":"First Seen At","type":"string"},"last_seen_at":{"title":"Last Seen At","type":"string"},"source_id":{"title":"Source Id","type":"string"},"source_url":{"default":"","title":"Source Url","type":"string"},"reason":{"title":"Reason","type":"string"},"evidence_count":{"default":0,"title":"Evidence Count","type":"integer"},"latest_evidence":{"anyOf":[{"$ref":"#/$defs/SecurityLifecycleEvidence"},{"type":"null"}],"default":null},"sector_count":{"default":0,"title":"Sector Count","type":"integer"},"sectors":{"items":{"$ref":"#/$defs/SecurityLifecycleSector"},"title":"Sectors","type":"array"}},"required":["stock_code","stock_name","exchange","board","lifecycle_status","lifecycle_stage","status_effective_date","first_seen_at","last_seen_at","source_id","reason"],"title":"SecurityLifecycleItem","type":"object"},"SecurityLifecycleEvidence":{"properties":{"evidence_id":{"title":"Evidence Id","type":"string"},"source_id":{"title":"Source Id","type":"string"},"evidence_type":{"title":"Evidence Type","type":"string"},"effective_date":{"title":"Effective Date","type":"string"},"title":{"title":"Title","type":"string"},"source_url":{"default":"","title":"Source Url","type":"string"},"observed_at":{"title":"Observed At","type":"string"}},"required":["evidence_id","source_id","evidence_type","effective_date","title","observed_at"],"title":"SecurityLifecycleEvidence","type":"object"},"SecurityLifecycleSector":{"properties":{"relation_id":{"title":"Relation Id","type":"string"},"sector_id":{"title":"Sector Id","type":"string"},"sector_name":{"title":"Sector Name","type":"string"},"sector_layer":{"default":"","title":"Sector Layer","type":"string"},"relation_type":{"enum":["business","market"],"title":"Relation Type","type":"string"},"relation_status":{"title":"Relation Status","type":"string"},"score":{"title":"Score","type":"number"},"confidence":{"title":"Confidence","type":"number"},"evidence_count":{"default":0,"title":"Evidence Count","type":"integer"},"mapping_state":{"enum":["preview","effective","historical"],"title":"Mapping State","type":"string"}},"required":["relation_id","sector_id","sector_name","relation_type","relation_status","score","confidence","mapping_state"],"title":"SecurityLifecycleSector","type":"object"},"SnapshotContext":{"additionalProperties":false,"properties":{"snapshot_id":{"title":"Snapshot Id","type":"string"},"namespace":{"title":"Namespace","type":"string"},"as_of":{"title":"As Of","type":"string"},"release_id":{"title":"Release Id","type":"string"},"taxonomy_version":{"title":"Taxonomy Version","type":"string"},"heat_run_id":{"title":"Heat Run Id","type":"string"},"mapping_run_id":{"title":"Mapping Run Id","type":"string"},"etf_run_id":{"default":"","title":"Etf Run Id","type":"string"},"market_run_id":{"default":"","title":"Market Run Id","type":"string"},"market_trade_date":{"default":"","title":"Market Trade Date","type":"string"},"market_status":{"default":"unavailable","enum":["fresh","carried_forward","reaggregated","unavailable"],"title":"Market Status","type":"string"},"market_age_days":{"default":0,"title":"Market Age Days","type":"integer"},"market_mapping_reaggregated":{"default":false,"title":"Market Mapping Reaggregated","type":"boolean"},"sector_dynamics":{"anyOf":[{"$ref":"#/$defs/SnapshotSectorDynamics"},{"type":"null"}],"default":null},"published_at":{"title":"Published At","type":"string"},"publication_mode":{"enum":["published","derived"],"title":"Publication Mode","type":"string"},"data_status":{"const":"complete","default":"complete","title":"Data Status","type":"string"},"coverage":{"additionalProperties":{"type":"integer"},"title":"Coverage","type":"object"}},"required":["snapshot_id","namespace","as_of","release_id","taxonomy_version","heat_run_id","mapping_run_id","published_at","publication_mode"],"title":"SnapshotContext","type":"object"},"Pagination":{"properties":{"page":{"title":"Page","type":"integer"},"page_size":{"title":"Page Size","type":"integer"},"total":{"title":"Total","type":"integer"},"pages":{"title":"Pages","type":"integer"}},"required":["page","page_size","total","pages"],"title":"Pagination","type":"object"},"SecurityLifecycleSummary":{"properties":{"prelisted":{"title":"Prelisted","type":"integer"},"recent_listed":{"title":"Recent Listed","type":"integer"},"recent_departures":{"title":"Recent Departures","type":"integer"}},"required":["prelisted","recent_listed","recent_departures"],"title":"SecurityLifecycleSummary","type":"object"},"SecurityLifecycleSectorImpact":{"properties":{"sector_id":{"title":"Sector Id","type":"string"},"sector_name":{"title":"Sector Name","type":"string"},"sector_layer":{"default":"","title":"Sector Layer","type":"string"},"event_count":{"title":"Event Count","type":"integer"},"effective_count":{"title":"Effective Count","type":"integer"},"preview_count":{"title":"Preview Count","type":"integer"},"historical_count":{"title":"Historical Count","type":"integer"},"stock_codes":{"items":{"type":"string"},"title":"Stock Codes","type":"array"},"stock_names":{"items":{"type":"string"},"title":"Stock Names","type":"array"}},"required":["sector_id","sector_name","event_count","effective_count","preview_count","historical_count"],"title":"SecurityLifecycleSectorImpact","type":"object"}}}}}}