{"schema_version":"gendangzou-capabilities-v1","contract_version":"gendangzou-api-v2","capability":{"id":"company.state_capital.events.list","domain":"company","title":"查询国资变动时间轴","summary":"列出国资进入、增持、减持、退出及控制关系变化，并区分拟议、批准、完成和终止。","intents":["trace_state_capital_changes","inspect_state_capital_entry_exit"],"path":"/api/gendangzou/companies/{stock_code}/state-capital/events","snapshot_bound":false,"compact_supported":false,"method":"GET","detail_url":"/api/gendangzou/capabilities/company.state_capital.events.list","parameters":["stock_code","start","end","lifecycle_status","page","page_size","research_as_of","version_id"],"response_fields":["stock_code","version_id","research_as_of","items","pagination"],"related_capabilities":["company.state_capital.detail","company.state_capital.event_evidence.list"],"freshness":"quality_gated_company_research_publication","pagination":true,"documentation_url":"https://docs.mobiusquant.ai/zh/gendangzou/capabilities/company.state_capital.events.list","agent_hints":{"reuse_snapshot_id_for_follow_up":false,"fetch_evidence_on_demand":true,"recommended_page_size":10},"request":{"parameters":[{"name":"stock_code","in":"path","required":true,"schema":{"pattern":"^[0-9]{6}$","type":"string"}},{"name":"start","in":"query","required":false,"schema":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null}},{"name":"end","in":"query","required":false,"schema":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null}},{"name":"lifecycle_status","in":"query","required":false,"schema":{"anyOf":[{"enum":["proposed","approved","completed","terminated"],"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":20,"maximum":100,"minimum":1,"type":"integer"}},{"name":"research_as_of","in":"query","required":false,"schema":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null}},{"name":"version_id","in":"query","required":false,"schema":{"anyOf":[{"maxLength":128,"minLength":8,"type":"string"},{"type":"null"}],"default":null}}]},"response":{"model":"CompanyStateCapitalEventListResponse","top_level_fields":[{"name":"stock_code","required":true},{"name":"version_id","required":true},{"name":"research_as_of","required":true},{"name":"items","required":true},{"name":"pagination","required":true}],"schema":{"properties":{"stock_code":{"title":"Stock Code","type":"string"},"version_id":{"title":"Version Id","type":"string"},"research_as_of":{"title":"Research As Of","type":"string"},"items":{"items":{"$ref":"#/$defs/CompanyStateCapitalEvent"},"title":"Items","type":"array"},"pagination":{"$ref":"#/$defs/Pagination"}},"required":["stock_code","version_id","research_as_of","items","pagination"],"title":"CompanyStateCapitalEventListResponse","type":"object","$defs":{"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"},"CompanyStateCapitalEvent":{"properties":{"event_id":{"title":"Event Id","type":"string"},"event_type":{"title":"Event Type","type":"string"},"title":{"title":"Title","type":"string"},"actor_node_id":{"default":"","title":"Actor Node Id","type":"string"},"actor_name":{"default":"","title":"Actor Name","type":"string"},"target_node_id":{"default":"","title":"Target Node Id","type":"string"},"target_name":{"default":"","title":"Target Name","type":"string"},"event_date":{"title":"Event Date","type":"string"},"announced_at":{"default":"","title":"Announced At","type":"string"},"effective_at":{"default":"","title":"Effective At","type":"string"},"lifecycle_status":{"enum":["proposed","approved","completed","terminated"],"title":"Lifecycle Status","type":"string"},"before_percentage":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Before Percentage"},"after_percentage":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"After Percentage"},"change_percentage":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Change Percentage"},"control_impact":{"default":"unchanged","title":"Control Impact","type":"string"},"summary":{"title":"Summary","type":"string"},"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":["event_id","event_type","title","event_date","lifecycle_status","summary"],"title":"CompanyStateCapitalEvent","type":"object"}}}}}}