{"schema_version":"gendangzou-capabilities-v1","contract_version":"gendangzou-api-v2","capability":{"id":"etf.relation.contributions","domain":"etf","title":"审计 ETF、公司与板块贡献链","summary":"分页返回每个篮子成分、公司板块关系及其对调整暴露的完整贡献。","intents":["audit_etf_exposure","trace_etf_company_sector_contribution"],"path":"/api/gendangzou/etf-sector-relations/{relation_id}/contributions","snapshot_bound":true,"compact_supported":true,"method":"GET","detail_url":"/api/gendangzou/capabilities/etf.relation.contributions","parameters":["relation_id","snapshot_id","as_of","page","page_size","detail","include"],"response_fields":["snapshot","relation","items","pagination"],"related_capabilities":["etf.relation.evidence","etf.relation.changes","company.sectors.list"],"freshness":"daily_official_pcf_snapshot","pagination":true,"documentation_url":"https://docs.mobiusquant.ai/zh/gendangzou/capabilities/etf.relation.contributions","agent_hints":{"reuse_snapshot_id_for_follow_up":true,"fetch_evidence_on_demand":true,"recommended_detail":"compact","compact_scope":"snapshot_context","recommended_page_size":10},"request":{"parameters":[{"name":"relation_id","in":"path","required":true,"schema":{"maxLength":128,"minLength":12,"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":50,"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":"as_of","in":"query","required":false,"schema":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"default":null,"description":"Return the latest snapshot on or before this date"}},{"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":"EtfRelationContributionResponse","top_level_fields":[{"name":"snapshot","required":true},{"name":"relation","required":true},{"name":"items","required":true},{"name":"pagination","required":true}],"schema":{"properties":{"snapshot":{"anyOf":[{"$ref":"#/$defs/SnapshotContext"},{"$ref":"#/$defs/SnapshotReference"}],"title":"Snapshot"},"relation":{"$ref":"#/$defs/EtfSectorRelation"},"items":{"items":{"$ref":"#/$defs/EtfCompanySectorContribution"},"title":"Items","type":"array"},"pagination":{"$ref":"#/$defs/Pagination"}},"required":["snapshot","relation","items","pagination"],"title":"EtfRelationContributionResponse","type":"object","$defs":{"EtfSectorRelation":{"additionalProperties":false,"properties":{"relation_id":{"description":"ETF 与板块关系的稳定标识。","title":"Relation Id","type":"string"},"etf_key":{"title":"Etf Key","type":"string"},"fund_code":{"title":"Fund Code","type":"string"},"etf_name":{"title":"Etf Name","type":"string"},"exchange":{"enum":["SSE","SZSE"],"title":"Exchange","type":"string"},"product_scope":{"enum":["broad","sector"],"title":"Product Scope","type":"string"},"tracking_index_code":{"default":"","title":"Tracking Index Code","type":"string"},"tracking_index_name":{"default":"","title":"Tracking Index Name","type":"string"},"tracking_group_id":{"default":"","title":"Tracking Group Id","type":"string"},"sector_id":{"title":"Sector Id","type":"string"},"sector_name":{"title":"Sector Name","type":"string"},"sector_layer":{"title":"Sector Layer","type":"string"},"mapping_type":{"enum":["tracking_index","holding_exposure","dynamic_inference","hierarchy_inherited","hierarchy_related","lineage_continuity","semantic_related","hierarchy_reference"],"title":"Mapping Type","type":"string"},"relation_scope":{"default":"direct","enum":["direct","extended","related","reference"],"title":"Relation Scope","type":"string"},"source_sector_id":{"default":"","title":"Source Sector Id","type":"string"},"source_sector_name":{"default":"","title":"Source Sector Name","type":"string"},"source_sector_layer":{"default":"","title":"Source Sector Layer","type":"string"},"path":{"items":{"additionalProperties":true,"type":"object"},"title":"Path","type":"array"},"path_depth":{"default":0,"title":"Path Depth","type":"integer"},"path_confidence":{"default":1.0,"title":"Path Confidence","type":"number"},"specificity_score":{"default":1.0,"title":"Specificity Score","type":"number"},"semantic_score":{"default":0.0,"title":"Semantic Score","type":"number"},"direct_child_exposure":{"default":0.0,"title":"Direct Child Exposure","type":"number"},"source_adjusted_exposure":{"default":0.0,"title":"Source Adjusted Exposure","type":"number"},"reference_only":{"default":false,"title":"Reference Only","type":"boolean"},"status":{"enum":["active","watched","candidate","expired"],"title":"Status","type":"string"},"exposure_ratio":{"title":"Exposure Ratio","type":"number"},"adjusted_exposure":{"title":"Adjusted Exposure","type":"number"},"confidence":{"title":"Confidence","type":"number"},"holdings_coverage":{"title":"Holdings Coverage","type":"number"},"component_count":{"title":"Component Count","type":"integer"},"basket_date":{"title":"Basket Date","type":"string"},"basket_freshness_status":{"default":"unknown","description":"本轮 ETF 篮子的核验或获取状态。","enum":["refreshed","verified_unchanged","carried_forward","unknown"],"title":"Basket Freshness Status","type":"string"},"basket_age_days":{"default":0,"description":"篮子业务日期距快照业务日期的自然日数。","minimum":0,"title":"Basket Age Days","type":"integer"},"basket_checked_as_of":{"default":"","description":"最近一次向交易所产品目录核验篮子日期的日期。","title":"Basket Checked As Of","type":"string"},"catalog_verified":{"default":false,"description":"本轮是否已经通过交易所产品目录核验。","title":"Catalog Verified","type":"boolean"},"content_changed":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"本轮重新获取 PCF 后，篮子内容是否发生变化。","title":"Content Changed"},"source_fetched_at":{"default":"","description":"当前使用的 PCF 原文实际获取时间。","title":"Source Fetched At","type":"string"},"official_pcf_url":{"default":"","title":"Official Pcf Url","type":"string"},"calculation":{"default":"","title":"Calculation","type":"string"},"top_components":{"items":{"additionalProperties":true,"type":"object"},"title":"Top Components","type":"array"}},"required":["relation_id","etf_key","fund_code","etf_name","exchange","product_scope","sector_id","sector_name","sector_layer","mapping_type","status","exposure_ratio","adjusted_exposure","confidence","holdings_coverage","component_count","basket_date"],"title":"EtfSectorRelation","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"},"EtfCompanySectorContribution":{"additionalProperties":false,"properties":{"contribution_id":{"description":"单条 ETF、公司与板块贡献的稳定标识。","title":"Contribution Id","type":"string"},"relation_id":{"description":"ETF 与板块关系的稳定标识。","title":"Relation Id","type":"string"},"etf_key":{"title":"Etf Key","type":"string"},"basket_id":{"title":"Basket Id","type":"string"},"basket_date":{"title":"Basket Date","type":"string"},"stock_code":{"title":"Stock Code","type":"string"},"stock_name":{"default":"","title":"Stock Name","type":"string"},"sector_id":{"title":"Sector Id","type":"string"},"sector_name":{"title":"Sector Name","type":"string"},"sector_layer":{"title":"Sector Layer","type":"string"},"company_relation_id":{"description":"公司与板块关系的稳定标识。","title":"Company Relation Id","type":"string"},"company_relation_type":{"description":"公司关系类型：长期业务关系或短期市场关系。","enum":["business","market"],"title":"Company Relation Type","type":"string"},"company_relation_status":{"description":"公司板块关系在当前版本中的状态。","enum":["active","watched","candidate","expired"],"title":"Company Relation Status","type":"string"},"basket_weight":{"description":"该公司在 ETF 篮子中的原始权重。","title":"Basket Weight","type":"number"},"company_relation_score":{"description":"公司业务事实与板块定义的关系强度。","title":"Company Relation Score","type":"number"},"company_relation_confidence":{"description":"公司板块关系的证据置信度。","title":"Company Relation Confidence","type":"number"},"relation_status_factor":{"description":"公司关系状态对应的调整因子。","title":"Relation Status Factor","type":"number"},"relation_type_factor":{"description":"公司关系类型对应的调整因子。","title":"Relation Type Factor","type":"number"},"adjusted_contribution":{"description":"该公司对 ETF 板块调整暴露的最终贡献。","title":"Adjusted Contribution","type":"number"}},"required":["contribution_id","relation_id","etf_key","basket_id","basket_date","stock_code","sector_id","sector_name","sector_layer","company_relation_id","company_relation_type","company_relation_status","basket_weight","company_relation_score","company_relation_confidence","relation_status_factor","relation_type_factor","adjusted_contribution"],"title":"EtfCompanySectorContribution","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"}}}}}}