{"schema_version":"gendangzou-capabilities-v1","contract_version":"gendangzou-api-v2","capability":{"id":"company.research.versions.list","domain":"company","title":"查询公司研究变化时间轴","summary":"按公司列出已发布研究版本及事实、关系、材料和缺口的变化摘要。","intents":["list_company_research_versions","trace_company_research_changes"],"path":"/api/gendangzou/companies/{stock_code}/research/versions","snapshot_bound":false,"compact_supported":false,"method":"GET","detail_url":"/api/gendangzou/capabilities/company.research.versions.list","parameters":["stock_code","page","page_size"],"response_fields":["stock_code","items","pagination"],"related_capabilities":["company.research.detail","company.research.facts.list"],"freshness":"quality_gated_company_research_publication","pagination":true,"documentation_url":"https://docs.mobiusquant.ai/zh/gendangzou/capabilities/company.research.versions.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":"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"}}]},"response":{"model":"CompanyResearchVersionListResponse","top_level_fields":[{"name":"stock_code","required":true},{"name":"items","required":true},{"name":"pagination","required":true}],"schema":{"properties":{"stock_code":{"title":"Stock Code","type":"string"},"items":{"items":{"$ref":"#/$defs/CompanyResearchVersion"},"title":"Items","type":"array"},"pagination":{"$ref":"#/$defs/Pagination"}},"required":["stock_code","items","pagination"],"title":"CompanyResearchVersionListResponse","type":"object","$defs":{"CompanyResearchVersion":{"properties":{"version_id":{"title":"Version Id","type":"string"},"version_number":{"title":"Version Number","type":"integer"},"research_as_of":{"title":"Research As Of","type":"string"},"published_at":{"title":"Published At","type":"string"},"previous_version_id":{"default":"","title":"Previous Version Id","type":"string"},"fact_count":{"default":0,"title":"Fact Count","type":"integer"},"relationship_count":{"default":0,"title":"Relationship Count","type":"integer"},"gap_count":{"default":0,"title":"Gap Count","type":"integer"},"change_summary":{"$ref":"#/$defs/CompanyResearchChangeSummary"}},"required":["version_id","version_number","research_as_of","published_at"],"title":"CompanyResearchVersion","type":"object"},"CompanyResearchChangeSummary":{"properties":{"initial_version":{"default":false,"title":"Initial Version","type":"boolean"},"facts_added":{"default":0,"title":"Facts Added","type":"integer"},"facts_removed":{"default":0,"title":"Facts Removed","type":"integer"},"relationships_added":{"default":0,"title":"Relationships Added","type":"integer"},"relationships_removed":{"default":0,"title":"Relationships Removed","type":"integer"},"materials_added":{"default":0,"title":"Materials Added","type":"integer"},"materials_removed":{"default":0,"title":"Materials Removed","type":"integer"},"gaps_opened":{"default":0,"title":"Gaps Opened","type":"integer"},"gaps_resolved":{"default":0,"title":"Gaps Resolved","type":"integer"},"changed_domains":{"items":{"type":"string"},"title":"Changed Domains","type":"array"}},"title":"CompanyResearchChangeSummary","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"}}}}}}