{"schema_version":"gendangzou-capabilities-v1","contract_version":"gendangzou-api-v2","capability":{"id":"company.state_capital.detail","domain":"company","title":"获取公司国资穿透图谱","summary":"返回公司当前或指定日期有效的上游持股、控制路径、国资性质及最终控制主体；研究版本与日报快照相互独立。","intents":["trace_state_capital","inspect_ultimate_controller"],"path":"/api/gendangzou/companies/{stock_code}/state-capital","snapshot_bound":false,"compact_supported":false,"method":"GET","detail_url":"/api/gendangzou/capabilities/company.state_capital.detail","parameters":["stock_code","graph_as_of","research_as_of","version_id"],"response_fields":["stock_code","available","profile","graph"],"related_capabilities":["company.state_capital.events.list","company.research.detail","company.detail"],"freshness":"quality_gated_company_research_publication","pagination":false,"documentation_url":"https://docs.mobiusquant.ai/zh/gendangzou/capabilities/company.state_capital.detail","agent_hints":{"reuse_snapshot_id_for_follow_up":false,"fetch_evidence_on_demand":true},"request":{"parameters":[{"name":"stock_code","in":"path","required":true,"schema":{"pattern":"^[0-9]{6}$","type":"string"}},{"name":"graph_as_of","in":"query","required":false,"schema":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"description":"重建该日期有效的持股与控制关系；默认采用研究版本截止日"}},{"name":"research_as_of","in":"query","required":false,"schema":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"description":"选择不晚于该日期的最新公司研究版本"}},{"name":"version_id","in":"query","required":false,"schema":{"anyOf":[{"maxLength":128,"minLength":8,"type":"string"},{"type":"null"}],"default":null}}]},"response":{"model":"CompanyStateCapitalDetailResponse","top_level_fields":[{"name":"stock_code","required":true},{"name":"available","required":true},{"name":"profile","required":false},{"name":"graph","required":false}],"schema":{"properties":{"stock_code":{"title":"Stock Code","type":"string"},"available":{"title":"Available","type":"boolean"},"profile":{"anyOf":[{"$ref":"#/$defs/CompanyStateCapitalProfile"},{"type":"null"}],"default":null},"graph":{"anyOf":[{"$ref":"#/$defs/CompanyStateCapitalGraph"},{"type":"null"}],"default":null}},"required":["stock_code","available"],"title":"CompanyStateCapitalDetailResponse","type":"object","$defs":{"CompanyStateCapitalProfile":{"properties":{"version_id":{"title":"Version Id","type":"string"},"stock_code":{"title":"Stock Code","type":"string"},"company_name":{"title":"Company Name","type":"string"},"research_as_of":{"title":"Research As Of","type":"string"},"generated_at":{"title":"Generated At","type":"string"},"state_capital_status":{"enum":["state_controlled","state_invested","non_state_controlled","undetermined"],"title":"State Capital Status","type":"string"},"ultimate_controller_name":{"default":"","title":"Ultimate Controller Name","type":"string"},"ultimate_controller_nature":{"default":"undetermined","title":"Ultimate Controller Nature","type":"string"},"direct_state_ownership_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Direct State Ownership Pct"},"max_known_state_ownership_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Max Known State Ownership Pct"},"confidence":{"default":0.0,"title":"Confidence","type":"number"},"completeness_status":{"enum":["complete","partial","undetermined"],"title":"Completeness Status","type":"string"},"node_count":{"default":0,"title":"Node Count","type":"integer"},"edge_count":{"default":0,"title":"Edge Count","type":"integer"},"path_count":{"default":0,"title":"Path Count","type":"integer"},"event_count":{"default":0,"title":"Event Count","type":"integer"},"quality_flags":{"items":{"type":"string"},"title":"Quality Flags","type":"array"}},"required":["version_id","stock_code","company_name","research_as_of","generated_at","state_capital_status","completeness_status"],"title":"CompanyStateCapitalProfile","type":"object"},"CompanyStateCapitalGraph":{"properties":{"graph_as_of":{"title":"Graph As Of","type":"string"},"state_capital_status":{"enum":["state_controlled","state_invested","non_state_controlled","undetermined"],"title":"State Capital Status","type":"string"},"ultimate_controller_node_id":{"default":"","title":"Ultimate Controller Node Id","type":"string"},"nodes":{"items":{"$ref":"#/$defs/CompanyStateCapitalNode"},"title":"Nodes","type":"array"},"edges":{"items":{"$ref":"#/$defs/CompanyStateCapitalEdge"},"title":"Edges","type":"array"},"paths":{"items":{"$ref":"#/$defs/CompanyStateCapitalPath"},"title":"Paths","type":"array"}},"required":["graph_as_of","state_capital_status"],"title":"CompanyStateCapitalGraph","type":"object"},"CompanyStateCapitalEdge":{"properties":{"edge_id":{"title":"Edge Id","type":"string"},"source_node_id":{"title":"Source Node Id","type":"string"},"source_name":{"title":"Source Name","type":"string"},"target_node_id":{"title":"Target Node Id","type":"string"},"target_name":{"title":"Target Name","type":"string"},"relation_type":{"enum":["ownership","control","voting","concert"],"title":"Relation Type","type":"string"},"ownership_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Ownership Pct"},"effective_from":{"default":"","title":"Effective From","type":"string"},"effective_to":{"default":"","title":"Effective To","type":"string"},"observed_at":{"default":"","title":"Observed At","type":"string"},"lifecycle_status":{"title":"Lifecycle Status","type":"string"},"is_state_path":{"default":false,"title":"Is State Path","type":"boolean"},"confidence":{"default":0.0,"title":"Confidence","type":"number"},"evidence_count":{"default":0,"title":"Evidence Count","type":"integer"},"fact_ids":{"items":{"type":"string"},"title":"Fact Ids","type":"array"}},"required":["edge_id","source_node_id","source_name","target_node_id","target_name","relation_type","lifecycle_status"],"title":"CompanyStateCapitalEdge","type":"object"},"CompanyStateCapitalPath":{"properties":{"path_id":{"title":"Path Id","type":"string"},"source_node_id":{"title":"Source Node Id","type":"string"},"source_name":{"title":"Source Name","type":"string"},"target_node_id":{"title":"Target Node Id","type":"string"},"path_type":{"enum":["control","ownership","ownership_exposure"],"title":"Path Type","type":"string"},"node_ids":{"items":{"type":"string"},"title":"Node Ids","type":"array"},"edge_ids":{"items":{"type":"string"},"title":"Edge Ids","type":"array"},"calculated_ownership_pct":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Calculated Ownership Pct"},"has_unknown_percentage":{"default":false,"title":"Has Unknown Percentage","type":"boolean"},"is_control_path":{"default":false,"title":"Is Control Path","type":"boolean"},"confidence":{"default":0.0,"title":"Confidence","type":"number"}},"required":["path_id","source_node_id","source_name","target_node_id","path_type"],"title":"CompanyStateCapitalPath","type":"object"},"CompanyStateCapitalNode":{"properties":{"node_id":{"title":"Node Id","type":"string"},"name":{"title":"Name","type":"string"},"entity_type":{"title":"Entity Type","type":"string"},"state_nature":{"title":"State Nature","type":"string"},"state_level":{"default":"unknown","title":"State Level","type":"string"},"classification_status":{"title":"Classification Status","type":"string"},"classification_method":{"title":"Classification Method","type":"string"},"is_state_capital":{"default":false,"title":"Is State Capital","type":"boolean"},"is_listed_company":{"default":false,"title":"Is Listed Company","type":"boolean"},"is_ultimate_controller":{"default":false,"title":"Is Ultimate Controller","type":"boolean"},"in_state_path":{"default":false,"title":"In State Path","type":"boolean"},"depth":{"default":0,"title":"Depth","type":"integer"},"confidence":{"default":0.0,"title":"Confidence","type":"number"},"fact_ids":{"items":{"type":"string"},"title":"Fact Ids","type":"array"}},"required":["node_id","name","entity_type","state_nature","classification_status","classification_method"],"title":"CompanyStateCapitalNode","type":"object"}}}}}}