{"schema_version":"gendangzou-capabilities-v1","contract_version":"gendangzou-api-v2","capability":{"id":"company.research.facts.list","domain":"company","title":"查询公司研究事实","summary":"按研究分类或事实域分页读取结构化公司事实，保留日期与置信度。","intents":["inspect_company_facts","analyze_company_research"],"path":"/api/gendangzou/companies/{stock_code}/research/facts","snapshot_bound":false,"compact_supported":false,"method":"GET","detail_url":"/api/gendangzou/capabilities/company.research.facts.list","parameters":["stock_code","category","domain","page","page_size","research_as_of","version_id"],"response_fields":["stock_code","version_id","research_as_of","category","domain","items","pagination"],"related_capabilities":["company.research.detail","company.research.fact_evidence.list"],"freshness":"quality_gated_company_research_publication","pagination":true,"documentation_url":"https://docs.mobiusquant.ai/zh/gendangzou/capabilities/company.research.facts.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":"category","in":"query","required":false,"schema":{"anyOf":[{"enum":["ownership_control","policy_support","financing_debt","capital_use","business_projects"],"type":"string"},{"type":"null"}],"default":null}},{"name":"domain","in":"query","required":false,"schema":{"anyOf":[{"maxLength":80,"minLength":3,"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":10,"maximum":100,"minimum":1,"type":"integer"}},{"name":"research_as_of","in":"query","required":false,"schema":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"description":"Return the latest company research version on or before this date"}},{"name":"version_id","in":"query","required":false,"schema":{"anyOf":[{"maxLength":128,"minLength":8,"type":"string"},{"type":"null"}],"default":null}}]},"response":{"model":"CompanyResearchFactListResponse","top_level_fields":[{"name":"stock_code","required":true},{"name":"version_id","required":true},{"name":"research_as_of","required":true},{"name":"category","required":false},{"name":"domain","required":false},{"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"},"category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Category"},"domain":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Domain"},"items":{"items":{"$ref":"#/$defs/CompanyResearchFact"},"title":"Items","type":"array"},"pagination":{"$ref":"#/$defs/Pagination"}},"required":["stock_code","version_id","research_as_of","items","pagination"],"title":"CompanyResearchFactListResponse","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"},"CompanyResearchFact":{"properties":{"fact_id":{"title":"Fact Id","type":"string"},"category":{"title":"Category","type":"string"},"category_label":{"title":"Category Label","type":"string"},"domain":{"title":"Domain","type":"string"},"domain_label":{"title":"Domain Label","type":"string"},"subject_name":{"title":"Subject Name","type":"string"},"predicate":{"title":"Predicate","type":"string"},"object_name":{"default":"","title":"Object Name","type":"string"},"value_text":{"default":"","title":"Value Text","type":"string"},"amount":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Amount"},"currency":{"default":"","title":"Currency","type":"string"},"percentage":{"anyOf":[{"type":"number"},{"type":"null"}],"default":null,"title":"Percentage"},"unit":{"default":"","title":"Unit","type":"string"},"polarity":{"title":"Polarity","type":"string"},"statement_kind":{"title":"Statement Kind","type":"string"},"event_date":{"default":"","title":"Event Date","type":"string"},"as_of_date":{"default":"","title":"As Of Date","type":"string"},"status":{"title":"Status","type":"string"},"confidence":{"title":"Confidence","type":"number"},"evidence_count":{"default":0,"title":"Evidence Count","type":"integer"},"material_count":{"default":0,"title":"Material Count","type":"integer"}},"required":["fact_id","category","category_label","domain","domain_label","subject_name","predicate","polarity","statement_kind","status","confidence"],"title":"CompanyResearchFact","type":"object"}}}}}}