{"$schema":"https://api.alphahubs.uk/static/downloads/friends-data-dictionary-v2.schema.json","object":"friends_data_dictionary_namespace","version":"2.0","guidanceVersion":2,"apiVersion":"v1","baseUrl":"https://api.alphahubs.uk","generatedAt":"2026-10-06T18:08:52Z","schemaObservedAt":"2026-10-06T18:08:52Z","source":"Friends-visible DatasetSpec + ClickHouse system.columns/system.tables","namespace":"corp","description":"分红、股东、质押与回购等公司行为。","datasetCount":7,"fieldCount":169,"datasets":[{"object":"dataset_schema","asset":"corp.action_vintage","namespace":"corp","name":"action_vintage","coverageTags":["corporate_actions"],"description":"Canonical Friends financial dataset: 公司行为历史版本.","relation":"corp.action_vintage","objectKind":"table","rowMagnitude":"100K-999K","grain":"instrument_id × ex_date × action_type","cadence":"daily","timeColumn":"publish_ts","defaultOrder":["instrument_id","ex_date","action_type","source"],"filters":[{"name":"action_type","column":"action_type","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"code","column":"code","required":false,"multipleValues":true,"jsonType":"string","example":"TICKER","exampleSource":"identifier_format"},{"name":"instrument_id","column":"instrument_id","required":false,"multipleValues":true,"jsonType":"integer","example":1},{"name":"market","column":"market","required":false,"multipleValues":true,"jsonType":"string","example":"US","exampleSource":"observed_coverage","allowedValues":["US"]},{"name":"provider","column":"provider","required":false,"multipleValues":true,"jsonType":"string","example":"PROVIDER_VALUE"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["instrument_id","ex_date","action_type","source"],"provenanceColumns":[],"fieldCount":31,"fields":[{"position":1,"name":"instrument_id","displayName":"instrument id","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"WarrenHub canonical instrument identifier; use it for cross-dataset joins.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["instrument_id"],"returned":true},{"position":2,"name":"code","displayName":"code","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized security or contract code.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["code"],"returned":true},{"position":3,"name":"market","displayName":"market","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Canonical market or country-market code.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["market"],"returned":true},{"position":4,"name":"action_type","displayName":"action type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: action type.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["action_type"],"returned":true},{"position":5,"name":"ex_date","displayName":"ex date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for ex date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":6,"name":"record_date","displayName":"record date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for record date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":7,"name":"payment_date","displayName":"payment date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for payment date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":8,"name":"announcement_date","displayName":"announcement date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for announcement date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":9,"name":"split_ratio","displayName":"split ratio","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Ratio value for split ratio.","descriptionSource":"name_derived","roles":[],"filterNames":[],"unit":"ratio","returned":true},{"position":10,"name":"dividend_amount","displayName":"dividend amount","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: dividend amount.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"cash_currency","displayName":"cash currency","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: cash currency.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"stock_dividend_ratio","displayName":"stock dividend ratio","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Ratio value for stock dividend ratio.","descriptionSource":"name_derived","roles":[],"filterNames":[],"unit":"ratio","returned":true},{"position":13,"name":"new_instrument_id","displayName":"new instrument id","clickhouseType":"Nullable(UInt64)","jsonType":"integer","nullable":true,"description":"Identifier for new instrument.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"new_symbol","displayName":"new symbol","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: new symbol.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"publish_ts","displayName":"publish ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC point-in-time availability timestamp used by PIT reads.","descriptionSource":"standard_glossary","roles":["time","provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":16,"name":"source_ts","displayName":"source ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"Timestamp asserted by the upstream source.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":17,"name":"ingested_at","displayName":"ingested at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the source record entered the warehouse.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":18,"name":"source","displayName":"source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key","provenance"],"filterNames":["source"],"returned":true},{"position":19,"name":"provider","displayName":"provider","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Upstream data provider identifier.","descriptionSource":"standard_glossary","roles":["filter","provenance"],"filterNames":["provider"],"returned":true},{"position":20,"name":"source_url","displayName":"source url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"URL of the upstream evidence or record when distributable.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":21,"name":"source_record_id","displayName":"source record id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Provider-side identifier for the source record.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":22,"name":"vendor_extras_json","displayName":"vendor extras json","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: vendor extras json.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"internal body/object-path/raw-payload surface; retrieval requires a separate entitled endpoint"},{"position":23,"name":"raw_payload_hash","displayName":"raw payload hash","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Opaque fingerprint of the normalized source payload for provenance checks.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":24,"name":"parser_version","displayName":"parser version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Version of the parser or normalizer that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":25,"name":"quality_status","displayName":"quality status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Machine-readable data-quality classification.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":26,"name":"license_scope","displayName":"license scope","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"License or redistribution scope attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":27,"name":"visibility_tier","displayName":"visibility tier","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Serving visibility tier attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":28,"name":"ingest_run_id","displayName":"ingest run id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier of the ingestion run that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":29,"name":"version","displayName":"version","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Monotonic row version used for correction-aware reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":30,"name":"version_ts","displayName":"version ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp associated with the row version.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":31,"name":"is_deleted","displayName":"is deleted","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Soft-delete marker; public serving excludes current tombstones.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true}],"pit":null,"titleCn":"公司行为历史版本","summaryCn":"这是公司行动与证券生命周期中的“公司行为历史版本”数据集；一行由 instrument_id、ex_date、action_type、source 定位，主要字段包括 code、market、record_date、payment_date、announcement_date。","useCasesCn":["还原公司行为和证券生命周期","在收益研究中对齐公告与生效日期"],"grainCn":"每行代表“公司行为历史版本”的一条记录；逻辑粒度由 instrument_id × ex_date × action_type 共同确定。","timeSemanticsCn":"以 publish_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"ex_date","meaningCn":"ex date 对应的日历日期。"},{"name":"action_type","meaningCn":"用于确定该表业务粒度或默认顺序的 action type 字段。"},{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":["US"],"coverage":{"measured":true,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{"US":{"latestBusinessDate":"2026-08-28","rows":440837}},"latestBusinessDate":"2026-08-28","note":"Recent observed coverage, not a lifetime guarantee. An unmeasured dataset carries no support claim in either direction."},"identifier":{"namespace":"us_ticker","formatByMarket":{"US":"TICKER"},"storesZeroPaddedHkCode":false,"stableJoinKey":"instrument_id","resolverPath":"/api/v1/data/instruments/resolve"},"sparseSemantics":null,"emptyResultCodes":["VALID_EMPTY","NOT_IN_RANKING","UNSUPPORTED_MARKET","STALE_SOURCE","NO_MATCH","IDENTIFIER_INVALID","COVERAGE_UNKNOWN","PARTIAL_UNIVERSE"],"publication":{"published":true,"reason":null,"projectionReviewed":true},"returnedFieldCount":30,"costGuard":{"tier":"small","identityFilters":["code","instrument_id"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"corp.dividend","namespace":"corp","name":"dividend","coverageTags":["a_share","corporate_actions"],"description":"Dividend and distribution events.","relation":"corp.dividend","objectKind":"table","rowMagnitude":"100K-999K","grain":"ex_date × code × market","cadence":"daily","timeColumn":"ex_date","defaultOrder":["ex_date","code","market"],"filters":[{"name":"code","column":"code","required":false,"multipleValues":true,"jsonType":"string","example":"NNNN.HK","exampleSource":"identifier_format"},{"name":"market","column":"market","required":false,"multipleValues":true,"jsonType":"string","example":"HK","exampleSource":"observed_coverage","allowedValues":["HK","US"]},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":false,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":22,"fields":[{"position":1,"name":"ex_date","displayName":"ex date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for ex date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["time","default_order","warehouse_primary_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":2,"name":"code","displayName":"code","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized security or contract code.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["code"],"returned":true},{"position":3,"name":"market","displayName":"market","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Canonical market or country-market code.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["market"],"returned":true},{"position":4,"name":"source","displayName":"source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["filter","warehouse_primary_key","provenance"],"filterNames":["source"],"returned":true},{"position":5,"name":"report_date","displayName":"report date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Reporting-period or statement date.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":6,"name":"cash_div","displayName":"cash div","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: cash div.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"stk_div","displayName":"stk div","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: stk div.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"record_date","displayName":"record date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for record date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":9,"name":"pay_date","displayName":"pay date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for pay date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":10,"name":"provider","displayName":"provider","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Upstream data provider identifier.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":11,"name":"source_url","displayName":"source url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"URL of the upstream evidence or record when distributable.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":12,"name":"source_record_id","displayName":"source record id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Provider-side identifier for the source record.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":13,"name":"raw_payload_hash","displayName":"raw payload hash","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Opaque fingerprint of the normalized source payload for provenance checks.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":14,"name":"parser_version","displayName":"parser version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Version of the parser or normalizer that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":15,"name":"quality_status","displayName":"quality status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Machine-readable data-quality classification.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":16,"name":"license_scope","displayName":"license scope","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"License or redistribution scope attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":17,"name":"visibility_tier","displayName":"visibility tier","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Serving visibility tier attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":18,"name":"ingest_run_id","displayName":"ingest run id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier of the ingestion run that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":19,"name":"version","displayName":"version","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Monotonic row version used for correction-aware reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":20,"name":"is_deleted","displayName":"is deleted","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Soft-delete marker; public serving excludes current tombstones.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":21,"name":"created_at","displayName":"created at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was first created.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":22,"name":"updated_at","displayName":"updated at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was last updated.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"分红与派息事件","summaryCn":"记录证券的除权日、登记日、支付日和每股分红等分配事件，用于还原现金回报与公司行为时间线。","useCasesCn":["计算含分红总回报","在回测中避开除权造成的价格跳空","查询未来派息日程"],"grainCn":"每行代表“分红与派息事件”的一条记录；逻辑粒度由 ex_date × code × market 共同确定。","timeSemanticsCn":"以 ex_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"ex_date","meaningCn":"ex date 对应的日历日期。"},{"name":"code","meaningCn":"来源规范化后的证券、合约或指标代码。"},{"name":"market","meaningCn":"规范市场代码。"}],"joins":[{"dataset":"ref.instrument","on":"code + market（先确认代码口径）","guidanceCn":"需要补证券主数据时可按代码和市场映射；不同来源代码可能不一致，优先先查 ref.code_mapping。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 cursor，结果过大时必须缩小标的、日期或其他筛选。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":["HK","US"],"coverage":{"measured":true,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{"HK":{"latestBusinessDate":"2026-08-18","rows":12},"US":{"latestBusinessDate":"2026-08-21","rows":38}},"latestBusinessDate":"2026-08-21","note":"Recent observed coverage, not a lifetime guarantee. An unmeasured dataset carries no support claim in either direction."},"identifier":{"namespace":"mixed","formatByMarket":{"HK":"NNNN.HK","US":"TICKER"},"storesZeroPaddedHkCode":false,"stableJoinKey":"instrument_id","resolverPath":"/api/v1/data/instruments/resolve"},"sparseSemantics":null,"emptyResultCodes":["VALID_EMPTY","NOT_IN_RANKING","UNSUPPORTED_MARKET","STALE_SOURCE","NO_MATCH","IDENTIFIER_INVALID","COVERAGE_UNKNOWN","PARTIAL_UNIVERSE"],"publication":{"published":true,"reason":null,"projectionReviewed":true},"returnedFieldCount":22,"costGuard":{"tier":"medium","identityFilters":["code"],"maxWindowDays":400,"requirement":"identity filter or bounded window","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"corp.holders","namespace":"corp","name":"holders","coverageTags":["corporate_actions"],"description":"Top holder records.","relation":"corp.holders","objectKind":"table","rowMagnitude":"100K-999K","grain":"report_date × holder_name × code","cadence":"quarterly","timeColumn":"report_date","defaultOrder":["report_date","code","holder_name"],"filters":[{"name":"code","column":"code","required":false,"multipleValues":true,"jsonType":"string","example":"NNNNNN.SH or NNNNNN.SZ","exampleSource":"identifier_format"},{"name":"holder_name","column":"holder_name","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"holder_type","column":"holder_type","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"market","column":"market","required":false,"multipleValues":true,"jsonType":"string","example":"CN","exampleSource":"observed_coverage","allowedValues":["CN"]}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":false,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":22,"fields":[{"position":1,"name":"report_date","displayName":"report date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Reporting-period or statement date.","descriptionSource":"standard_glossary","roles":["time","default_order","warehouse_primary_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":2,"name":"code","displayName":"code","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized security or contract code.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["code"],"returned":true},{"position":3,"name":"holder_name","displayName":"holder name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: holder name.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["holder_name"],"returned":true},{"position":4,"name":"holder_type","displayName":"holder type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: holder type.","descriptionSource":"name_derived","roles":["filter","warehouse_primary_key"],"filterNames":["holder_type"],"returned":true},{"position":5,"name":"market","displayName":"market","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Canonical market or country-market code.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["market"],"returned":true},{"position":6,"name":"source","displayName":"source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["warehouse_primary_key","provenance"],"filterNames":[],"returned":true},{"position":7,"name":"hold_amount","displayName":"hold amount","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: hold amount.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"hold_ratio","displayName":"hold ratio","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Ratio value for hold ratio.","descriptionSource":"name_derived","roles":[],"filterNames":[],"unit":"ratio","returned":true},{"position":9,"name":"hold_change","displayName":"hold change","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: hold change.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"provider","displayName":"provider","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Upstream data provider identifier.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":11,"name":"source_url","displayName":"source url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"URL of the upstream evidence or record when distributable.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":12,"name":"source_record_id","displayName":"source record id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Provider-side identifier for the source record.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":13,"name":"raw_payload_hash","displayName":"raw payload hash","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Opaque fingerprint of the normalized source payload for provenance checks.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":14,"name":"parser_version","displayName":"parser version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Version of the parser or normalizer that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":15,"name":"quality_status","displayName":"quality status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Machine-readable data-quality classification.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":16,"name":"license_scope","displayName":"license scope","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"License or redistribution scope attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":17,"name":"visibility_tier","displayName":"visibility tier","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Serving visibility tier attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":18,"name":"ingest_run_id","displayName":"ingest run id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier of the ingestion run that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":19,"name":"version","displayName":"version","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Monotonic row version used for correction-aware reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":20,"name":"is_deleted","displayName":"is deleted","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Soft-delete marker; public serving excludes current tombstones.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":21,"name":"created_at","displayName":"created at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was first created.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":22,"name":"updated_at","displayName":"updated at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was last updated.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"前十大股东持仓","summaryCn":"按报告期保存主要股东名称、持股数量和占比，适合观察股权集中度与大股东变化。","useCasesCn":["比较相邻报告期的大股东增减持","评估股权集中度","核对公司股东结构"],"grainCn":"每行代表“前十大股东持仓”的一条记录；逻辑粒度由 report_date × holder_name × code 共同确定。","timeSemanticsCn":"以 report_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常随季度报告或持仓披露更新。","keyFields":[{"name":"report_date","meaningCn":"财务、持仓或统计报告所属日期。"},{"name":"holder_name","meaningCn":"用于确定该表业务粒度或默认顺序的 holder name 字段。"},{"name":"code","meaningCn":"来源规范化后的证券、合约或指标代码。"}],"joins":[{"dataset":"ref.instrument","on":"code + market（先确认代码口径）","guidanceCn":"需要补证券主数据时可按代码和市场映射；不同来源代码可能不一致，优先先查 ref.code_mapping。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 cursor，结果过大时必须缩小标的、日期或其他筛选。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":["CN"],"coverage":{"measured":true,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{"CN":{"latestBusinessDate":"2026-08-20","rows":20}},"latestBusinessDate":"2026-08-20","note":"Recent observed coverage, not a lifetime guarantee. An unmeasured dataset carries no support claim in either direction."},"identifier":{"namespace":"cn_numeric","formatByMarket":{"CN":"NNNNNN.SH or NNNNNN.SZ"},"storesZeroPaddedHkCode":false,"stableJoinKey":"instrument_id","resolverPath":"/api/v1/data/instruments/resolve"},"sparseSemantics":null,"emptyResultCodes":["VALID_EMPTY","NOT_IN_RANKING","UNSUPPORTED_MARKET","STALE_SOURCE","NO_MATCH","IDENTIFIER_INVALID","COVERAGE_UNKNOWN","PARTIAL_UNIVERSE"],"publication":{"published":true,"reason":null,"projectionReviewed":true},"returnedFieldCount":22,"costGuard":{"tier":"medium","identityFilters":["code"],"maxWindowDays":400,"requirement":"identity filter or bounded window","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"corp.ipo_calendar","namespace":"corp","name":"ipo_calendar","coverageTags":["corporate_actions"],"description":"Canonical Friends financial dataset: IPO 日历.","relation":"corp.ipo_calendar","objectKind":"table","rowMagnitude":"1K-9K","grain":"instrument_id × start_date × source","cadence":"daily","timeColumn":"filing_date","defaultOrder":["instrument_id","start_date","source"],"filters":[{"name":"exchange","column":"exchange","required":false,"multipleValues":true,"jsonType":"string","example":"NASDAQ"},{"name":"instrument_id","column":"instrument_id","required":false,"multipleValues":true,"jsonType":"integer","example":1},{"name":"provider","column":"provider","required":false,"multipleValues":true,"jsonType":"string","example":"PROVIDER_VALUE"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"},{"name":"symbol","column":"symbol","required":false,"multipleValues":true,"jsonType":"string","example":"AAPL"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["instrument_id","start_date","source"],"provenanceColumns":[],"fieldCount":27,"fields":[{"position":1,"name":"instrument_id","displayName":"instrument id","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"WarrenHub canonical instrument identifier; use it for cross-dataset joins.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["instrument_id"],"returned":true},{"position":2,"name":"symbol","displayName":"symbol","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Display or trading symbol for the instrument.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["symbol"],"returned":true},{"position":3,"name":"company_name","displayName":"company name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: company name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":4,"name":"exchange","displayName":"exchange","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Listing or trading exchange.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["exchange"],"returned":true},{"position":5,"name":"currency","displayName":"currency","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"ISO-like currency code for monetary values.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"start_date","displayName":"start date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for start date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":7,"name":"filing_date","displayName":"filing date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Date on which the filing was submitted or published.","descriptionSource":"standard_glossary","roles":["time"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":8,"name":"amended_date","displayName":"amended date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for amended date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":9,"name":"price_from","displayName":"price from","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: price from.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"price_to","displayName":"price to","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: price to.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"offer_price","displayName":"offer price","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Price value for offer price.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"shares","displayName":"shares","clickhouseType":"Nullable(UInt64)","jsonType":"integer","nullable":true,"description":"Source-normalized field: shares.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"deal_type","displayName":"deal type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: deal type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"provider","displayName":"provider","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Upstream data provider identifier.","descriptionSource":"standard_glossary","roles":["filter","provenance"],"filterNames":["provider"],"returned":true},{"position":15,"name":"source_url","displayName":"source url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"URL of the upstream evidence or record when distributable.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":16,"name":"source_record_id","displayName":"source record id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Provider-side identifier for the source record.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":17,"name":"raw_payload_hash","displayName":"raw payload hash","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Opaque fingerprint of the normalized source payload for provenance checks.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":18,"name":"parser_version","displayName":"parser version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Version of the parser or normalizer that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":19,"name":"quality_status","displayName":"quality status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Machine-readable data-quality classification.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":20,"name":"license_scope","displayName":"license scope","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"License or redistribution scope attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":21,"name":"visibility_tier","displayName":"visibility tier","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Serving visibility tier attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":22,"name":"ingest_run_id","displayName":"ingest run id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier of the ingestion run that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":23,"name":"version","displayName":"version","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Monotonic row version used for correction-aware reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":24,"name":"source","displayName":"source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key","provenance"],"filterNames":["source"],"returned":true},{"position":25,"name":"is_deleted","displayName":"is deleted","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Soft-delete marker; public serving excludes current tombstones.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":26,"name":"created_at","displayName":"created at","clickhouseType":"DateTime","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was first created.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":27,"name":"updated_at","displayName":"updated at","clickhouseType":"DateTime","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was last updated.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"IPO 日历","summaryCn":"这是公司行动与证券生命周期中的“IPO 日历”数据集；一行由 instrument_id、start_date、source 定位，主要字段包括 symbol、company_name、exchange、currency、filing_date。","useCasesCn":["还原公司行为和证券生命周期","在收益研究中对齐公告与生效日期"],"grainCn":"每行代表“IPO 日历”的一条记录；逻辑粒度由 instrument_id × start_date × source 共同确定。","timeSemanticsCn":"以 filing_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"start_date","meaningCn":"start date 对应的日历日期。"},{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":[],"coverage":{"measured":false,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{},"latestBusinessDate":null,"note":"Recent observed coverage, not a lifetime guarantee. An unmeasured dataset carries no support claim in either direction."},"identifier":{"namespace":"mixed","formatByMarket":{},"storesZeroPaddedHkCode":false,"stableJoinKey":"instrument_id","resolverPath":"/api/v1/data/instruments/resolve"},"sparseSemantics":null,"emptyResultCodes":["VALID_EMPTY","NOT_IN_RANKING","UNSUPPORTED_MARKET","STALE_SOURCE","NO_MATCH","IDENTIFIER_INVALID","COVERAGE_UNKNOWN","PARTIAL_UNIVERSE"],"publication":{"published":true,"reason":null,"projectionReviewed":true},"returnedFieldCount":27,"costGuard":{"tier":"small","identityFilters":["instrument_id","symbol"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"corp.pledge","namespace":"corp","name":"pledge","coverageTags":["a_share","corporate_actions"],"description":"Share pledge records.","relation":"corp.pledge","objectKind":"table","rowMagnitude":"100K-999K","grain":"ann_date × pledgor × code","cadence":"event","timeColumn":"ann_date","defaultOrder":["ann_date","code","pledgor"],"filters":[{"name":"code","column":"code","required":false,"multipleValues":true,"jsonType":"string","example":"NNNNNN.SH or NNNNNN.SZ","exampleSource":"identifier_format"},{"name":"market","column":"market","required":false,"multipleValues":true,"jsonType":"string","example":"CN","exampleSource":"observed_coverage","allowedValues":["CN"]},{"name":"pledgor","column":"pledgor","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":false,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":21,"fields":[{"position":1,"name":"ann_date","displayName":"ann date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Announcement date.","descriptionSource":"standard_glossary","roles":["time","default_order","warehouse_primary_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":2,"name":"code","displayName":"code","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized security or contract code.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["code"],"returned":true},{"position":3,"name":"pledgor","displayName":"pledgor","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: pledgor.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["pledgor"],"returned":true},{"position":4,"name":"market","displayName":"market","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Canonical market or country-market code.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["market"],"returned":true},{"position":5,"name":"source","displayName":"source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["filter","provenance"],"filterNames":["source"],"returned":true},{"position":6,"name":"pledge_count","displayName":"pledge count","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Count of pledge count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"pledge_ratio","displayName":"pledge ratio","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Ratio value for pledge ratio.","descriptionSource":"name_derived","roles":[],"filterNames":[],"unit":"ratio","returned":true},{"position":8,"name":"total_share","displayName":"total share","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total share.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"provider","displayName":"provider","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Upstream data provider identifier.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":10,"name":"source_url","displayName":"source url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"URL of the upstream evidence or record when distributable.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":11,"name":"source_record_id","displayName":"source record id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Provider-side identifier for the source record.","descriptionSource":"standard_glossary","roles":["warehouse_primary_key","provenance"],"filterNames":[],"returned":true},{"position":12,"name":"raw_payload_hash","displayName":"raw payload hash","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Opaque fingerprint of the normalized source payload for provenance checks.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":13,"name":"parser_version","displayName":"parser version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Version of the parser or normalizer that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":14,"name":"quality_status","displayName":"quality status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Machine-readable data-quality classification.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":15,"name":"license_scope","displayName":"license scope","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"License or redistribution scope attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":16,"name":"visibility_tier","displayName":"visibility tier","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Serving visibility tier attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":17,"name":"ingest_run_id","displayName":"ingest run id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier of the ingestion run that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":18,"name":"version","displayName":"version","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Monotonic row version used for correction-aware reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":19,"name":"is_deleted","displayName":"is deleted","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Soft-delete marker; public serving excludes current tombstones.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":20,"name":"created_at","displayName":"created at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was first created.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":21,"name":"updated_at","displayName":"updated at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was last updated.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"股份质押事件","summaryCn":"记录出质人、质押数量、公告日和质押状态，用于识别控股股东融资压力与潜在处置风险。","useCasesCn":["跟踪高比例质押风险","定位新增或解除质押公告","构建公司治理风险因子"],"grainCn":"每行代表“股份质押事件”的一条记录；逻辑粒度由 ann_date × pledgor × code 共同确定。","timeSemanticsCn":"以 ann_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"ann_date","meaningCn":"来源公告日期。"},{"name":"pledgor","meaningCn":"用于确定该表业务粒度或默认顺序的 pledgor 字段。"},{"name":"code","meaningCn":"来源规范化后的证券、合约或指标代码。"}],"joins":[{"dataset":"ref.instrument","on":"code + market（先确认代码口径）","guidanceCn":"需要补证券主数据时可按代码和市场映射；不同来源代码可能不一致，优先先查 ref.code_mapping。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 cursor，结果过大时必须缩小标的、日期或其他筛选。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":["CN"],"coverage":{"measured":true,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{"CN":{"latestBusinessDate":"2026-08-21","rows":1272}},"latestBusinessDate":"2026-08-21","note":"Recent observed coverage, not a lifetime guarantee. An unmeasured dataset carries no support claim in either direction."},"identifier":{"namespace":"cn_numeric","formatByMarket":{"CN":"NNNNNN.SH or NNNNNN.SZ"},"storesZeroPaddedHkCode":false,"stableJoinKey":"instrument_id","resolverPath":"/api/v1/data/instruments/resolve"},"sparseSemantics":null,"emptyResultCodes":["VALID_EMPTY","NOT_IN_RANKING","UNSUPPORTED_MARKET","STALE_SOURCE","NO_MATCH","IDENTIFIER_INVALID","COVERAGE_UNKNOWN","PARTIAL_UNIVERSE"],"publication":{"published":true,"reason":null,"projectionReviewed":true},"returnedFieldCount":21,"costGuard":{"tier":"medium","identityFilters":["code"],"maxWindowDays":400,"requirement":"identity filter or bounded window","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"corp.repurchase","namespace":"corp","name":"repurchase","coverageTags":["a_share","corporate_actions"],"description":"Share repurchase records.","relation":"corp.repurchase","objectKind":"table","rowMagnitude":"10K-99K","grain":"ann_date × code × market","cadence":"event","timeColumn":"ann_date","defaultOrder":["ann_date","code","market"],"filters":[{"name":"code","column":"code","required":false,"multipleValues":true,"jsonType":"string","example":"NNNNNN.SH or NNNNNN.SZ","exampleSource":"identifier_format"},{"name":"market","column":"market","required":false,"multipleValues":true,"jsonType":"string","example":"CN","exampleSource":"observed_coverage","allowedValues":["CN"]},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":false,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":22,"fields":[{"position":1,"name":"ann_date","displayName":"ann date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Announcement date.","descriptionSource":"standard_glossary","roles":["time","default_order","warehouse_primary_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":2,"name":"code","displayName":"code","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized security or contract code.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["code"],"returned":true},{"position":3,"name":"market","displayName":"market","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Canonical market or country-market code.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["market"],"returned":true},{"position":4,"name":"source","displayName":"source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["filter","provenance"],"filterNames":["source"],"returned":true},{"position":5,"name":"exp_date","displayName":"exp date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for exp date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":6,"name":"vol","displayName":"vol","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: vol.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"amount","displayName":"amount","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Traded notional or source-reported amount.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"high_limit","displayName":"high limit","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: high limit.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"low_limit","displayName":"low limit","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: low limit.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"provider","displayName":"provider","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Upstream data provider identifier.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":11,"name":"source_url","displayName":"source url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"URL of the upstream evidence or record when distributable.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":12,"name":"source_record_id","displayName":"source record id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Provider-side identifier for the source record.","descriptionSource":"standard_glossary","roles":["warehouse_primary_key","provenance"],"filterNames":[],"returned":true},{"position":13,"name":"raw_payload_hash","displayName":"raw payload hash","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Opaque fingerprint of the normalized source payload for provenance checks.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":14,"name":"parser_version","displayName":"parser version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Version of the parser or normalizer that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":15,"name":"quality_status","displayName":"quality status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Machine-readable data-quality classification.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":16,"name":"license_scope","displayName":"license scope","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"License or redistribution scope attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":17,"name":"visibility_tier","displayName":"visibility tier","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Serving visibility tier attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":18,"name":"ingest_run_id","displayName":"ingest run id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier of the ingestion run that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":19,"name":"version","displayName":"version","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Monotonic row version used for correction-aware reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":20,"name":"is_deleted","displayName":"is deleted","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Soft-delete marker; public serving excludes current tombstones.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":21,"name":"created_at","displayName":"created at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was first created.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":22,"name":"updated_at","displayName":"updated at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was last updated.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"股票回购事件","summaryCn":"汇总公司公告的回购计划、进展和金额数量，帮助判断资本回报动作及其执行程度。","useCasesCn":["跟踪回购计划是否落地","比较回购金额与市值","研究回购公告后的价格表现"],"grainCn":"每行代表“股票回购事件”的一条记录；逻辑粒度由 ann_date × code × market 共同确定。","timeSemanticsCn":"以 ann_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"ann_date","meaningCn":"来源公告日期。"},{"name":"code","meaningCn":"来源规范化后的证券、合约或指标代码。"},{"name":"market","meaningCn":"规范市场代码。"}],"joins":[{"dataset":"ref.instrument","on":"code + market（先确认代码口径）","guidanceCn":"需要补证券主数据时可按代码和市场映射；不同来源代码可能不一致，优先先查 ref.code_mapping。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 cursor，结果过大时必须缩小标的、日期或其他筛选。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":["CN"],"coverage":{"measured":true,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{"CN":{"latestBusinessDate":"2026-08-26","rows":1506}},"latestBusinessDate":"2026-08-26","note":"Recent observed coverage, not a lifetime guarantee. An unmeasured dataset carries no support claim in either direction."},"identifier":{"namespace":"cn_numeric","formatByMarket":{"CN":"NNNNNN.SH or NNNNNN.SZ"},"storesZeroPaddedHkCode":false,"stableJoinKey":"instrument_id","resolverPath":"/api/v1/data/instruments/resolve"},"sparseSemantics":null,"emptyResultCodes":["VALID_EMPTY","NOT_IN_RANKING","UNSUPPORTED_MARKET","STALE_SOURCE","NO_MATCH","IDENTIFIER_INVALID","COVERAGE_UNKNOWN","PARTIAL_UNIVERSE"],"publication":{"published":true,"reason":null,"projectionReviewed":true},"returnedFieldCount":22,"costGuard":{"tier":"small","identityFilters":["code"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"corp.split","namespace":"corp","name":"split","coverageTags":["corporate_actions"],"description":"Canonical Friends financial dataset: 拆股与并股事件.","relation":"corp.split","objectKind":"table","rowMagnitude":"<1K","grain":"instrument_id × execution_date × split_from × split_to","cadence":"producer_schedule","timeColumn":"publish_ts","defaultOrder":["instrument_id","execution_date","split_from","split_to"],"filters":[{"name":"instrument_id","column":"instrument_id","required":false,"multipleValues":true,"jsonType":"integer","example":1},{"name":"provider","column":"provider","required":false,"multipleValues":true,"jsonType":"string","example":"PROVIDER_VALUE"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"},{"name":"ticker","column":"ticker","required":false,"multipleValues":true,"jsonType":"string","example":"AAPL"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["instrument_id","execution_date","split_from","split_to"],"provenanceColumns":[],"fieldCount":24,"fields":[{"position":1,"name":"instrument_id","displayName":"instrument id","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"WarrenHub canonical instrument identifier; use it for cross-dataset joins.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["instrument_id"],"returned":true},{"position":2,"name":"ticker","displayName":"ticker","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Ticker symbol reported by the source or mapped security master.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["ticker"],"returned":true},{"position":3,"name":"execution_date","displayName":"execution date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for execution date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":4,"name":"adjustment_type","displayName":"adjustment type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: adjustment type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"split_from","displayName":"split from","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"Source-normalized field: split from.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":6,"name":"split_to","displayName":"split to","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"Source-normalized field: split to.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":7,"name":"split_ratio","displayName":"split ratio","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"Ratio value for split ratio.","descriptionSource":"name_derived","roles":[],"filterNames":[],"unit":"ratio","returned":true},{"position":8,"name":"is_reverse_split","displayName":"is reverse split","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Whether reverse split applies to the row.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"historical_adjustment_factor","displayName":"historical adjustment factor","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: historical adjustment factor.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"source","displayName":"source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["filter","provenance"],"filterNames":["source"],"returned":true},{"position":11,"name":"provider","displayName":"provider","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Upstream data provider identifier.","descriptionSource":"standard_glossary","roles":["filter","provenance"],"filterNames":["provider"],"returned":true},{"position":12,"name":"source_url","displayName":"source url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"URL of the upstream evidence or record when distributable.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":13,"name":"source_record_id","displayName":"source record id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Provider-side identifier for the source record.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":14,"name":"raw_payload_hash","displayName":"raw payload hash","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Opaque fingerprint of the normalized source payload for provenance checks.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":15,"name":"parser_version","displayName":"parser version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Version of the parser or normalizer that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":16,"name":"quality_status","displayName":"quality status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Machine-readable data-quality classification.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":17,"name":"license_scope","displayName":"license scope","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"License or redistribution scope attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":18,"name":"visibility_tier","displayName":"visibility tier","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Serving visibility tier attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":19,"name":"ingest_run_id","displayName":"ingest run id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier of the ingestion run that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":20,"name":"publish_ts","displayName":"publish ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC point-in-time availability timestamp used by PIT reads.","descriptionSource":"standard_glossary","roles":["time","provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":21,"name":"source_ts","displayName":"source ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"Timestamp asserted by the upstream source.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":22,"name":"ingested_at","displayName":"ingested at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the source record entered the warehouse.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":23,"name":"version","displayName":"version","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Monotonic row version used for correction-aware reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":24,"name":"is_deleted","displayName":"is deleted","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Soft-delete marker; public serving excludes current tombstones.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true}],"pit":null,"titleCn":"拆股与并股事件","summaryCn":"这是公司行动与证券生命周期中的“拆股与并股事件”数据集；一行由 instrument_id、execution_date、split_from、split_to 定位，主要字段包括 ticker、adjustment_type、split_ratio、is_reverse_split、historical_adjustment_factor。","useCasesCn":["还原公司行为和证券生命周期","在收益研究中对齐公告与生效日期"],"grainCn":"每行代表“拆股与并股事件”的一条记录；逻辑粒度由 instrument_id × execution_date × split_from × split_to 共同确定。","timeSemanticsCn":"以 publish_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"execution_date","meaningCn":"execution date 对应的日历日期。"},{"name":"split_from","meaningCn":"用于确定该表业务粒度或默认顺序的 split from 字段。"},{"name":"split_to","meaningCn":"用于确定该表业务粒度或默认顺序的 split to 字段。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":[],"coverage":{"measured":false,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{},"latestBusinessDate":null,"note":"Recent observed coverage, not a lifetime guarantee. An unmeasured dataset carries no support claim in either direction."},"identifier":{"namespace":"mixed","formatByMarket":{},"storesZeroPaddedHkCode":false,"stableJoinKey":"instrument_id","resolverPath":"/api/v1/data/instruments/resolve"},"sparseSemantics":null,"emptyResultCodes":["VALID_EMPTY","NOT_IN_RANKING","UNSUPPORTED_MARKET","STALE_SOURCE","NO_MATCH","IDENTIFIER_INVALID","COVERAGE_UNKNOWN","PARTIAL_UNIVERSE"],"publication":{"published":true,"reason":null,"projectionReviewed":true},"returnedFieldCount":24,"costGuard":{"tier":"small","identityFilters":["instrument_id","ticker"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}}]}