{"$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":"event","description":"新闻、监管披露、公司事件与催化剂。","datasetCount":67,"fieldCount":1750,"datasets":[{"object":"dataset_schema","asset":"event.analyst_rating_catalyst","namespace":"event","name":"analyst_rating_catalyst","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 分析师评级与目标价变动.","relation":"event.analyst_rating_catalyst","objectKind":"table","rowMagnitude":"100K-999K","grain":"instrument_id × event_date × firm","cadence":"daily","timeColumn":"event_date","defaultOrder":["instrument_id","event_date","change_type","period","source"],"filters":[{"name":"instrument_id","column":"instrument_id","required":false,"multipleValues":true,"jsonType":"integer","example":1},{"name":"period","column":"period","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"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","event_date","change_type","period","source"],"provenanceColumns":[],"fieldCount":26,"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":"change_type","displayName":"change type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: change type.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":3,"name":"event_date","displayName":"event date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for event date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["time","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":4,"name":"firm","displayName":"firm","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: firm.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"from_rating","displayName":"from rating","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: from rating.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"to_rating","displayName":"to rating","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: to rating.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"old_target","displayName":"old target","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: old target.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"new_target","displayName":"new target","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: new target.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"title","displayName":"title","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Human-readable title supplied or normalized from the source.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"period","displayName":"period","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Reporting or observation period label.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["period"],"returned":true},{"position":11,"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":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":12,"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":13,"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":14,"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":15,"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":16,"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":17,"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":18,"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":19,"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":20,"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":21,"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":22,"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":23,"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":24,"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":25,"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":26,"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、event_date、change_type、period 定位，主要字段包括 firm、from_rating、to_rating、old_target、new_target。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“分析师评级与目标价变动”的一条记录；逻辑粒度由 instrument_id × event_date × firm 共同确定。","timeSemanticsCn":"以 event_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"event_date","meaningCn":"event date 对应的日历日期。"},{"name":"firm","meaningCn":"用于确定该表业务粒度或默认顺序的 firm 字段。"},{"name":"change_type","meaningCn":"用于确定该表业务粒度或默认顺序的 change type 字段。"},{"name":"period","meaningCn":"财务或统计所属期间。"},{"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":26,"costGuard":{"tier":"small","identityFilters":["instrument_id"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.bankruptcy_filing","namespace":"event","name":"bankruptcy_filing","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 破产申请事件.","relation":"event.bankruptcy_filing","objectKind":"table","rowMagnitude":"<1K","grain":"instrument_id × date_filed × docket_id × source","cadence":"producer_schedule","timeColumn":"publish_ts","defaultOrder":["instrument_id","date_filed","docket_id","source"],"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"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["instrument_id","date_filed","docket_id","source"],"provenanceColumns":[],"fieldCount":23,"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":"debtor_name","displayName":"debtor name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: debtor name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":3,"name":"court_id","displayName":"court id","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Identifier for court.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":4,"name":"chapter","displayName":"chapter","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: chapter.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"case_number","displayName":"case number","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: case number.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"docket_id","displayName":"docket id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for docket.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":7,"name":"date_filed","displayName":"date filed","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Source-normalized field: date filed.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","returned":true},{"position":8,"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":9,"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":10,"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":11,"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":12,"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":13,"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":14,"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":15,"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":16,"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":17,"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":18,"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":19,"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":20,"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":21,"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":22,"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":23,"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、date_filed、docket_id、source 定位，主要字段包括 debtor_name、court_id、chapter、case_number、publish_ts。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“破产申请事件”的一条记录；逻辑粒度由 instrument_id × date_filed × docket_id × source 共同确定。","timeSemanticsCn":"以 publish_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"date_filed","meaningCn":"用于确定该表业务粒度或默认顺序的 date filed 字段。"},{"name":"docket_id","meaningCn":"用于识别 docket 的业务标识。"},{"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":23,"costGuard":{"tier":"small","identityFilters":["instrument_id"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.calendar_forward","namespace":"event","name":"calendar_forward","coverageTags":["news_events"],"description":"Forward event calendar.","relation":"event.calendar_forward","objectKind":"table","rowMagnitude":"<1K","grain":"cal_id × expected_ts × event_code","cadence":"event","timeColumn":"expected_ts","defaultOrder":["expected_ts","event_code","cal_id"],"filters":[{"name":"event_code","column":"event_code","required":false,"multipleValues":true,"jsonType":"string","example":"EVENT_CODE"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"},{"name":"target","column":"target","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":21,"fields":[{"position":1,"name":"cal_id","displayName":"cal id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for cal.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key"],"filterNames":[],"returned":true},{"position":2,"name":"event_code","displayName":"event code","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: event code.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["event_code"],"returned":true},{"position":3,"name":"expected_ts","displayName":"expected ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for expected ts.","descriptionSource":"name_derived","roles":["time","default_order","warehouse_primary_key"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":4,"name":"target","displayName":"target","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: target.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["target"],"returned":true},{"position":5,"name":"description","displayName":"description","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Human-readable description supplied or normalized from the source.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"confirmed","displayName":"confirmed","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: confirmed.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"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":8,"name":"metadata","displayName":"metadata","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: metadata.","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":["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":"每行代表“前瞻事件日历”的一条记录；逻辑粒度由 cal_id × expected_ts × event_code 共同确定。","timeSemanticsCn":"以 expected_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"cal_id","meaningCn":"用于识别 cal 的业务标识。"},{"name":"expected_ts","meaningCn":"expected ts 对应的时间戳；除表内特别说明外按 UTC 解释。"},{"name":"event_code","meaningCn":"用于确定该表业务粒度或默认顺序的 event code 字段。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"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":21,"costGuard":{"tier":"small","identityFilters":[],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.candidate","namespace":"event","name":"candidate","coverageTags":["news_events"],"description":"KairoX strategy candidates built from catalysts, narrative spread, and market confirmation.","relation":"event.candidate","objectKind":"table","rowMagnitude":"0","grain":"candidate_id × candidate_ts","cadence":"event","timeColumn":"candidate_ts","defaultOrder":["candidate_ts","strategy_lane","candidate_id"],"filters":[{"name":"candidate_id","column":"candidate_id","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"entity_id","column":"entity_id","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"event_subtype","column":"event_subtype","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"event_type","column":"event_type","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"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"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"},{"name":"source_doc_id","column":"source_doc_id","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"source_event_id","column":"source_event_id","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"status","column":"status","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"strategy_lane","column":"strategy_lane","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_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":[],"provenanceColumns":[],"fieldCount":41,"fields":[{"position":1,"name":"candidate_id","displayName":"candidate id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for candidate.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["candidate_id"],"returned":true},{"position":2,"name":"candidate_ts","displayName":"candidate ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for candidate ts.","descriptionSource":"name_derived","roles":["time","default_order"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":3,"name":"first_seen_ts","displayName":"first seen ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for first seen ts.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":4,"name":"last_seen_ts","displayName":"last seen ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for last seen ts.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":5,"name":"strategy_lane","displayName":"strategy lane","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: strategy lane.","descriptionSource":"name_derived","roles":["filter","default_order"],"filterNames":["strategy_lane"],"returned":true},{"position":6,"name":"status","displayName":"status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: status.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["status"],"returned":true},{"position":7,"name":"event_type","displayName":"event type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: event type.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["event_type"],"returned":true},{"position":8,"name":"event_subtype","displayName":"event subtype","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: event subtype.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["event_subtype"],"returned":true},{"position":9,"name":"priority_score","displayName":"priority score","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: priority score.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"novelty_score","displayName":"novelty score","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: novelty score.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"urgency_score","displayName":"urgency score","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: urgency score.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"confidence","displayName":"confidence","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: confidence.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"instrument_id","displayName":"instrument id","clickhouseType":"Nullable(UInt64)","jsonType":"integer","nullable":true,"description":"WarrenHub canonical instrument identifier; use it for cross-dataset joins.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["instrument_id"],"returned":true},{"position":14,"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":15,"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":16,"name":"asset_key","displayName":"asset key","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: asset key.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"name":"asset_type","displayName":"asset type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Instrument asset-class classification.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":18,"name":"entity_id","displayName":"entity id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for entity.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["entity_id"],"returned":true},{"position":19,"name":"source_event_id","displayName":"source event id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for source event.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["source_event_id"],"returned":true},{"position":20,"name":"source_doc_id","displayName":"source doc id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for source doc.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["source_doc_id"],"returned":true},{"position":21,"name":"primary_source","displayName":"primary source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: primary source.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":22,"name":"title","displayName":"title","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Human-readable title supplied or normalized from the source.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":23,"name":"summary","displayName":"summary","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: summary.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":24,"name":"thesis_hint","displayName":"thesis hint","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: thesis hint.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":25,"name":"url","displayName":"url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Canonical URL attached to the record.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":26,"name":"tags","displayName":"tags","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: tags.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":27,"name":"metadata","displayName":"metadata","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: metadata.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":28,"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":29,"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":30,"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":31,"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":32,"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":33,"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":34,"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":35,"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":36,"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":37,"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":38,"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":39,"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":40,"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":41,"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":"KairoX 策略候选事件","summaryCn":"将催化剂、叙事扩散和市场确认组合成可研究的策略候选，保留候选生成时点与状态。","useCasesCn":["查看策略雷达为何产生候选","追踪候选从出现到确认的过程","联接证据包复盘决策"],"grainCn":"每行代表“KairoX 策略候选事件”的一条记录；逻辑粒度由 candidate_id × candidate_ts 共同确定。","timeSemanticsCn":"以 candidate_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"candidate_id","meaningCn":"策略候选标识；可联接 event.candidate 与 event.evidence_bundle。"},{"name":"candidate_ts","meaningCn":"candidate ts 对应的时间戳；除表内特别说明外按 UTC 解释。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"},{"dataset":"event.source_document","on":"source_doc_id","guidanceCn":"用文档标识回溯标准化原文和来源信息；先核对两表字段口径。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["字典采样时该关系可能为空；先查询 catalog 或小范围 rows 判断当前是否已有数据。"],"supportedMarkets":[],"coverage":{"measured":true,"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":41,"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":"event.catalyst_biotech","namespace":"event","name":"catalyst_biotech","coverageTags":["news_events"],"description":"Forward biotech catalysts (FDA adcomm + clinicaltrials.gov trial readouts).","relation":"event.catalyst_biotech","objectKind":"view","rowMagnitude":"view","grain":"event_date × instrument_id","cadence":"producer_schedule","timeColumn":"event_date","defaultOrder":["event_date","instrument_id"],"filters":[{"name":"catalyst_type","column":"catalyst_type","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"instrument_id","column":"instrument_id","required":false,"multipleValues":true,"jsonType":"integer","example":1}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":false,"readMode":"relation_default","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":9,"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"],"filterNames":["instrument_id"],"returned":true},{"position":2,"name":"catalyst_type","displayName":"catalyst type","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: catalyst type.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["catalyst_type"],"returned":true},{"position":3,"name":"event_date","displayName":"event date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for event date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["time","default_order"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":4,"name":"title","displayName":"title","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Human-readable title supplied or normalized from the source.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"sponsor_name","displayName":"sponsor name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: sponsor name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"status","displayName":"status","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: status.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"phase","displayName":"phase","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: phase.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"source_table","displayName":"source table","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: source table.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"source_ref","displayName":"source ref","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: source ref.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true}],"pit":null,"titleCn":"生物医药前瞻催化剂","summaryCn":"汇总 FDA 顾问委员会、临床试验读出等未来生物医药事件，并映射到证券与事件日期。","useCasesCn":["查询药企未来临床读出","构建 FDA 事件观察清单","评估催化剂前后的波动风险"],"grainCn":"每行代表“生物医药前瞻催化剂”的一条记录；逻辑粒度由 event_date × instrument_id 共同确定。","timeSemanticsCn":"以 event_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"event_date","meaningCn":"event date 对应的日历日期。"},{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 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":9,"costGuard":{"tier":"small","identityFilters":["instrument_id"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"UNCLASSIFIED","deniedSources":[],"reasons":["no_observed_source_and_no_source_column"]}},{"object":"dataset_schema","asset":"event.catalyst_calendar","namespace":"event","name":"catalyst_calendar","coverageTags":["news_events"],"description":"Unified forward catalyst calendar (earnings/biotech/index/ipo/...).","relation":"event.catalyst_calendar","objectKind":"view","rowMagnitude":"view","grain":"event_date × instrument_id","cadence":"producer_schedule","timeColumn":"event_date","defaultOrder":["event_date","instrument_id"],"filters":[{"name":"catalyst_class","column":"catalyst_class","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"catalyst_type","column":"catalyst_type","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"instrument_id","column":"instrument_id","required":false,"multipleValues":true,"jsonType":"integer","example":1}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":false,"readMode":"relation_default","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":8,"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"],"filterNames":["instrument_id"],"returned":true},{"position":2,"name":"catalyst_class","displayName":"catalyst class","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: catalyst class.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["catalyst_class"],"returned":true},{"position":3,"name":"catalyst_type","displayName":"catalyst type","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: catalyst type.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["catalyst_type"],"returned":true},{"position":4,"name":"event_date","displayName":"event date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for event date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["time","default_order"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":5,"name":"title","displayName":"title","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Human-readable title supplied or normalized from the source.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"source_table","displayName":"source table","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: source table.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"source_ref","displayName":"source ref","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: source ref.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"symbol","displayName":"symbol","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Display or trading symbol for the instrument.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true}],"pit":null,"titleCn":"统一催化剂日历","summaryCn":"把财报、生物医药、指数调整、IPO 等多类未来事件统一到日期和证券维度。","useCasesCn":["生成跨类型催化剂日历","筛选某只股票的未来事件","规划事件驱动研究优先级"],"grainCn":"每行代表“统一催化剂日历”的一条记录；逻辑粒度由 event_date × instrument_id 共同确定。","timeSemanticsCn":"以 event_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"event_date","meaningCn":"event date 对应的日历日期。"},{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 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":8,"costGuard":{"tier":"small","identityFilters":["instrument_id"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"UNCLASSIFIED","deniedSources":[],"reasons":["no_observed_source_and_no_source_column"]}},{"object":"dataset_schema","asset":"event.clinical_trial_pit","namespace":"event","name":"clinical_trial_pit","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 临床试验时点快照.","relation":"event.clinical_trial_pit","objectKind":"table","rowMagnitude":"10K-99K","grain":"nct_id × snapshot_date","cadence":"daily","timeColumn":"snapshot_date","defaultOrder":["nct_id","snapshot_date","source"],"filters":[{"name":"instrument_id","column":"instrument_id","required":false,"multipleValues":true,"jsonType":"integer","example":1},{"name":"nct_id","column":"nct_id","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"provider","column":"provider","required":false,"multipleValues":true,"jsonType":"string","example":"PROVIDER_VALUE"},{"name":"snapshot_date","column":"snapshot_date","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":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["nct_id","snapshot_date","source"],"provenanceColumns":[],"fieldCount":32,"fields":[{"position":1,"name":"nct_id","displayName":"nct id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for nct.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["nct_id"],"returned":true},{"position":2,"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"],"filterNames":["instrument_id"],"returned":true},{"position":3,"name":"sponsor_name","displayName":"sponsor name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: sponsor name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":4,"name":"sponsor_class","displayName":"sponsor class","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: sponsor class.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"brief_title","displayName":"brief title","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: brief title.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"phase","displayName":"phase","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: phase.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"overall_status","displayName":"overall status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: overall status.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"study_type","displayName":"study type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: study type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"primary_completion_date","displayName":"primary completion date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for primary completion date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":10,"name":"primary_completion_date_type","displayName":"primary completion date type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: primary completion date type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"completion_date","displayName":"completion date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for completion date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":12,"name":"results_first_post_date","displayName":"results first post date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for results first post date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":13,"name":"has_results","displayName":"has results","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Whether results applies to the row.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"conditions","displayName":"conditions","clickhouseType":"Array(String)","jsonType":"array","nullable":false,"description":"Source-normalized field: conditions.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"interventions","displayName":"interventions","clickhouseType":"Array(String)","jsonType":"array","nullable":false,"description":"Source-normalized field: interventions.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"snapshot_date","displayName":"snapshot date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for snapshot date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["time","filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["snapshot_date"],"jsonFormat":"date","unit":"date","returned":true},{"position":17,"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":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":18,"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":19,"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":20,"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":21,"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":22,"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":23,"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":24,"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":25,"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":26,"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":27,"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":28,"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":29,"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":30,"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":31,"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":32,"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":"这是公告、新闻与可交易事件中的“临床试验时点快照”数据集；一行由 nct_id、snapshot_date、source 定位，主要字段包括 instrument_id、sponsor_name、sponsor_class、brief_title、phase。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“临床试验时点快照”的一条记录；逻辑粒度由 nct_id × snapshot_date 共同确定。","timeSemanticsCn":"以 snapshot_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"nct_id","meaningCn":"用于识别 nct 的业务标识。"},{"name":"snapshot_date","meaningCn":"snapshot 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":32,"costGuard":{"tier":"small","identityFilters":["instrument_id"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.cn_earnings_guidance","namespace":"event","name":"cn_earnings_guidance","coverageTags":["a_share","news_events"],"description":"Canonical Friends financial dataset: A 股业绩预告.","relation":"event.cn_earnings_guidance","objectKind":"table","rowMagnitude":"10K-99K","grain":"code × report_period × guidance_type × ann_date × source","cadence":"producer_schedule","timeColumn":"report_period","defaultOrder":["code","report_period","guidance_type","ann_date","source"],"filters":[{"name":"code","column":"code","required":false,"multipleValues":true,"jsonType":"string","example":"AAPL"},{"name":"market","column":"market","required":false,"multipleValues":true,"jsonType":"string","example":"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":["code","report_period","guidance_type","ann_date","source"],"provenanceColumns":[],"fieldCount":37,"fields":[{"position":1,"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","contract_unique_key"],"filterNames":["code"],"returned":true},{"position":2,"name":"report_period","displayName":"report period","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Source-normalized field: report period.","descriptionSource":"name_derived","roles":["time","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","returned":true},{"position":3,"name":"guidance_type","displayName":"guidance type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: guidance type.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":4,"name":"ann_date","displayName":"ann date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Announcement date.","descriptionSource":"standard_glossary","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":5,"name":"first_ann_date","displayName":"first ann date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for first ann date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":6,"name":"forecast_type","displayName":"forecast type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: forecast type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"p_change_min","displayName":"p change min","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: p change min.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"p_change_max","displayName":"p change max","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: p change max.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"net_profit_min","displayName":"net profit min","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: net profit min.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"net_profit_max","displayName":"net profit max","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: net profit max.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"last_parent_net","displayName":"last parent net","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: last parent net.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"revenue","displayName":"revenue","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: revenue.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"operate_profit","displayName":"operate profit","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: operate profit.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"total_profit","displayName":"total profit","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total profit.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"n_income","displayName":"n income","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Count of income.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"total_assets","displayName":"total assets","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total assets.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"name":"total_hldr_eqy_exc_min_int","displayName":"total hldr eqy exc min int","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total hldr eqy exc min int.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":18,"name":"diluted_eps","displayName":"diluted eps","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: diluted eps.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":19,"name":"diluted_roe","displayName":"diluted roe","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: diluted roe.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":20,"name":"yoy_net_profit","displayName":"yoy net profit","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: yoy net profit.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":21,"name":"bps","displayName":"bps","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: bps.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":22,"name":"summary","displayName":"summary","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: summary.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":23,"name":"change_reason","displayName":"change reason","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: change reason.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":24,"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":25,"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":26,"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":27,"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":28,"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":29,"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":30,"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":31,"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":32,"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":33,"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":34,"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":35,"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":36,"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":37,"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}],"pit":null,"titleCn":"A 股业绩预告","summaryCn":"汇总 A 股上市公司的业绩预告类型、预计净利润区间和同比变动区间，用于在正式财报前识别盈利上修或下修；一行由 code、report_period、guidance_type、ann_date 定位，主要字段包括 first_ann_date、forecast_type、p_change_min、p_change_max、net_profit_min。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“A 股业绩预告”的一条记录；逻辑粒度由 code × report_period × guidance_type × ann_date × source 共同确定。","timeSemanticsCn":"以 report_period 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"code","meaningCn":"来源规范化后的证券、合约或指标代码。"},{"name":"report_period","meaningCn":"用于确定该表业务粒度或默认顺序的 report period 字段。"},{"name":"guidance_type","meaningCn":"用于确定该表业务粒度或默认顺序的 guidance type 字段。"},{"name":"ann_date","meaningCn":"来源公告日期。"},{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"}],"joins":[{"dataset":"ref.instrument","on":"code + market（先确认代码口径）","guidanceCn":"需要补证券主数据时可按代码和市场映射；不同来源代码可能不一致，优先先查 ref.code_mapping。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":[],"coverage":{"measured":true,"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":37,"costGuard":{"tier":"small","identityFilters":["code"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.cn_suspension","namespace":"event","name":"cn_suspension","coverageTags":["a_share","news_events"],"description":"Canonical Friends financial dataset: A 股停复牌事件.","relation":"event.cn_suspension","objectKind":"table","rowMagnitude":"1K-9K","grain":"trade_date × code × suspend_type × source","cadence":"producer_schedule","timeColumn":"trade_date","defaultOrder":["trade_date","code","suspend_type","source"],"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":"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":"trade_date","column":"trade_date","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["trade_date","code","suspend_type","source"],"provenanceColumns":[],"fieldCount":18,"fields":[{"position":1,"name":"trade_date","displayName":"trade date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Trading-session date in the dataset's market calendar.","descriptionSource":"standard_glossary","roles":["time","filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["trade_date"],"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","contract_unique_key"],"filterNames":["code"],"returned":true},{"position":3,"name":"suspend_timing","displayName":"suspend timing","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: suspend timing.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":4,"name":"suspend_type","displayName":"suspend type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: suspend type.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"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":["filter","default_order","warehouse_primary_key","contract_unique_key","provenance"],"filterNames":["source"],"returned":true},{"position":7,"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":8,"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":9,"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":10,"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":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}],"pit":null,"titleCn":"A 股停复牌事件","summaryCn":"记录 A 股证券每日停牌、复牌及盘中停牌类型，用于过滤不可交易时段并还原事件影响窗口；一行由 trade_date、code、suspend_type、source 定位，主要字段包括 suspend_timing、market、ingested_at、provider、source_url。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“A 股停复牌事件”的一条记录；逻辑粒度由 trade_date × code × suspend_type × source 共同确定。","timeSemanticsCn":"以 trade_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"trade_date","meaningCn":"对应市场日历中的交易日。"},{"name":"code","meaningCn":"来源规范化后的证券、合约或指标代码。"},{"name":"suspend_type","meaningCn":"用于确定该表业务粒度或默认顺序的 suspend type 字段。"},{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"}],"joins":[{"dataset":"ref.instrument","on":"code + market（先确认代码口径）","guidanceCn":"需要补证券主数据时可按代码和市场映射；不同来源代码可能不一致，优先先查 ref.code_mapping。"},{"dataset":"ref.calendar","on":"market + trade_date（有 market 时）","guidanceCn":"需要计算交易日偏移时联接交易日历；无 market 字段时先确定适用市场。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":["CN"],"coverage":{"measured":true,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{"CN":{"latestBusinessDate":"2026-08-26","rows":145}},"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":18,"costGuard":{"tier":"small","identityFilters":["code"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.congress_trade","namespace":"event","name":"congress_trade","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 美国国会议员交易.","relation":"event.v_congress_trade_dedup","objectKind":"view","rowMagnitude":"view","grain":"instrument_id × transaction_date × member_name × transaction_type × source_record_id","cadence":"producer_schedule","timeColumn":"transaction_date","defaultOrder":["instrument_id","transaction_date","member_name","transaction_type","source_record_id"],"filters":[{"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"},{"name":"transaction_type","column":"transaction_type","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"relation_default","contractVersion":null,"uniqueKey":["instrument_id","transaction_date","member_name","transaction_type","source_record_id"],"provenanceColumns":[],"fieldCount":29,"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","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":"member_name","displayName":"member name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: member name.","descriptionSource":"name_derived","roles":["default_order","contract_unique_key"],"filterNames":[],"returned":true},{"position":5,"name":"chamber","displayName":"chamber","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: chamber.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"party","displayName":"party","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: party.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"state","displayName":"state","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: state.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"transaction_date","displayName":"transaction date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for transaction date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["time","default_order","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":9,"name":"disclosure_date","displayName":"disclosure date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for disclosure date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":10,"name":"transaction_type","displayName":"transaction type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: transaction type.","descriptionSource":"name_derived","roles":["filter","default_order","contract_unique_key"],"filterNames":["transaction_type"],"returned":true},{"position":11,"name":"amount_range_min","displayName":"amount range min","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: amount range min.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"amount_range_max","displayName":"amount range max","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: amount range max.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"asset_type","displayName":"asset type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Instrument asset-class classification.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":14,"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":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":15,"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":16,"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":17,"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":18,"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":19,"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":20,"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":["default_order","contract_unique_key","provenance"],"filterNames":[],"returned":true},{"position":21,"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":22,"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":23,"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":24,"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":25,"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":26,"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":27,"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":28,"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":29,"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、transaction_date、member_name、transaction_type 定位，主要字段包括 code、market、chamber、party、state。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“美国国会议员交易”的一条记录；逻辑粒度由 instrument_id × transaction_date × member_name × transaction_type × source_record_id 共同确定。","timeSemanticsCn":"以 transaction_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"transaction_date","meaningCn":"transaction date 对应的日历日期。"},{"name":"member_name","meaningCn":"用于确定该表业务粒度或默认顺序的 member name 字段。"},{"name":"transaction_type","meaningCn":"用于确定该表业务粒度或默认顺序的 transaction type 字段。"},{"name":"source_record_id","meaningCn":"用于识别 source record 的业务标识。"}],"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-14","rows":74}},"latestBusinessDate":"2026-08-14","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":29,"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":"event.corporate_lobbying","namespace":"event","name":"corporate_lobbying","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 企业游说披露.","relation":"event.corporate_lobbying","objectKind":"table","rowMagnitude":"100K-999K","grain":"registrant × client × instrument_id × lobby_date × source_record_id","cadence":"quarterly","timeColumn":"publish_ts","defaultOrder":["instrument_id","lobby_date","source_record_id"],"filters":[{"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","lobby_date","source_record_id"],"provenanceColumns":[],"fieldCount":25,"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":"client","displayName":"client","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: client.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"registrant","displayName":"registrant","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: registrant.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"issue","displayName":"issue","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: issue.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"specific_issue","displayName":"specific issue","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: specific issue.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"amount_usd","displayName":"amount usd","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"US-dollar value for amount usd.","descriptionSource":"name_derived","roles":[],"filterNames":[],"unit":"USD","returned":true},{"position":9,"name":"lobby_date","displayName":"lobby date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for lobby date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":10,"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":11,"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":12,"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":13,"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":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":["default_order","warehouse_primary_key","contract_unique_key","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":"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":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}],"pit":null,"titleCn":"企业游说披露","summaryCn":"这是公告、新闻与可交易事件中的“企业游说披露”数据集；一行由 instrument_id、lobby_date、source_record_id 定位，主要字段包括 code、market、client、registrant、issue。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“企业游说披露”的一条记录；逻辑粒度由 registrant × client × instrument_id × lobby_date × source_record_id 共同确定。","timeSemanticsCn":"以 publish_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常随季度报告或持仓披露更新。","keyFields":[{"name":"registrant","meaningCn":"用于确定该表业务粒度或默认顺序的 registrant 字段。"},{"name":"client","meaningCn":"用于确定该表业务粒度或默认顺序的 client 字段。"},{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"lobby_date","meaningCn":"lobby date 对应的日历日期。"},{"name":"source_record_id","meaningCn":"用于识别 source record 的业务标识。"}],"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-07-31","rows":12}},"latestBusinessDate":"2026-07-31","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":25,"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":"event.corporate_political_donation","namespace":"event","name":"corporate_political_donation","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 企业政治捐赠.","relation":"event.corporate_political_donation","objectKind":"table","rowMagnitude":"100K-999K","grain":"instrument_id × company_cmte_id × bioguide_id × cycle × transaction_amount × source","cadence":"event","timeColumn":"transaction_date","defaultOrder":["instrument_id","company_cmte_id","bioguide_id","cycle","transaction_amount","source"],"filters":[{"name":"code","column":"code","required":false,"multipleValues":true,"jsonType":"string","example":"AAPL"},{"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"},{"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":"transaction_type","column":"transaction_type","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["instrument_id","company_cmte_id","bioguide_id","cycle","transaction_amount","source"],"provenanceColumns":[],"fieldCount":29,"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":"bioguide_id","displayName":"bioguide id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for bioguide.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":5,"name":"candidate_name","displayName":"candidate name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: candidate name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"committee_name","displayName":"committee name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: committee name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"company_pac_name","displayName":"company pac name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: company pac name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"company_cmte_id","displayName":"company cmte id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for company cmte.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":9,"name":"transaction_amount","displayName":"transaction amount","clickhouseType":"Int64","jsonType":"integer","nullable":false,"description":"Source-normalized field: transaction amount.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":10,"name":"transaction_date","displayName":"transaction date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for transaction date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["time"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":11,"name":"cycle","displayName":"cycle","clickhouseType":"UInt16","jsonType":"integer","nullable":false,"description":"Source-normalized field: cycle.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":12,"name":"transaction_type","displayName":"transaction type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: transaction type.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["transaction_type"],"returned":true},{"position":13,"name":"uploaded_at","displayName":"uploaded at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for uploaded at.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":14,"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":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":15,"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":16,"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":17,"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":18,"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":19,"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":20,"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":21,"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":22,"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":23,"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":24,"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":25,"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":26,"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":27,"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":28,"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":29,"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、company_cmte_id、bioguide_id、cycle 定位，主要字段包括 code、market、candidate_name、committee_name、company_pac_name。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“企业政治捐赠”的一条记录；逻辑粒度由 instrument_id × company_cmte_id × bioguide_id × cycle × transaction_amount × source 共同确定。","timeSemanticsCn":"以 transaction_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"company_cmte_id","meaningCn":"用于识别 company cmte 的业务标识。"},{"name":"bioguide_id","meaningCn":"用于识别 bioguide 的业务标识。"},{"name":"cycle","meaningCn":"用于确定该表业务粒度或默认顺序的 cycle 字段。"},{"name":"transaction_amount","meaningCn":"用于确定该表业务粒度或默认顺序的 transaction amount 字段。"},{"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":true,"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":29,"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":"event.earnings_date_revision","namespace":"event","name":"earnings_date_revision","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 财报日期修订.","relation":"event.earnings_date_revision","objectKind":"table","rowMagnitude":"100K-999K","grain":"instrument_id × fiscal_period_end × new_report_date × source","cadence":"daily","timeColumn":"publish_ts","defaultOrder":["instrument_id","fiscal_period_end","new_report_date","source"],"filters":[{"name":"direction","column":"direction","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"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"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["instrument_id","fiscal_period_end","new_report_date","source"],"provenanceColumns":[],"fieldCount":30,"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":"fiscal_period_end","displayName":"fiscal period end","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Source-normalized field: fiscal period end.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","returned":true},{"position":3,"name":"prior_report_date","displayName":"prior report date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for prior report date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":4,"name":"new_report_date","displayName":"new report date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for new report date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":5,"name":"days_moved","displayName":"days moved","clickhouseType":"Int32","jsonType":"integer","nullable":false,"description":"Source-normalized field: days moved.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"direction","displayName":"direction","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: direction.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["direction"],"returned":true},{"position":7,"name":"detected_date","displayName":"detected date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for detected date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":8,"name":"title","displayName":"title","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Human-readable title supplied or normalized from the source.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":9,"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":10,"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":11,"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":12,"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":13,"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":14,"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":15,"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":16,"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":17,"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":18,"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":19,"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":20,"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":21,"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":22,"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":23,"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":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},{"position":25,"name":"upstream_source","displayName":"upstream source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: upstream source.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"not in the reviewed output projection"},{"position":26,"name":"upstream_declared_publish_ts","displayName":"upstream declared publish ts","clickhouseType":"Nullable(DateTime64(3, 'UTC'))","jsonType":"string","nullable":true,"description":"UTC timestamp for upstream declared publish ts.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":false,"withheldReason":"not in the reviewed output projection"},{"position":27,"name":"upstream_first_observed_at","displayName":"upstream first observed at","clickhouseType":"Nullable(DateTime64(3, 'UTC'))","jsonType":"string","nullable":true,"description":"UTC timestamp for upstream first observed at.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":false,"withheldReason":"not in the reviewed output projection"},{"position":28,"name":"publish_ts_basis","displayName":"publish ts basis","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: publish ts basis.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"not in the reviewed output projection"},{"position":29,"name":"source_ts_basis","displayName":"source ts basis","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: source ts basis.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"not in the reviewed output projection"},{"position":30,"name":"provenance_status","displayName":"provenance status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: provenance status.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"not in the reviewed output projection"}],"pit":null,"titleCn":"财报日期修订","summaryCn":"这是公告、新闻与可交易事件中的“财报日期修订”数据集；一行由 instrument_id、fiscal_period_end、new_report_date、source 定位，主要字段包括 prior_report_date、days_moved、direction、detected_date、title。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“财报日期修订”的一条记录；逻辑粒度由 instrument_id × fiscal_period_end × new_report_date × source 共同确定。","timeSemanticsCn":"以 publish_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"fiscal_period_end","meaningCn":"用于确定该表业务粒度或默认顺序的 fiscal period end 字段。"},{"name":"new_report_date","meaningCn":"new report 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":24,"costGuard":{"tier":"small","identityFilters":["instrument_id"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.earnings_date_vintage","namespace":"event","name":"earnings_date_vintage","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 财报日期历史快照.","relation":"event.earnings_date_vintage","objectKind":"table","rowMagnitude":"10M-99M","grain":"instrument_id × report_date × fiscal_period_end × snapshot_date × source","cadence":"daily","timeColumn":"report_date","defaultOrder":["instrument_id","fiscal_period_end","snapshot_date","source"],"filters":[{"name":"code","column":"code","required":false,"multipleValues":true,"jsonType":"string","example":"TICKER","exampleSource":"identifier_format"},{"name":"instrument_id","column":"instrument_id","required":true,"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":"snapshot_date","column":"snapshot_date","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":400,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["instrument_id","fiscal_period_end","snapshot_date","source"],"provenanceColumns":[],"fieldCount":28,"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","required_filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["instrument_id"],"returned":true},{"position":2,"name":"fiscal_period_end","displayName":"fiscal period end","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Source-normalized field: fiscal period end.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","returned":true},{"position":3,"name":"report_date","displayName":"report date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Reporting-period or statement date.","descriptionSource":"standard_glossary","roles":["time"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":4,"name":"snapshot_date","displayName":"snapshot date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for snapshot date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["snapshot_date"],"jsonFormat":"date","unit":"date","returned":true},{"position":5,"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":6,"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":7,"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":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":8,"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":9,"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":10,"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":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":"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":21,"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":22,"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":23,"name":"upstream_source","displayName":"upstream source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: upstream source.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"not in the reviewed output projection"},{"position":24,"name":"upstream_declared_publish_ts","displayName":"upstream declared publish ts","clickhouseType":"Nullable(DateTime64(3, 'UTC'))","jsonType":"string","nullable":true,"description":"UTC timestamp for upstream declared publish ts.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":false,"withheldReason":"not in the reviewed output projection"},{"position":25,"name":"upstream_first_observed_at","displayName":"upstream first observed at","clickhouseType":"Nullable(DateTime64(3, 'UTC'))","jsonType":"string","nullable":true,"description":"UTC timestamp for upstream first observed at.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":false,"withheldReason":"not in the reviewed output projection"},{"position":26,"name":"publish_ts_basis","displayName":"publish ts basis","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: publish ts basis.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"not in the reviewed output projection"},{"position":27,"name":"source_ts_basis","displayName":"source ts basis","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: source ts basis.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"not in the reviewed output projection"},{"position":28,"name":"provenance_status","displayName":"provenance status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: provenance status.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"not in the reviewed output projection"}],"pit":null,"titleCn":"财报日期历史快照","summaryCn":"这是公告、新闻与可交易事件中的“财报日期历史快照”数据集；一行由 instrument_id、fiscal_period_end、snapshot_date、source 定位，主要字段包括 report_date、code、market、publish_ts、source_ts。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“财报日期历史快照”的一条记录；逻辑粒度由 instrument_id × report_date × fiscal_period_end × snapshot_date × source 共同确定。","timeSemanticsCn":"以 report_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"report_date","meaningCn":"财务、持仓或统计报告所属日期。"},{"name":"fiscal_period_end","meaningCn":"用于确定该表业务粒度或默认顺序的 fiscal period end 字段。"},{"name":"snapshot_date","meaningCn":"snapshot date 对应的日历日期。"},{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；必须提供 instrument_id；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["该关系数据量较大，必须提供 instrument_id；这只限制单次扫描，不减少可访问历史。","单次请求的 start/end 最长 400 天；全历史请按时间窗连续分页。"],"supportedMarkets":["US"],"coverage":{"measured":true,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{"US":{"latestBusinessDate":"2027-02-18","rows":336610}},"latestBusinessDate":"2027-02-18","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":22,"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":"event.earnings_transcript","namespace":"event","name":"earnings_transcript","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 业绩电话会全文.","relation":"event.earnings_transcript","objectKind":"table","rowMagnitude":"10K-99K","grain":"instrument_id × fiscal_year × fiscal_quarter × source","cadence":"producer_schedule","timeColumn":"published_ts","defaultOrder":["instrument_id","fiscal_year","fiscal_quarter","source"],"filters":[{"name":"fiscal_quarter","column":"fiscal_quarter","required":false,"multipleValues":true,"jsonType":"integer","example":"FILTER_VALUE"},{"name":"fiscal_year","column":"fiscal_year","required":false,"multipleValues":true,"jsonType":"integer","example":"FILTER_VALUE"},{"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","fiscal_year","fiscal_quarter","source"],"provenanceColumns":[],"fieldCount":25,"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":"fiscal_year","displayName":"fiscal year","clickhouseType":"UInt16","jsonType":"integer","nullable":false,"description":"Source-normalized field: fiscal year.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["fiscal_year"],"returned":true},{"position":4,"name":"fiscal_quarter","displayName":"fiscal quarter","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: fiscal quarter.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["fiscal_quarter"],"returned":true},{"position":5,"name":"transcript_date","displayName":"transcript date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for transcript date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":6,"name":"published_ts","displayName":"published ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the source published the record.","descriptionSource":"standard_glossary","roles":["time","provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":7,"name":"content","displayName":"content","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: content.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"internal body/object-path/raw-payload surface; retrieval requires a separate entitled endpoint"},{"position":8,"name":"char_count","displayName":"char count","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Count of char count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"token_count","displayName":"token count","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Count of token count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"n_speakers","displayName":"n speakers","clickhouseType":"UInt16","jsonType":"integer","nullable":false,"description":"Count of speakers.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"n_turns","displayName":"n turns","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Count of turns.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"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":13,"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":14,"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":15,"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":16,"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":17,"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":18,"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":19,"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":20,"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":21,"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":22,"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":23,"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":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},{"position":25,"name":"feature_available_ts","displayName":"feature available ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for feature available ts.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"业绩电话会全文","summaryCn":"这是公告、新闻与可交易事件中的“业绩电话会全文”数据集；一行由 instrument_id、fiscal_year、fiscal_quarter、source 定位，主要字段包括 symbol、transcript_date、published_ts、content、char_count。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“业绩电话会全文”的一条记录；逻辑粒度由 instrument_id × fiscal_year × fiscal_quarter × source 共同确定。","timeSemanticsCn":"以 published_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"fiscal_year","meaningCn":"用于确定该表业务粒度或默认顺序的 fiscal year 字段。"},{"name":"fiscal_quarter","meaningCn":"用于确定该表业务粒度或默认顺序的 fiscal quarter 字段。"},{"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":24,"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":"event.earnings_transcript_turn","namespace":"event","name":"earnings_transcript_turn","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 业绩电话会逐段发言.","relation":"event.earnings_transcript_turn","objectKind":"table","rowMagnitude":"100K-999K","grain":"instrument_id × fiscal_year × fiscal_quarter × turn_no × source","cadence":"producer_schedule","timeColumn":"published_ts","defaultOrder":["instrument_id","fiscal_year","fiscal_quarter","turn_no","source"],"filters":[{"name":"fiscal_quarter","column":"fiscal_quarter","required":false,"multipleValues":true,"jsonType":"integer","example":"FILTER_VALUE"},{"name":"fiscal_year","column":"fiscal_year","required":false,"multipleValues":true,"jsonType":"integer","example":"FILTER_VALUE"},{"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","fiscal_year","fiscal_quarter","turn_no","source"],"provenanceColumns":[],"fieldCount":25,"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":"fiscal_year","displayName":"fiscal year","clickhouseType":"UInt16","jsonType":"integer","nullable":false,"description":"Source-normalized field: fiscal year.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["fiscal_year"],"returned":true},{"position":4,"name":"fiscal_quarter","displayName":"fiscal quarter","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: fiscal quarter.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["fiscal_quarter"],"returned":true},{"position":5,"name":"turn_no","displayName":"turn no","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Source-normalized field: turn no.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":6,"name":"speaker_name","displayName":"speaker name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: speaker name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"speaker_role","displayName":"speaker role","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: speaker role.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"segment","displayName":"segment","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: segment.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"text","displayName":"text","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: text.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"internal body/object-path/raw-payload surface; retrieval requires a separate entitled endpoint"},{"position":10,"name":"char_count","displayName":"char count","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Count of char count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"transcript_date","displayName":"transcript date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for transcript date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":12,"name":"published_ts","displayName":"published ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the source published the record.","descriptionSource":"standard_glossary","roles":["time","provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":13,"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":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":"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":18,"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":19,"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":20,"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":21,"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":22,"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":23,"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":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},{"position":25,"name":"feature_available_ts","displayName":"feature available ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for feature available ts.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"业绩电话会逐段发言","summaryCn":"这是公告、新闻与可交易事件中的“业绩电话会逐段发言”数据集；一行由 instrument_id、fiscal_year、fiscal_quarter、turn_no 定位，主要字段包括 symbol、speaker_name、speaker_role、segment、text。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“业绩电话会逐段发言”的一条记录；逻辑粒度由 instrument_id × fiscal_year × fiscal_quarter × turn_no × source 共同确定。","timeSemanticsCn":"以 published_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"fiscal_year","meaningCn":"用于确定该表业务粒度或默认顺序的 fiscal year 字段。"},{"name":"fiscal_quarter","meaningCn":"用于确定该表业务粒度或默认顺序的 fiscal quarter 字段。"},{"name":"turn_no","meaningCn":"用于确定该表业务粒度或默认顺序的 turn no 字段。"},{"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":24,"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":"event.economic_release","namespace":"event","name":"economic_release","coverageTags":["news_events"],"description":"Macro economic data releases (actual vs estimate vs previous) by country and indicator.","relation":"event.economic_release","objectKind":"table","rowMagnitude":"100K-999K","grain":"country × indicator_type × release_ts","cadence":"event","timeColumn":"release_ts","defaultOrder":["release_ts","country","indicator_type"],"filters":[{"name":"country","column":"country","required":false,"multipleValues":true,"jsonType":"string","example":"US"},{"name":"indicator_type","column":"indicator_type","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"period","column":"period","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":31,"fields":[{"position":1,"name":"country","displayName":"country","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: country.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["country"],"returned":true},{"position":2,"name":"indicator_type","displayName":"indicator type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: indicator type.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["indicator_type"],"returned":true},{"position":3,"name":"release_ts","displayName":"release ts","clickhouseType":"DateTime","jsonType":"string","nullable":false,"description":"UTC timestamp for release ts.","descriptionSource":"name_derived","roles":["time","default_order","warehouse_primary_key"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":4,"name":"period","displayName":"period","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Reporting or observation period label.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["period"],"returned":true},{"position":5,"name":"actual","displayName":"actual","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: actual.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"previous","displayName":"previous","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: previous.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"estimate","displayName":"estimate","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: estimate.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"change","displayName":"change","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: change.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"change_percentage","displayName":"change percentage","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Percentage value for change percentage.","descriptionSource":"name_derived","roles":[],"filterNames":[],"unit":"percent","returned":true},{"position":10,"name":"comparison","displayName":"comparison","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: comparison.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"event_name","displayName":"event name","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: event name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"unit","displayName":"unit","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Unit attached to the numeric observation.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"payload_json","displayName":"payload json","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: payload json.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"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":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":15,"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":16,"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":17,"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":18,"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":19,"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":20,"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":21,"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":22,"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":23,"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":24,"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":25,"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":26,"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":27,"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":28,"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":29,"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":30,"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":31,"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":"宏观经济数据发布","summaryCn":"记录各国经济指标的发布时间、实际值、预期值和前值，用于衡量宏观数据意外程度。","useCasesCn":["计算实际值相对预期的 surprise","查询未来或历史宏观发布时间","对照资产价格研究宏观冲击"],"grainCn":"每行代表“宏观经济数据发布”的一条记录；逻辑粒度由 country × indicator_type × release_ts 共同确定。","timeSemanticsCn":"以 release_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"country","meaningCn":"用于确定该表业务粒度或默认顺序的 country 字段。"},{"name":"indicator_type","meaningCn":"用于确定该表业务粒度或默认顺序的 indicator type 字段。"},{"name":"release_ts","meaningCn":"release ts 对应的时间戳；除表内特别说明外按 UTC 解释。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 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":31,"costGuard":{"tier":"medium","identityFilters":[],"maxWindowDays":400,"requirement":"identity filter or bounded window","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"DENIED","deniedSources":["eodhd"],"reasons":["restricted_license_scope","restricted_visibility_tier"]}},{"object":"dataset_schema","asset":"event.event_window","namespace":"event","name":"event_window","coverageTags":["news_events"],"description":"Event-window returns and volume features.","relation":"event.event_window","objectKind":"table","rowMagnitude":"10M-99M","grain":"event_id × ticker × relative_day","cadence":"event","timeColumn":null,"defaultOrder":["event_id","ticker","relative_day"],"filters":[{"name":"benchmark","column":"benchmark","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"event_id","column":"event_id","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"ticker","column":"ticker","required":false,"multipleValues":true,"jsonType":"string","example":"AAPL"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":false,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":21,"fields":[{"position":1,"name":"event_id","displayName":"event id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Stable identifier of the normalized event.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["event_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","default_order","warehouse_primary_key"],"filterNames":["ticker"],"returned":true},{"position":3,"name":"relative_day","displayName":"relative day","clickhouseType":"Int16","jsonType":"integer","nullable":false,"description":"Source-normalized field: relative day.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key"],"filterNames":[],"returned":true},{"position":4,"name":"cum_abnormal_return","displayName":"cum abnormal return","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: cum abnormal return.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"raw_return","displayName":"raw return","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: raw return.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"volume_ratio","displayName":"volume ratio","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Ratio value for volume ratio.","descriptionSource":"name_derived","roles":[],"filterNames":[],"unit":"ratio","returned":true},{"position":7,"name":"iv_change","displayName":"iv change","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: iv change.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"benchmark","displayName":"benchmark","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: benchmark.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["benchmark"],"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":["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":"每行代表“事件窗口收益与成交特征”的一条记录；逻辑粒度由 event_id × ticker × relative_day 共同确定。","timeSemanticsCn":"该表没有单一主时间列；请使用业务日期或版本字段，并按关键字段确定范围。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"event_id","meaningCn":"统一事件标识；可联接 event.stream。"},{"name":"ticker","meaningCn":"来源或证券主表使用的股票代码。"},{"name":"relative_day","meaningCn":"relative day 对应的日历日期。"}],"joins":[{"dataset":"event.stream","on":"event_id","guidanceCn":"用 event_id 回到统一事件流和事件分类。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 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":21,"costGuard":{"tier":"large","identityFilters":["event_id","ticker"],"maxWindowDays":400,"requirement":"identity filter and bounded window","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.evidence_bundle","namespace":"event","name":"evidence_bundle","coverageTags":["news_events"],"description":"Decision-time supporting, counter, social, and market evidence attached to candidates.","relation":"event.evidence_bundle","objectKind":"table","rowMagnitude":"0","grain":"candidate_id × evidence_id","cadence":"event","timeColumn":"evidence_ts","defaultOrder":["evidence_ts","candidate_id","evidence_id"],"filters":[{"name":"candidate_id","column":"candidate_id","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"evidence_id","column":"evidence_id","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"evidence_role","column":"evidence_role","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"evidence_type","column":"evidence_type","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"market","column":"market","required":false,"multipleValues":true,"jsonType":"string","example":"US"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"},{"name":"source_asset","column":"source_asset","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_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":[],"provenanceColumns":[],"fieldCount":30,"fields":[{"position":1,"name":"candidate_id","displayName":"candidate id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for candidate.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["candidate_id"],"returned":true},{"position":2,"name":"evidence_id","displayName":"evidence id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for evidence.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["evidence_id"],"returned":true},{"position":3,"name":"evidence_ts","displayName":"evidence ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for evidence ts.","descriptionSource":"name_derived","roles":["time","default_order"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":4,"name":"as_of_ts","displayName":"as of ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for as of ts.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":5,"name":"evidence_role","displayName":"evidence role","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: evidence role.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["evidence_role"],"returned":true},{"position":6,"name":"evidence_type","displayName":"evidence type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: evidence type.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["evidence_type"],"returned":true},{"position":7,"name":"source_asset","displayName":"source asset","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: source asset.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["source_asset"],"returned":true},{"position":8,"name":"source_event_id","displayName":"source event id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for source event.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"source_doc_id","displayName":"source doc id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for source doc.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"instrument_id","displayName":"instrument id","clickhouseType":"Nullable(UInt64)","jsonType":"integer","nullable":true,"description":"WarrenHub canonical instrument identifier; use it for cross-dataset joins.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":11,"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":12,"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":13,"name":"summary","displayName":"summary","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: summary.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"url","displayName":"url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Canonical URL attached to the record.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"score","displayName":"score","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: score.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"metadata","displayName":"metadata","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: metadata.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"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":18,"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":19,"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":20,"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":21,"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":22,"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":23,"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":24,"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":25,"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":26,"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":27,"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":28,"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":29,"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":30,"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":"每行代表“决策证据包”的一条记录；逻辑粒度由 candidate_id × evidence_id 共同确定。","timeSemanticsCn":"以 evidence_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"candidate_id","meaningCn":"策略候选标识；可联接 event.candidate 与 event.evidence_bundle。"},{"name":"evidence_id","meaningCn":"用于识别 evidence 的业务标识。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"},{"dataset":"event.candidate","on":"candidate_id","guidanceCn":"用 candidate_id 查看候选产生时点、状态和策略上下文。"},{"dataset":"event.source_document","on":"source_doc_id","guidanceCn":"用文档标识回溯标准化原文和来源信息；先核对两表字段口径。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["字典采样时该关系可能为空；先查询 catalog 或小范围 rows 判断当前是否已有数据。"],"supportedMarkets":[],"coverage":{"measured":true,"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":30,"costGuard":{"tier":"small","identityFilters":["symbol"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.fda_advisory_committee","namespace":"event","name":"fda_advisory_committee","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: FDA 顾问委员会事件.","relation":"event.fda_advisory_committee","objectKind":"table","rowMagnitude":"<1K","grain":"meeting_date × document_number × source","cadence":"event","timeColumn":"publication_date","defaultOrder":["document_number","source"],"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"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["document_number","source"],"provenanceColumns":[],"fieldCount":27,"fields":[{"position":1,"name":"document_number","displayName":"document number","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: document number.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":2,"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"],"filterNames":["instrument_id"],"returned":true},{"position":3,"name":"committee","displayName":"committee","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: committee.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":4,"name":"title","displayName":"title","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Human-readable title supplied or normalized from the source.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"notice_type","displayName":"notice type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: notice type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"meeting_date","displayName":"meeting date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for meeting date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":7,"name":"publication_date","displayName":"publication date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for publication date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["time"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":8,"name":"topic","displayName":"topic","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: topic.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"sponsor_name","displayName":"sponsor name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: sponsor name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"abstract","displayName":"abstract","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: abstract.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"html_url","displayName":"html url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: html url.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"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":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":13,"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":14,"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":15,"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":16,"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":17,"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":18,"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":19,"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":20,"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":21,"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":22,"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":23,"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":24,"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":25,"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":26,"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":27,"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":"FDA 顾问委员会事件","summaryCn":"这是公告、新闻与可交易事件中的“FDA 顾问委员会事件”数据集；一行由 document_number、source 定位，主要字段包括 instrument_id、committee、title、notice_type、meeting_date。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“FDA 顾问委员会事件”的一条记录；逻辑粒度由 meeting_date × document_number × source 共同确定。","timeSemanticsCn":"以 publication_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"meeting_date","meaningCn":"meeting date 对应的日历日期。"},{"name":"document_number","meaningCn":"用于确定该表业务粒度或默认顺序的 document number 字段。"},{"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"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.fda_advisory_committee_meeting","namespace":"event","name":"fda_advisory_committee_meeting","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: FDA 顾问委员会会议.","relation":"event.fda_advisory_committee_meeting","objectKind":"table","rowMagnitude":"<1K","grain":"document_number","cadence":"producer_schedule","timeColumn":"publication_date","defaultOrder":["document_number"],"filters":[{"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":["document_number"],"provenanceColumns":[],"fieldCount":26,"fields":[{"position":1,"name":"document_number","displayName":"document number","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: document number.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":2,"name":"committee","displayName":"committee","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: committee.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":3,"name":"title","displayName":"title","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Human-readable title supplied or normalized from the source.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":4,"name":"notice_type","displayName":"notice type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: notice type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"meeting_date","displayName":"meeting date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for meeting date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":6,"name":"publication_date","displayName":"publication date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for publication date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["time"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":7,"name":"topic","displayName":"topic","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: topic.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"sponsor_name","displayName":"sponsor name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: sponsor name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"abstract","displayName":"abstract","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: abstract.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"html_url","displayName":"html url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: html url.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"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":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":12,"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":13,"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":14,"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":15,"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":16,"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":17,"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":18,"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":19,"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":20,"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":21,"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":22,"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":23,"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":24,"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":25,"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":26,"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":"FDA 顾问委员会会议","summaryCn":"这是公告、新闻与可交易事件中的“FDA 顾问委员会会议”数据集；一行由 document_number 定位，主要字段包括 committee、title、notice_type、meeting_date、publication_date。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“FDA 顾问委员会会议”的一条记录；逻辑粒度由 document_number 共同确定。","timeSemanticsCn":"以 publication_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"document_number","meaningCn":"用于确定该表业务粒度或默认顺序的 document number 字段。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"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":26,"costGuard":{"tier":"small","identityFilters":[],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.fda_advisory_committee_meeting_forward","namespace":"event","name":"fda_advisory_committee_meeting_forward","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 未来 FDA 顾问委员会会议.","relation":"event.fda_advisory_committee_meeting_forward","objectKind":"view","rowMagnitude":"view","grain":"document_number","cadence":"producer_schedule","timeColumn":"publication_date","defaultOrder":["document_number"],"filters":[],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"relation_default","contractVersion":null,"uniqueKey":["document_number"],"provenanceColumns":[],"fieldCount":8,"fields":[{"position":1,"name":"document_number","displayName":"document number","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: document number.","descriptionSource":"name_derived","roles":["default_order","contract_unique_key"],"filterNames":[],"returned":true},{"position":2,"name":"committee","displayName":"committee","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: committee.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":3,"name":"title","displayName":"title","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Human-readable title supplied or normalized from the source.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":4,"name":"notice_type","displayName":"notice type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: notice type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"meeting_date","displayName":"meeting date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for meeting date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":6,"name":"publication_date","displayName":"publication date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for publication date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["time"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":7,"name":"sponsor_name","displayName":"sponsor name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: sponsor name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"source_table","displayName":"source table","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: source table.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true}],"pit":null,"titleCn":"未来 FDA 顾问委员会会议","summaryCn":"这是公告、新闻与可交易事件中的“未来 FDA 顾问委员会会议”数据集；一行由 document_number 定位，主要字段包括 committee、title、notice_type、meeting_date、publication_date。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“未来 FDA 顾问委员会会议”的一条记录；逻辑粒度由 document_number 共同确定。","timeSemanticsCn":"以 publication_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"document_number","meaningCn":"用于确定该表业务粒度或默认顺序的 document number 字段。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"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":8,"costGuard":{"tier":"small","identityFilters":[],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"UNCLASSIFIED","deniedSources":[],"reasons":["no_observed_source_and_no_source_column"]}},{"object":"dataset_schema","asset":"event.fda_drug_approval","namespace":"event","name":"fda_drug_approval","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: FDA 药品批准.","relation":"event.fda_drug_approval","objectKind":"table","rowMagnitude":"10K-99K","grain":"application_number × submission_type × submission_number × action_date × source","cadence":"event","timeColumn":"publish_ts","defaultOrder":["application_number","submission_type","submission_number","action_date","source"],"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"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["application_number","submission_type","submission_number","action_date","source"],"provenanceColumns":[],"fieldCount":27,"fields":[{"position":1,"name":"application_number","displayName":"application number","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: application number.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":2,"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"],"filterNames":["instrument_id"],"returned":true},{"position":3,"name":"sponsor_name","displayName":"sponsor name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: sponsor name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":4,"name":"brand_name","displayName":"brand name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: brand name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"generic_name","displayName":"generic name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: generic name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"submission_type","displayName":"submission type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: submission type.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":7,"name":"submission_number","displayName":"submission number","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: submission number.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":8,"name":"submission_status","displayName":"submission status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: submission status.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"submission_class_code","displayName":"submission class code","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: submission class code.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"review_priority","displayName":"review priority","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: review priority.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"action_date","displayName":"action date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for action date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":12,"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":13,"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":14,"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":15,"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":16,"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":17,"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":18,"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":19,"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":20,"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":21,"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":22,"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":23,"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":24,"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":25,"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":26,"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":27,"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":"FDA 药品批准","summaryCn":"这是公告、新闻与可交易事件中的“FDA 药品批准”数据集；一行由 application_number、submission_type、submission_number、action_date 定位，主要字段包括 instrument_id、sponsor_name、brand_name、generic_name、submission_status。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“FDA 药品批准”的一条记录；逻辑粒度由 application_number × submission_type × submission_number × action_date × source 共同确定。","timeSemanticsCn":"以 publish_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"application_number","meaningCn":"用于确定该表业务粒度或默认顺序的 application number 字段。"},{"name":"submission_type","meaningCn":"用于确定该表业务粒度或默认顺序的 submission type 字段。"},{"name":"submission_number","meaningCn":"用于确定该表业务粒度或默认顺序的 submission number 字段。"},{"name":"action_date","meaningCn":"action 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"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.filing_cninfo","namespace":"event","name":"filing_cninfo","coverageTags":["a_share","news_events"],"description":"Cninfo filing announcements.","relation":"event.filing_cninfo","objectKind":"table","rowMagnitude":"100K-999K","grain":"announcement_id × ann_date","cadence":"event","timeColumn":"ann_date","defaultOrder":["ann_date","market","code","announcement_id"],"filters":[{"name":"category","column":"category","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"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":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":26,"fields":[{"position":1,"name":"announcement_id","displayName":"announcement id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for announcement.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key"],"filterNames":[],"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":"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":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":"title","displayName":"title","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Human-readable title supplied or normalized from the source.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"category","displayName":"category","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: category.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["category"],"returned":true},{"position":8,"name":"pdf_url","displayName":"pdf url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: pdf url.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"blob_path","displayName":"blob path","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: blob path.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"internal body/object-path/raw-payload surface; retrieval requires a separate entitled endpoint"},{"position":10,"name":"blob_sha256","displayName":"blob sha256","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: blob sha256.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"page_count","displayName":"page count","clickhouseType":"Nullable(Int32)","jsonType":"integer","nullable":true,"description":"Count of page count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"text_extracted","displayName":"text extracted","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: text extracted.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"text_path","displayName":"text path","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: text path.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"internal body/object-path/raw-payload surface; retrieval requires a separate entitled endpoint"},{"position":14,"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":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":"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":25,"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":26,"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":["查询 A 股公司公告时间线","按标题筛选公司行为","联接原始文档做文本研究"],"grainCn":"每行代表“巨潮资讯公告索引”的一条记录；逻辑粒度由 announcement_id × ann_date 共同确定。","timeSemanticsCn":"以 ann_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"announcement_id","meaningCn":"用于识别 announcement 的业务标识。"},{"name":"ann_date","meaningCn":"来源公告日期。"}],"joins":[{"dataset":"ref.instrument","on":"code + market（先确认代码口径）","guidanceCn":"需要补证券主数据时可按代码和市场映射；不同来源代码可能不一致，优先先查 ref.code_mapping。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":["CN"],"coverage":{"measured":true,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{"CN":{"latestBusinessDate":"2026-08-28","rows":24678}},"latestBusinessDate":"2026-08-28","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":24,"costGuard":{"tier":"small","identityFilters":["code"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.filing_sec","namespace":"event","name":"filing_sec","coverageTags":["news_events"],"description":"SEC filing index and blob pointers.","relation":"event.filing_sec","objectKind":"table","rowMagnitude":"10M-99M","grain":"accession_no × filing_date","cadence":"event","timeColumn":"filing_date","defaultOrder":["filing_date","accession_no"],"filters":[{"name":"cik","column":"cik","required":false,"multipleValues":true,"jsonType":"string","example":"0000320193"},{"name":"code","column":"code","required":false,"multipleValues":true,"jsonType":"string","example":"AAPL"},{"name":"form_type","column":"form_type","required":false,"multipleValues":true,"jsonType":"string","example":"10-Q"},{"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":25,"fields":[{"position":1,"name":"accession_no","displayName":"accession no","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC accession number identifying one filing submission.","descriptionSource":"standard_glossary","roles":["default_order","warehouse_primary_key"],"filterNames":[],"returned":true},{"position":2,"name":"cik","displayName":"cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC Central Index Key identifying the filer.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["cik"],"returned":true},{"position":3,"name":"code","displayName":"code","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"DEAD COLUMN (A711 2026-07-11): 100% NULL since creation, zero writers. Do NOT read as a symbol/ticker. Use v_filing_sec_with_ticker.mapped_ticker (CIK->ticker) instead.","descriptionSource":"warehouse_comment","roles":["filter"],"filterNames":["code"],"returned":true},{"position":4,"name":"form_type","displayName":"form type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: form type.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["form_type"],"returned":true},{"position":5,"name":"filing_date","displayName":"filing date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Date on which the filing was submitted or published.","descriptionSource":"standard_glossary","roles":["time","default_order"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":6,"name":"period_end","displayName":"period end","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Source-normalized field: period end.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","returned":true},{"position":7,"name":"filer_name","displayName":"filer name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: filer name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"primary_url","displayName":"primary url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: primary url.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"text_url","displayName":"text url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: text url.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"blob_path","displayName":"blob path","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: blob path.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"internal body/object-path/raw-payload surface; retrieval requires a separate entitled endpoint"},{"position":11,"name":"blob_sha256","displayName":"blob sha256","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: blob sha256.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"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":13,"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":14,"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":15,"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":16,"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":17,"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":18,"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":19,"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":20,"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":21,"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":22,"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":23,"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":24,"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":25,"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":"SEC 申报索引","summaryCn":"记录 SEC 文件的 accession number、表格类型、提交日期和原文存储指针，是美股申报研究的入口表。","useCasesCn":["查询公司的 10-K 10-Q 8-K 历史","定位申报原文","联接 XBRL 或事件解析结果"],"grainCn":"每行代表“SEC 申报索引”的一条记录；逻辑粒度由 accession_no × filing_date 共同确定。","timeSemanticsCn":"以 filing_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"accession_no","meaningCn":"SEC 对单次申报分配的唯一 accession number。"},{"name":"filing_date","meaningCn":"申报提交或公开日期。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 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":"large","identityFilters":["cik","code"],"maxWindowDays":400,"requirement":"identity filter and bounded window","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.filing_sec_with_ticker","namespace":"event","name":"filing_sec_with_ticker","coverageTags":["news_events"],"description":"SEC filing index enriched with the current SEC company-ticker mapping. mapped_ticker is suitable for live lookup only; ticker_pit_status discloses that the mapping is not historical PIT.","relation":"event.v_filing_sec_with_ticker","objectKind":"view","rowMagnitude":"view","grain":"filing_date × accession_no","cadence":"producer_schedule","timeColumn":"filing_date","defaultOrder":["filing_date","accession_no"],"filters":[{"name":"accession_no","column":"accession_no","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"cik","column":"cik","required":false,"multipleValues":true,"jsonType":"string","example":"0000320193"},{"name":"form_type","column":"form_type","required":false,"multipleValues":true,"jsonType":"string","example":"10-Q"},{"name":"mapped_instrument_id","column":"mapped_instrument_id","required":false,"multipleValues":true,"jsonType":"integer","example":"FILTER_VALUE"},{"name":"mapped_ticker","column":"mapped_ticker","required":true,"multipleValues":true,"jsonType":"string","example":"AAPL"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"},{"name":"ticker_mapping_status","column":"ticker_mapping_status","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"ticker_pit_status","column":"ticker_pit_status","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"}],"maxLimit":200,"maxWindowDays":90,"supportsCursor":false,"readMode":"relation_default","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":23,"fields":[{"position":1,"name":"accession_no","displayName":"accession no","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC accession number identifying one filing submission.","descriptionSource":"standard_glossary","roles":["filter","default_order"],"filterNames":["accession_no"],"returned":true},{"position":2,"name":"cik","displayName":"cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC Central Index Key identifying the filer.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["cik"],"returned":true},{"position":3,"name":"mapped_ticker","displayName":"mapped ticker","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: mapped ticker.","descriptionSource":"name_derived","roles":["filter","required_filter"],"filterNames":["mapped_ticker"],"returned":true},{"position":4,"name":"mapped_instrument_id","displayName":"mapped instrument id","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Identifier for mapped instrument.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["mapped_instrument_id"],"returned":true},{"position":5,"name":"form_type","displayName":"form type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: form type.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["form_type"],"returned":true},{"position":6,"name":"filing_date","displayName":"filing date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Date on which the filing was submitted or published.","descriptionSource":"standard_glossary","roles":["time","default_order"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":7,"name":"period_end","displayName":"period end","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Source-normalized field: period end.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","returned":true},{"position":8,"name":"filer_name","displayName":"filer name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: filer name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"primary_url","displayName":"primary url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: primary url.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"text_url","displayName":"text url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: text url.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"blob_sha256","displayName":"blob sha256","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: blob sha256.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"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":13,"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":14,"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":15,"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":16,"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":17,"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":18,"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":19,"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":20,"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},{"position":21,"name":"ticker_mapping_status","displayName":"ticker mapping status","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: ticker mapping status.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["ticker_mapping_status"],"returned":true},{"position":22,"name":"ticker_pit_status","displayName":"ticker pit status","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: ticker pit status.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["ticker_pit_status"],"returned":true},{"position":23,"name":"ticker_mapping_confidence","displayName":"ticker mapping confidence","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: ticker mapping confidence.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true}],"pit":null,"titleCn":"带当前股票代码的 SEC 申报","summaryCn":"在 SEC 申报索引上附加当前公司代码映射，方便实时检索；该代码映射不是历史时点映射。","useCasesCn":["按当前 ticker 快速找 SEC 文件","给申报结果补可读代码","核对 CIK 与当前证券映射"],"grainCn":"每行代表“带当前股票代码的 SEC 申报”的一条记录；逻辑粒度由 filing_date × accession_no 共同确定。","timeSemanticsCn":"以 filing_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"filing_date","meaningCn":"申报提交或公开日期。"},{"name":"accession_no","meaningCn":"SEC 对单次申报分配的唯一 accession number。"},{"name":"mapped_ticker","meaningCn":"用于确定该表业务粒度或默认顺序的 mapped ticker 字段。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；必须提供 mapped_ticker；单页最多 200 行，该表不提供稳定 cursor，结果过大时必须缩小标的、日期或其他筛选。","caveatsCn":["mapped_ticker 使用当前映射，不能用于历史 PIT 归因；请同时查看 ticker_pit_status"],"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":23,"costGuard":{"tier":"small","identityFilters":["accession_no","cik"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.filing_text_feature","namespace":"event","name":"filing_text_feature","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 申报文本变化特征.","relation":"event.filing_text_feature","objectKind":"table","rowMagnitude":"1K-9K","grain":"instrument_id × accession_no × extractor_version","cadence":"producer_schedule","timeColumn":"filing_date","defaultOrder":["instrument_id","accession_no","extractor_version"],"filters":[{"name":"accession_no","column":"accession_no","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"cik","column":"cik","required":false,"multipleValues":true,"jsonType":"string","example":"0000320193"},{"name":"fiscal_year","column":"fiscal_year","required":false,"multipleValues":true,"jsonType":"integer","example":"FILTER_VALUE"},{"name":"form_type","column":"form_type","required":false,"multipleValues":true,"jsonType":"string","example":"10-Q"},{"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","accession_no","extractor_version"],"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":"cik","displayName":"cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC Central Index Key identifying the filer.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["cik"],"returned":true},{"position":3,"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":4,"name":"accession_no","displayName":"accession no","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC accession number identifying one filing submission.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["accession_no"],"returned":true},{"position":5,"name":"form_type","displayName":"form type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: form type.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["form_type"],"returned":true},{"position":6,"name":"filing_date","displayName":"filing date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Date on which the filing was submitted or published.","descriptionSource":"standard_glossary","roles":["time"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":7,"name":"fiscal_year","displayName":"fiscal year","clickhouseType":"UInt16","jsonType":"integer","nullable":false,"description":"Source-normalized field: fiscal year.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["fiscal_year"],"returned":true},{"position":8,"name":"feature_available_ts","displayName":"feature available ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for feature available ts.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":9,"name":"yoy_cosine","displayName":"yoy cosine","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: yoy cosine.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"yoy_jaccard","displayName":"yoy jaccard","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: yoy jaccard.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"prior_accession_no","displayName":"prior accession no","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: prior accession no.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"prior_filing_date","displayName":"prior filing date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for prior filing date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":13,"name":"gap_days","displayName":"gap days","clickhouseType":"UInt16","jsonType":"integer","nullable":false,"description":"Source-normalized field: gap days.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"n_tokens","displayName":"n tokens","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Count of tokens.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"prior_n_tokens","displayName":"prior n tokens","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Source-normalized field: prior n tokens.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"extractor_version","displayName":"extractor version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: extractor version.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":17,"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":18,"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":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":"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":21,"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":22,"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":23,"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":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、accession_no、extractor_version 定位，主要字段包括 cik、ticker、form_type、filing_date、fiscal_year。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“申报文本变化特征”的一条记录；逻辑粒度由 instrument_id × accession_no × extractor_version 共同确定。","timeSemanticsCn":"以 filing_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"accession_no","meaningCn":"SEC 对单次申报分配的唯一 accession number。"},{"name":"extractor_version","meaningCn":"用于确定该表业务粒度或默认顺序的 extractor version 字段。"}],"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":["accession_no","cik","instrument_id","ticker"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.government_contract_award","namespace":"event","name":"government_contract_award","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 政府合同授予.","relation":"event.government_contract_award","objectKind":"table","rowMagnitude":"100K-999K","grain":"instrument_id × award_date × agency × source_record_id × source","cadence":"event","timeColumn":"publish_ts","defaultOrder":["instrument_id","award_date","agency","source_record_id","source"],"filters":[{"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"},{"name":"ticker","column":"ticker","required":false,"multipleValues":true,"jsonType":"string","example":"TICKER","exampleSource":"identifier_format"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["instrument_id","award_date","agency","source_record_id","source"],"provenanceColumns":[],"fieldCount":25,"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":"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":5,"name":"agency","displayName":"agency","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: agency.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":6,"name":"amount_usd","displayName":"amount usd","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"US-dollar value for amount usd.","descriptionSource":"name_derived","roles":[],"filterNames":[],"unit":"USD","returned":true},{"position":7,"name":"award_date","displayName":"award date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for award date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":8,"name":"announce_date","displayName":"announce date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for announce date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":9,"name":"description","displayName":"description","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Human-readable description supplied or normalized from the source.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":10,"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":11,"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":12,"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":13,"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":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":["default_order","warehouse_primary_key","contract_unique_key","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":"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":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}],"pit":null,"titleCn":"政府合同授予","summaryCn":"这是公告、新闻与可交易事件中的“政府合同授予”数据集；一行由 instrument_id、award_date、agency、source_record_id 定位，主要字段包括 code、market、ticker、amount_usd、announce_date。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“政府合同授予”的一条记录；逻辑粒度由 instrument_id × award_date × agency × source_record_id × source 共同确定。","timeSemanticsCn":"以 publish_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"award_date","meaningCn":"award date 对应的日历日期。"},{"name":"agency","meaningCn":"用于确定该表业务粒度或默认顺序的 agency 字段。"},{"name":"source_record_id","meaningCn":"用于识别 source record 的业务标识。"},{"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-26","rows":8791}},"latestBusinessDate":"2026-08-26","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":25,"costGuard":{"tier":"small","identityFilters":["code","instrument_id","ticker"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.impact","namespace":"event","name":"impact","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 事件影响评分.","relation":"event.impact","objectKind":"table","rowMagnitude":"<1K","grain":"event_id × instrument_id × horizon","cadence":"event","timeColumn":"event_ts","defaultOrder":["event_id","instrument_id","horizon","model_version"],"filters":[{"name":"event_id","column":"event_id","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"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"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["event_id","instrument_id","horizon","model_version"],"provenanceColumns":[],"fieldCount":21,"fields":[{"position":1,"name":"event_id","displayName":"event id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Stable identifier of the normalized event.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["event_id"],"returned":true},{"position":2,"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":3,"name":"event_ts","displayName":"event ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp of the normalized event.","descriptionSource":"standard_glossary","roles":["time"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":4,"name":"horizon","displayName":"horizon","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: horizon.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":5,"name":"model_version","displayName":"model version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: model version.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":6,"name":"impact_score","displayName":"impact score","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: impact score.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"confidence","displayName":"confidence","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: confidence.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"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":9,"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":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":["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":"这是公告、新闻与可交易事件中的“事件影响评分”数据集；一行由 event_id、instrument_id、horizon、model_version 定位，主要字段包括 event_ts、impact_score、confidence、source、provider。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“事件影响评分”的一条记录；逻辑粒度由 event_id × instrument_id × horizon 共同确定。","timeSemanticsCn":"以 event_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"event_id","meaningCn":"统一事件标识；可联接 event.stream。"},{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"horizon","meaningCn":"用于确定该表业务粒度或默认顺序的 horizon 字段。"},{"name":"model_version","meaningCn":"用于确定该表业务粒度或默认顺序的 model version 字段。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"},{"dataset":"event.stream","on":"event_id","guidanceCn":"用 event_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":21,"costGuard":{"tier":"small","identityFilters":["event_id","instrument_id"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.index_reconstitution","namespace":"event","name":"index_reconstitution","coverageTags":["news_events"],"description":"Index add/drop reconstitution events keyed by instrument and effective date.","relation":"event.index_reconstitution","objectKind":"table","rowMagnitude":"1K-9K","grain":"index_name × ticker × effective_date","cadence":"event","timeColumn":"effective_date","defaultOrder":["effective_date","index_name","ticker"],"filters":[{"name":"action","column":"action","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"index_name","column":"index_name","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"instrument_id","column":"instrument_id","required":false,"multipleValues":true,"jsonType":"integer","example":1},{"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":false,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":25,"fields":[{"position":1,"name":"index_name","displayName":"index name","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: index name.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["index_name"],"returned":true},{"position":2,"name":"action","displayName":"action","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: action.","descriptionSource":"name_derived","roles":["filter","warehouse_primary_key"],"filterNames":["action"],"returned":true},{"position":3,"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","warehouse_primary_key"],"filterNames":["instrument_id"],"returned":true},{"position":4,"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","default_order"],"filterNames":["ticker"],"returned":true},{"position":5,"name":"security_name","displayName":"security name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: security name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"announce_date","displayName":"announce date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for announce date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":7,"name":"effective_date","displayName":"effective date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Date on which the record or action becomes effective.","descriptionSource":"standard_glossary","roles":["time","default_order","warehouse_primary_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":8,"name":"is_preliminary","displayName":"is preliminary","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Whether preliminary applies to the row.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"reason","displayName":"reason","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: reason.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"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":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":11,"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":12,"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":13,"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":14,"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":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":"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":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}],"pit":null,"titleCn":"指数成分调整事件","summaryCn":"记录指数纳入、剔除等重构动作及生效日，用于研究被动资金再平衡和事件冲击。","useCasesCn":["查询即将生效的指数调整","研究纳入剔除效应","构建被动资金流观察表"],"grainCn":"每行代表“指数成分调整事件”的一条记录；逻辑粒度由 index_name × ticker × effective_date 共同确定。","timeSemanticsCn":"以 effective_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"index_name","meaningCn":"用于确定该表业务粒度或默认顺序的 index name 字段。"},{"name":"ticker","meaningCn":"来源或证券主表使用的股票代码。"},{"name":"effective_date","meaningCn":"公司行为或映射开始生效的日期。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 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":25,"costGuard":{"tier":"small","identityFilters":["instrument_id","ticker"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.insider_eodhd","namespace":"event","name":"insider_eodhd","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: EODHD 内部人交易.","relation":"event.insider_eodhd","objectKind":"table","rowMagnitude":"10K-99K","grain":"instrument_id × transaction_date × filer_name × sec_form × source","cadence":"none","timeColumn":"transaction_date","defaultOrder":["instrument_id","transaction_date","filer_name","sec_form","source"],"filters":[{"name":"code","column":"code","required":false,"multipleValues":true,"jsonType":"string","example":"AAPL"},{"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"},{"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":"transaction_type","column":"transaction_type","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["instrument_id","transaction_date","filer_name","sec_form","source"],"provenanceColumns":[],"fieldCount":29,"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":"filer_name","displayName":"filer name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: filer name.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":5,"name":"filer_relation","displayName":"filer relation","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: filer relation.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"transaction_date","displayName":"transaction date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for transaction date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["time","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":7,"name":"transaction_type","displayName":"transaction type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: transaction type.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["transaction_type"],"returned":true},{"position":8,"name":"shares","displayName":"shares","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: shares.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"price","displayName":"price","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: price.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"shares_owned_after","displayName":"shares owned after","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: shares owned after.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"is_direct_ownership","displayName":"is direct ownership","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Whether direct ownership applies to the row.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"sec_form","displayName":"sec form","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: sec form.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":13,"name":"sec_filing_date","displayName":"sec filing date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for sec filing date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":14,"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":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":15,"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":16,"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":17,"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":18,"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":19,"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":20,"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":21,"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":22,"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":23,"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":24,"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":25,"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":26,"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":27,"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":28,"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":29,"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":"EODHD 内部人交易","summaryCn":"这是公告、新闻与可交易事件中的“EODHD 内部人交易”数据集；一行由 instrument_id、transaction_date、filer_name、sec_form 定位，主要字段包括 code、market、filer_relation、transaction_type、shares。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“EODHD 内部人交易”的一条记录；逻辑粒度由 instrument_id × transaction_date × filer_name × sec_form × source 共同确定。","timeSemanticsCn":"以 transaction_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"transaction_date","meaningCn":"transaction date 对应的日历日期。"},{"name":"filer_name","meaningCn":"用于确定该表业务粒度或默认顺序的 filer name 字段。"},{"name":"sec_form","meaningCn":"用于确定该表业务粒度或默认顺序的 sec form 字段。"},{"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":true,"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":29,"costGuard":{"tier":"small","identityFilters":["code","instrument_id"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"DENIED","deniedSources":["eodhd"],"reasons":["restricted_license_scope","restricted_visibility_tier"]}},{"object":"dataset_schema","asset":"event.insider_fmp","namespace":"event","name":"insider_fmp","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: FMP 内部人交易.","relation":"event.insider_fmp","objectKind":"table","rowMagnitude":"1M-9M","grain":"transaction_date × company_cik × reporting_cik × filing_date × transaction_type × security_name","cadence":"daily","timeColumn":"filing_date","defaultOrder":["company_cik","reporting_cik","filing_date","transaction_date","transaction_type","security_name","securities_transacted","price"],"filters":[{"name":"form_type","column":"form_type","required":false,"multipleValues":true,"jsonType":"string","example":"10-Q"},{"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"},{"name":"transaction_type","column":"transaction_type","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["company_cik","reporting_cik","filing_date","transaction_date","transaction_type","security_name","securities_transacted","price"],"provenanceColumns":[],"fieldCount":23,"fields":[{"position":1,"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":2,"name":"company_cik","displayName":"company cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: company cik.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":3,"name":"reporting_cik","displayName":"reporting cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: reporting cik.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":4,"name":"reporting_name","displayName":"reporting name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: reporting name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"type_of_owner","displayName":"type of owner","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: type of owner.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"form_type","displayName":"form type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: form type.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["form_type"],"returned":true},{"position":7,"name":"filing_date","displayName":"filing date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Date on which the filing was submitted or published.","descriptionSource":"standard_glossary","roles":["time","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":8,"name":"transaction_date","displayName":"transaction date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for transaction date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":9,"name":"transaction_type","displayName":"transaction type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: transaction type.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["transaction_type"],"returned":true},{"position":10,"name":"acquisition_or_disposition","displayName":"acquisition or disposition","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: acquisition or disposition.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"direct_or_indirect","displayName":"direct or indirect","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: direct or indirect.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"security_name","displayName":"security name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: security name.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":13,"name":"securities_transacted","displayName":"securities transacted","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"Source-normalized field: securities transacted.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":14,"name":"securities_owned","displayName":"securities owned","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"Source-normalized field: securities owned.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"price","displayName":"price","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"Source-normalized field: price.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":16,"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":17,"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":18,"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":19,"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":20,"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":21,"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":22,"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":23,"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}],"pit":null,"titleCn":"FMP 内部人交易","summaryCn":"这是公告、新闻与可交易事件中的“FMP 内部人交易”数据集；一行由 company_cik、reporting_cik、filing_date、transaction_date 定位，主要字段包括 symbol、reporting_name、type_of_owner、form_type、transaction_type。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“FMP 内部人交易”的一条记录；逻辑粒度由 transaction_date × company_cik × reporting_cik × filing_date × transaction_type × security_name 共同确定。","timeSemanticsCn":"以 filing_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"transaction_date","meaningCn":"transaction date 对应的日历日期。"},{"name":"company_cik","meaningCn":"用于确定该表业务粒度或默认顺序的 company cik 字段。"},{"name":"reporting_cik","meaningCn":"用于确定该表业务粒度或默认顺序的 reporting cik 字段。"},{"name":"filing_date","meaningCn":"申报提交或公开日期。"},{"name":"transaction_type","meaningCn":"用于确定该表业务粒度或默认顺序的 transaction type 字段。"},{"name":"security_name","meaningCn":"用于确定该表业务粒度或默认顺序的 security name 字段。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"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":23,"costGuard":{"tier":"small","identityFilters":["symbol"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"DENIED","deniedSources":["fmp"],"reasons":["source_not_cataloged"]}},{"object":"dataset_schema","asset":"event.insider_transaction","namespace":"event","name":"insider_transaction","coverageTags":["news_events"],"description":"SEC Form 4 insider transactions at transaction grain.","relation":"event.insider_transaction","objectKind":"table","rowMagnitude":"1M-9M","grain":"accession_no × transaction_date × filing_date × transaction_index","cadence":"daily","timeColumn":"filing_date","defaultOrder":["filing_date","accession_no","transaction_index"],"filters":[{"name":"accession_no","column":"accession_no","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"insider_cik","column":"insider_cik","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"issuer_cik","column":"issuer_cik","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"},{"name":"transaction_code","column":"transaction_code","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":false,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":23,"fields":[{"position":1,"name":"doc_id","displayName":"doc id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for doc.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":2,"name":"issuer_cik","displayName":"issuer cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: issuer cik.","descriptionSource":"name_derived","roles":["filter","warehouse_primary_key"],"filterNames":["issuer_cik"],"returned":true},{"position":3,"name":"insider_cik","displayName":"insider cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: insider cik.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["insider_cik"],"returned":true},{"position":4,"name":"insider_name","displayName":"insider name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: insider name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"insider_role","displayName":"insider role","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: insider role.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"filing_date","displayName":"filing date","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"Date on which the filing was submitted or published.","descriptionSource":"standard_glossary","roles":["time","default_order","warehouse_primary_key"],"filterNames":[],"jsonFormat":"date-time","unit":"date","returned":true},{"position":7,"name":"transaction_date","displayName":"transaction date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for transaction date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":8,"name":"transaction_code","displayName":"transaction code","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: transaction code.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["transaction_code"],"returned":true},{"position":9,"name":"security_title","displayName":"security title","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: security title.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"shares","displayName":"shares","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"Source-normalized field: shares.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"price_per_share","displayName":"price per share","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"Source-normalized field: price per share.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"total_value","displayName":"total value","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"Source-normalized field: total value.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"shares_held_after","displayName":"shares held after","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"Source-normalized field: shares held after.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"accession_no","displayName":"accession no","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC accession number identifying one filing submission.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["accession_no"],"returned":true},{"position":15,"name":"transaction_index","displayName":"transaction index","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Source-normalized field: transaction index.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key"],"filterNames":[],"returned":true},{"position":16,"name":"metadata","displayName":"metadata","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: metadata.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"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":18,"name":"source_priority","displayName":"source priority","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: source priority.","descriptionSource":"name_derived","roles":[],"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":"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":21,"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":22,"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":23,"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":"SEC Form 4 内部人交易","summaryCn":"将 Form 4 申报解析到单笔交易层，包含内部人、交易日期、买卖方向、数量和价格等信息。","useCasesCn":["筛选内部人净买入","聚合管理层交易强度","联接申报原文核实细节"],"grainCn":"每行代表“SEC Form 4 内部人交易”的一条记录；逻辑粒度由 accession_no × transaction_date × filing_date × transaction_index 共同确定。","timeSemanticsCn":"以 filing_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"accession_no","meaningCn":"SEC 对单次申报分配的唯一 accession number。"},{"name":"transaction_date","meaningCn":"transaction date 对应的日历日期。"},{"name":"filing_date","meaningCn":"申报提交或公开日期。"},{"name":"transaction_index","meaningCn":"用于确定该表业务粒度或默认顺序的 transaction index 字段。"}],"joins":[{"dataset":"event.source_document","on":"doc_id","guidanceCn":"用文档标识回溯标准化原文和来源信息；先核对两表字段口径。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 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":23,"costGuard":{"tier":"large","identityFilters":["accession_no"],"maxWindowDays":400,"requirement":"identity filter and bounded window","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.institutional_filing","namespace":"event","name":"institutional_filing","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 机构持仓申报汇总.","relation":"event.institutional_filing","objectKind":"table","rowMagnitude":"100K-999K","grain":"accession_no × filing_date","cadence":"event","timeColumn":"filing_date","defaultOrder":["filer_cik","period_of_report","accession_no"],"filters":[{"name":"accession_no","column":"accession_no","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"filer_cik","column":"filer_cik","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"form_type","column":"form_type","required":false,"multipleValues":true,"jsonType":"string","example":"10-Q"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["filer_cik","period_of_report","accession_no"],"provenanceColumns":[],"fieldCount":14,"fields":[{"position":1,"name":"filer_cik","displayName":"filer cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: filer cik.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["filer_cik"],"returned":true},{"position":2,"name":"filer_name","displayName":"filer name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: filer name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":3,"name":"accession_no","displayName":"accession no","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC accession number identifying one filing submission.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["accession_no"],"returned":true},{"position":4,"name":"period_of_report","displayName":"period of report","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Source-normalized field: period of report.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","returned":true},{"position":5,"name":"filing_date","displayName":"filing date","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"Date on which the filing was submitted or published.","descriptionSource":"standard_glossary","roles":["time"],"filterNames":[],"jsonFormat":"date-time","unit":"date","returned":true},{"position":6,"name":"form_type","displayName":"form type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: form type.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["form_type"],"returned":true},{"position":7,"name":"amendment_no","displayName":"amendment no","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: amendment no.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"total_value_usd","displayName":"total value usd","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"US-dollar value for total value usd.","descriptionSource":"name_derived","roles":[],"filterNames":[],"unit":"USD","returned":true},{"position":9,"name":"total_holdings","displayName":"total holdings","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Source-normalized field: total holdings.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"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":11,"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":12,"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":13,"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":14,"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":"这是公告、新闻与可交易事件中的“机构持仓申报汇总”数据集；一行由 filer_cik、period_of_report、accession_no 定位，主要字段包括 filer_name、filing_date、form_type、amendment_no、total_value_usd。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“机构持仓申报汇总”的一条记录；逻辑粒度由 accession_no × filing_date 共同确定。","timeSemanticsCn":"以 filing_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"accession_no","meaningCn":"SEC 对单次申报分配的唯一 accession number。"},{"name":"filing_date","meaningCn":"申报提交或公开日期。"},{"name":"filer_cik","meaningCn":"用于确定该表业务粒度或默认顺序的 filer cik 字段。"},{"name":"period_of_report","meaningCn":"用于确定该表业务粒度或默认顺序的 period of report 字段。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"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":14,"costGuard":{"tier":"small","identityFilters":["accession_no"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"UNCLASSIFIED","deniedSources":[],"reasons":["no_observed_source_and_no_source_column"]}},{"object":"dataset_schema","asset":"event.institutional_holdings","namespace":"event","name":"institutional_holdings","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 机构持仓申报明细.","relation":"event.institutional_holdings","objectKind":"table","rowMagnitude":"10M-99M","grain":"accession_no × cusip × filer_cik × period_of_report × ticker_or_class × instrument_id","cadence":"quarterly","timeColumn":"updated_at","defaultOrder":["filer_cik","period_of_report","cusip","ticker_or_class"],"filters":[{"name":"accession_no","column":"accession_no","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"filer_cik","column":"filer_cik","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"instrument_id","column":"instrument_id","required":true,"multipleValues":true,"jsonType":"integer","example":1},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"}],"maxLimit":5000,"maxWindowDays":400,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["filer_cik","period_of_report","cusip","ticker_or_class"],"provenanceColumns":[],"fieldCount":22,"fields":[{"position":1,"name":"filer_cik","displayName":"filer cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: filer cik.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["filer_cik"],"returned":true},{"position":2,"name":"period_of_report","displayName":"period of report","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Source-normalized field: period of report.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","returned":true},{"position":3,"name":"cusip","displayName":"cusip","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: cusip.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":4,"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","required_filter"],"filterNames":["instrument_id"],"returned":true},{"position":5,"name":"issuer_name","displayName":"issuer name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: issuer name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"ticker_or_class","displayName":"ticker or class","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: ticker or class.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":7,"name":"value_usd","displayName":"value usd","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"US-dollar value for value usd.","descriptionSource":"name_derived","roles":[],"filterNames":[],"unit":"USD","returned":true},{"position":8,"name":"shares_or_principal","displayName":"shares or principal","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"Source-normalized field: shares or principal.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"ssh_prnamt_type","displayName":"ssh prnamt type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: ssh prnamt type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"investment_discretion","displayName":"investment discretion","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: investment discretion.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"voting_sole","displayName":"voting sole","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"Source-normalized field: voting sole.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"voting_shared","displayName":"voting shared","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"Source-normalized field: voting shared.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"voting_none","displayName":"voting none","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"Source-normalized field: voting none.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"accession_no","displayName":"accession no","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC accession number identifying one filing submission.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["accession_no"],"returned":true},{"position":15,"name":"row_index","displayName":"row index","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Source-normalized field: row index.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"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":17,"name":"source_priority","displayName":"source priority","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: source priority.","descriptionSource":"name_derived","roles":[],"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":["time"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"机构持仓申报明细","summaryCn":"这是公告、新闻与可交易事件中的“机构持仓申报明细”数据集；一行由 filer_cik、period_of_report、cusip、ticker_or_class 定位，主要字段包括 instrument_id、issuer_name、value_usd、shares_or_principal、ssh_prnamt_type。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“机构持仓申报明细”的一条记录；逻辑粒度由 accession_no × cusip × filer_cik × period_of_report × ticker_or_class × instrument_id 共同确定。","timeSemanticsCn":"以 updated_at 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常随季度报告或持仓披露更新。","keyFields":[{"name":"accession_no","meaningCn":"SEC 对单次申报分配的唯一 accession number。"},{"name":"cusip","meaningCn":"用于确定该表业务粒度或默认顺序的 cusip 字段。"},{"name":"filer_cik","meaningCn":"用于确定该表业务粒度或默认顺序的 filer cik 字段。"},{"name":"period_of_report","meaningCn":"用于确定该表业务粒度或默认顺序的 period of report 字段。"},{"name":"ticker_or_class","meaningCn":"用于确定该表业务粒度或默认顺序的 ticker or class 字段。"},{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；必须提供 instrument_id；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["该关系数据量较大，必须提供 instrument_id；这只限制单次扫描，不减少可访问历史。","单次请求的 start/end 最长 400 天；全历史请按时间窗连续分页。"],"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":22,"costGuard":{"tier":"small","identityFilters":["accession_no","instrument_id"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.ipo_calendar","namespace":"event","name":"ipo_calendar","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: IPO 日历.","relation":"event.ipo_calendar","objectKind":"table","rowMagnitude":"1K-9K","grain":"ticker × announced_date × source","cadence":"daily","timeColumn":"publish_ts","defaultOrder":["ticker","announced_date","source"],"filters":[{"name":"cik","column":"cik","required":false,"multipleValues":true,"jsonType":"string","example":"0000320193"},{"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":["ticker","announced_date","source"],"provenanceColumns":[],"fieldCount":40,"fields":[{"position":1,"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","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["ticker"],"returned":true},{"position":2,"name":"announced_date","displayName":"announced date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for announced date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":3,"name":"last_updated_date","displayName":"last updated date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for last updated date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":4,"name":"issuer_name","displayName":"issuer name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: issuer name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"currency_code","displayName":"currency code","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: currency code.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"primary_exchange","displayName":"primary exchange","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: primary exchange.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"security_type","displayName":"security type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: security type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"security_description","displayName":"security description","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: security description.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"ipo_status","displayName":"ipo status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: ipo status.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"final_issue_price","displayName":"final issue price","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Price value for final issue price.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"lowest_offer_price","displayName":"lowest offer price","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Price value for lowest offer price.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"highest_offer_price","displayName":"highest offer price","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Price value for highest offer price.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"total_offer_size","displayName":"total offer size","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total offer size.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"max_shares_offered","displayName":"max shares offered","clickhouseType":"Nullable(Int64)","jsonType":"integer","nullable":true,"description":"Source-normalized field: max shares offered.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"shares_outstanding","displayName":"shares outstanding","clickhouseType":"Nullable(Int64)","jsonType":"integer","nullable":true,"description":"Source-normalized field: shares outstanding.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"lot_size","displayName":"lot size","clickhouseType":"Nullable(Int32)","jsonType":"integer","nullable":true,"description":"Source-normalized field: lot size.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"name":"listing_date","displayName":"listing date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for listing date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":18,"name":"issue_start_date","displayName":"issue start date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for issue start date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":19,"name":"issue_end_date","displayName":"issue end date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for issue end date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":20,"name":"min_shares_offered","displayName":"min shares offered","clickhouseType":"Nullable(Int64)","jsonType":"integer","nullable":true,"description":"Source-normalized field: min shares offered.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":21,"name":"underwriter","displayName":"underwriter","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: underwriter.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":22,"name":"cik","displayName":"cik","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"SEC Central Index Key identifying the filer.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["cik"],"returned":true},{"position":23,"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":24,"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":25,"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":26,"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":27,"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":28,"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":29,"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":30,"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":31,"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":32,"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":33,"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":34,"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":35,"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":36,"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":37,"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":38,"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":39,"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":40,"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":"IPO 日历","summaryCn":"这是公告、新闻与可交易事件中的“IPO 日历”数据集；一行由 ticker、announced_date、source 定位，主要字段包括 last_updated_date、issuer_name、currency_code、primary_exchange、security_type。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“IPO 日历”的一条记录；逻辑粒度由 ticker × announced_date × source 共同确定。","timeSemanticsCn":"以 publish_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"ticker","meaningCn":"来源或证券主表使用的股票代码。"},{"name":"announced_date","meaningCn":"announced date 对应的日历日期。"},{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"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":40,"costGuard":{"tier":"small","identityFilters":["cik","ticker"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.ma_buyback_catalyst","namespace":"event","name":"ma_buyback_catalyst","coverageTags":["news_events"],"description":"M&A / buyback catalyst events parsed from SEC 8-K filings.","relation":"event.ma_buyback_catalyst","objectKind":"table","rowMagnitude":"10K-99K","grain":"instrument_id × event_date × catalyst_subtype","cadence":"event","timeColumn":"event_date","defaultOrder":["event_date","instrument_id"],"filters":[{"name":"catalyst_subtype","column":"catalyst_subtype","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"instrument_id","column":"instrument_id","required":false,"multipleValues":true,"jsonType":"integer","example":1},{"name":"role","column":"role","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":false,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":26,"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"],"filterNames":["instrument_id"],"returned":true},{"position":2,"name":"catalyst_subtype","displayName":"catalyst subtype","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: catalyst subtype.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["catalyst_subtype"],"returned":true},{"position":3,"name":"event_date","displayName":"event date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for event date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["time","default_order","warehouse_primary_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":4,"name":"role","displayName":"role","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: role.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["role"],"returned":true},{"position":5,"name":"counterparty","displayName":"counterparty","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: counterparty.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"amount_usd","displayName":"amount usd","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"US-dollar value for amount usd.","descriptionSource":"name_derived","roles":[],"filterNames":[],"unit":"USD","returned":true},{"position":7,"name":"title","displayName":"title","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Human-readable title supplied or normalized from the source.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"accession_number","displayName":"accession number","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: accession number.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"cik","displayName":"cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC Central Index Key identifying the filer.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"form_type","displayName":"form type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: form type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"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":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":12,"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":13,"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":14,"name":"source","displayName":"source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":15,"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":16,"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":17,"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":18,"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":19,"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":20,"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":21,"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":22,"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":23,"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":24,"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":25,"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":26,"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":"从 SEC 8-K 中抽取并购、回购等资本行动催化事件，并映射到证券、日期和子类型。","useCasesCn":["发现新披露的并购或回购事件","按催化剂类型构建事件样本","联接 SEC 文件复核证据"],"grainCn":"每行代表“并购与回购催化剂”的一条记录；逻辑粒度由 instrument_id × event_date × catalyst_subtype 共同确定。","timeSemanticsCn":"以 event_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"event_date","meaningCn":"event date 对应的日历日期。"},{"name":"catalyst_subtype","meaningCn":"用于确定该表业务粒度或默认顺序的 catalyst subtype 字段。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 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":26,"costGuard":{"tier":"small","identityFilters":["instrument_id"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.market_movers_snapshot","namespace":"event","name":"market_movers_snapshot","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 市场涨跌异动榜快照.","relation":"event.market_movers_snapshot","objectKind":"table","rowMagnitude":"100K-999K","grain":"observed_at × direction × rank","cadence":"intraday","timeColumn":"observed_at","defaultOrder":["observed_at","direction","rank"],"filters":[{"name":"code","column":"code","required":false,"multipleValues":true,"jsonType":"string","example":"AAPL"},{"name":"direction","column":"direction","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"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"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"relation_default","contractVersion":null,"uniqueKey":["observed_at","direction","rank"],"provenanceColumns":[],"fieldCount":24,"fields":[{"position":1,"name":"observed_at","displayName":"observed at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for observed at.","descriptionSource":"name_derived","roles":["time","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":2,"name":"direction","displayName":"direction","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: direction.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["direction"],"returned":true},{"position":3,"name":"rank","displayName":"rank","clickhouseType":"UInt16","jsonType":"integer","nullable":false,"description":"One-based or source-defined rank within the row's cohort.","descriptionSource":"standard_glossary","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":4,"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"],"filterNames":["instrument_id"],"returned":true},{"position":5,"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":6,"name":"change_perc","displayName":"change perc","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: change perc.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"change_abs","displayName":"change abs","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: change abs.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"last_price","displayName":"last price","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Price value for last price.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"day_volume","displayName":"day volume","clickhouseType":"Nullable(UInt64)","jsonType":"integer","nullable":true,"description":"Quantity for day volume.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"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":11,"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":12,"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":13,"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":14,"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":15,"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":16,"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":17,"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":18,"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":19,"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":20,"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":21,"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":22,"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":23,"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":24,"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":"这是公告、新闻与可交易事件中的“市场涨跌异动榜快照”数据集；一行由 observed_at、direction、rank 定位，主要字段包括 instrument_id、code、change_perc、change_abs、last_price。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“市场涨跌异动榜快照”的一条记录；逻辑粒度由 observed_at × direction × rank 共同确定。","timeSemanticsCn":"以 observed_at 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"交易时段内可多次更新；请检查时间列判断新鲜度。","keyFields":[{"name":"observed_at","meaningCn":"observed at 对应的时间戳；除表内特别说明外按 UTC 解释。"},{"name":"direction","meaningCn":"用于确定该表业务粒度或默认顺序的 direction 字段。"},{"name":"rank","meaningCn":"用于确定该表业务粒度或默认顺序的 rank 字段。"}],"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":["code","instrument_id"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.news_central_bank","namespace":"event","name":"news_central_bank","coverageTags":["news_events"],"description":"Central-bank news and speeches.","relation":"event.news_central_bank","objectKind":"table","rowMagnitude":"<1K","grain":"bank × url × publish_date","cadence":"event","timeColumn":"publish_date","defaultOrder":["publish_date","bank","url"],"filters":[{"name":"bank","column":"bank","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"doc_type","column":"doc_type","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":22,"fields":[{"position":1,"name":"bank","displayName":"bank","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: bank.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["bank"],"returned":true},{"position":2,"name":"publish_date","displayName":"publish date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for publish date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["time","default_order","warehouse_primary_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":3,"name":"url","displayName":"url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Canonical URL attached to the record.","descriptionSource":"standard_glossary","roles":["default_order","warehouse_primary_key"],"filterNames":[],"returned":true},{"position":4,"name":"doc_id","displayName":"doc id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for doc.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"doc_type","displayName":"doc type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: doc type.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["doc_type"],"returned":true},{"position":6,"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":7,"name":"title","displayName":"title","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Human-readable title supplied or normalized from the source.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"body_path","displayName":"body path","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: body path.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"internal body/object-path/raw-payload surface; retrieval requires a separate entitled endpoint"},{"position":9,"name":"speaker","displayName":"speaker","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: speaker.","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":"每行代表“央行新闻与讲话”的一条记录；逻辑粒度由 bank × url × publish_date 共同确定。","timeSemanticsCn":"以 publish_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"bank","meaningCn":"用于确定该表业务粒度或默认顺序的 bank 字段。"},{"name":"url","meaningCn":"用于确定该表业务粒度或默认顺序的 url 字段。"},{"name":"publish_date","meaningCn":"publish date 对应的日历日期。"}],"joins":[{"dataset":"event.source_document","on":"doc_id","guidanceCn":"用文档标识回溯标准化原文和来源信息；先核对两表字段口径。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 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":21,"costGuard":{"tier":"small","identityFilters":[],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.news_eodhd","namespace":"event","name":"news_eodhd","coverageTags":["news_events"],"description":"EODHD news articles (one row per article × tagged ticker) with per-symbol sentiment for case-library evidence.","relation":"event.news_eodhd_ticker_fast","objectKind":"table","rowMagnitude":"1M-9M","grain":"published_at × ticker × article_id","cadence":"producer_schedule","timeColumn":"published_at","defaultOrder":["published_at","ticker","article_id"],"filters":[{"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":"1208.HK","exampleSource":"verified_production_value"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":15,"fields":[{"position":1,"name":"article_id","displayName":"article id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for article.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key"],"filterNames":[],"returned":true},{"position":2,"name":"published_at","displayName":"published at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the source published the record.","descriptionSource":"standard_glossary","roles":["time","default_order","warehouse_primary_key"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":3,"name":"ticker","displayName":"ticker","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Ticker symbol reported by the source or mapped security master.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["ticker"],"returned":true},{"position":4,"name":"title","displayName":"title","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Human-readable title supplied or normalized from the source.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"url","displayName":"url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Canonical URL attached to the record.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":6,"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":7,"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":8,"name":"sentiment_score","displayName":"sentiment score","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: sentiment score.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"sentiment_pos","displayName":"sentiment pos","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: sentiment pos.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"sentiment_neg","displayName":"sentiment neg","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: sentiment neg.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"sentiment_neu","displayName":"sentiment neu","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: sentiment neu.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"tags","displayName":"tags","clickhouseType":"Array(String)","jsonType":"array","nullable":false,"description":"Source-normalized field: tags.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"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":14,"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":15,"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":"EODHD 个股新闻","summaryCn":"每行对应一篇文章与一个被标注证券，包含文章时间、内容元数据和该证券的情绪结果。","useCasesCn":["查询某只股票的新闻时间线","构建逐股新闻情绪因子","联接文章证据做案例研究"],"grainCn":"每行代表“EODHD 个股新闻”的一条记录；逻辑粒度由 published_at × ticker × article_id 共同确定。","timeSemanticsCn":"以 published_at 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"published_at","meaningCn":"published at 对应的时间戳；除表内特别说明外按 UTC 解释。"},{"name":"ticker","meaningCn":"来源或证券主表使用的股票代码。"},{"name":"article_id","meaningCn":"用于识别 article 的业务标识。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"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":15,"costGuard":{"tier":"small","identityFilters":["ticker"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"DENIED","deniedSources":["eodhd"],"reasons":["restricted_license_scope","restricted_visibility_tier"]}},{"object":"dataset_schema","asset":"event.news_eodhd_articles","namespace":"event","name":"news_eodhd_articles","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: EODHD 新闻全文与证券标签.","relation":"event.news_eodhd","objectKind":"table","rowMagnitude":"1M-9M","grain":"article_id × published_at","cadence":"intraday","timeColumn":"published_at","defaultOrder":["published_at","article_id"],"filters":[{"name":"article_id","column":"article_id","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"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":100,"maxWindowDays":7,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["published_at","article_id"],"provenanceColumns":[],"fieldCount":27,"fields":[{"position":1,"name":"article_id","displayName":"article id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for article.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["article_id"],"returned":true},{"position":2,"name":"headline","displayName":"headline","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: headline.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":3,"name":"body","displayName":"body","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: body.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"internal body/object-path/raw-payload surface; retrieval requires a separate entitled endpoint"},{"position":4,"name":"article_url","displayName":"article url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: article url.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"published_at","displayName":"published at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the source published the record.","descriptionSource":"standard_glossary","roles":["time","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":6,"name":"symbols","displayName":"symbols","clickhouseType":"Array(String)","jsonType":"array","nullable":false,"description":"Source-normalized field: symbols.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"sentiment_polarity","displayName":"sentiment polarity","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: sentiment polarity.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"sentiment_neg","displayName":"sentiment neg","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: sentiment neg.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"sentiment_neu","displayName":"sentiment neu","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: sentiment neu.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"sentiment_pos","displayName":"sentiment pos","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: sentiment pos.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"tags","displayName":"tags","clickhouseType":"Array(String)","jsonType":"array","nullable":false,"description":"Source-normalized field: tags.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"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":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":13,"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":14,"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":15,"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":16,"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":17,"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":18,"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":19,"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":20,"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":21,"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":22,"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":23,"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":24,"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":25,"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":26,"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":27,"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":"EODHD 新闻全文与证券标签","summaryCn":"这是公告、新闻与可交易事件中的“EODHD 新闻全文与证券标签”数据集；一行由 published_at、article_id 定位，主要字段包括 headline、body、article_url、symbols、sentiment_polarity。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“EODHD 新闻全文与证券标签”的一条记录；逻辑粒度由 article_id × published_at 共同确定。","timeSemanticsCn":"以 published_at 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"交易时段内可多次更新；请检查时间列判断新鲜度。","keyFields":[{"name":"article_id","meaningCn":"用于识别 article 的业务标识。"},{"name":"published_at","meaningCn":"published at 对应的时间戳；除表内特别说明外按 UTC 解释。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 100 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["单次请求的 start/end 最长 7 天；全历史请按时间窗连续分页。"],"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":26,"costGuard":{"tier":"small","identityFilters":[],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"DENIED","deniedSources":["eodhd"],"reasons":["restricted_license_scope","restricted_visibility_tier"]}},{"object":"dataset_schema","asset":"event.news_gdelt","namespace":"event","name":"news_gdelt","coverageTags":["news_events"],"description":"GDELT news records.","relation":"event.news_gdelt","objectKind":"table","rowMagnitude":"100K-999K","grain":"url_hash × publish_ts","cadence":"intraday","timeColumn":"publish_ts","defaultOrder":["publish_ts","source","url_hash"],"filters":[{"name":"domain","column":"domain","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"language","column":"language","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":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":29,"fields":[{"position":1,"name":"url_hash","displayName":"url hash","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: url hash.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key"],"filterNames":[],"returned":true},{"position":2,"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","default_order","warehouse_primary_key","provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":3,"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","provenance"],"filterNames":["source"],"returned":true},{"position":4,"name":"url","displayName":"url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Canonical URL attached to the record.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"domain","displayName":"domain","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: domain.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["domain"],"returned":true},{"position":6,"name":"language","displayName":"language","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: language.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["language"],"returned":true},{"position":7,"name":"title","displayName":"title","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Human-readable title supplied or normalized from the source.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"tone","displayName":"tone","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: tone.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"positive_score","displayName":"positive score","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: positive score.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"negative_score","displayName":"negative score","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: negative score.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"polarity","displayName":"polarity","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: polarity.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"activity_ref","displayName":"activity ref","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: activity ref.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"self_group_ref","displayName":"self group ref","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: self group ref.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"word_count","displayName":"word count","clickhouseType":"Nullable(UInt32)","jsonType":"integer","nullable":true,"description":"Count of word count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"themes","displayName":"themes","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: themes.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"locations_json","displayName":"locations json","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: locations json.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"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":18,"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":19,"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":20,"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":21,"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":22,"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":23,"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":24,"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":25,"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":26,"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":27,"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":28,"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":29,"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":"GDELT 全球新闻","summaryCn":"保存 GDELT 抓取的全球新闻记录、发布时间、来源链接及标准化元数据，适合大范围事件检索。","useCasesCn":["检索跨市场全球新闻","统计主题或来源活跃度","联接事件流构建外部证据"],"grainCn":"每行代表“GDELT 全球新闻”的一条记录；逻辑粒度由 url_hash × publish_ts 共同确定。","timeSemanticsCn":"以 publish_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"交易时段内可多次更新；请检查时间列判断新鲜度。","keyFields":[{"name":"url_hash","meaningCn":"用于确定该表业务粒度或默认顺序的 url hash 字段。"},{"name":"publish_ts","meaningCn":"PIT 查询使用的可知时间边界。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"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":29,"costGuard":{"tier":"small","identityFilters":[],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.news_sentiment_daily_eodhd","namespace":"event","name":"news_sentiment_daily_eodhd","coverageTags":["news_events"],"description":"EODHD daily aggregated news sentiment per symbol (counts and normalized score).","relation":"event.news_sentiment_daily_eodhd","objectKind":"table","rowMagnitude":"100K-999K","grain":"instrument_id × sentiment_date","cadence":"daily","timeColumn":"sentiment_date","defaultOrder":["sentiment_date","code","market"],"filters":[{"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":"verified_production_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":28,"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","warehouse_primary_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","default_order"],"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"],"filterNames":["market"],"returned":true},{"position":4,"name":"sentiment_date","displayName":"sentiment date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for sentiment date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["time","default_order","warehouse_primary_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":5,"name":"article_count","displayName":"article count","clickhouseType":"Nullable(UInt32)","jsonType":"integer","nullable":true,"description":"Count of article count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"normalized_sentiment","displayName":"normalized sentiment","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: normalized sentiment.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"positive_count","displayName":"positive count","clickhouseType":"Nullable(UInt32)","jsonType":"integer","nullable":true,"description":"Count of positive count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"neutral_count","displayName":"neutral count","clickhouseType":"Nullable(UInt32)","jsonType":"integer","nullable":true,"description":"Count of neutral count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"negative_count","displayName":"negative count","clickhouseType":"Nullable(UInt32)","jsonType":"integer","nullable":true,"description":"Count of negative count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"payload_json","displayName":"payload json","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: payload json.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"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":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":12,"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":13,"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":14,"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":15,"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":16,"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":17,"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":18,"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":19,"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":20,"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":21,"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":22,"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":23,"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":24,"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":25,"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":26,"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":27,"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":28,"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":{"supported":true,"asOfRequired":true,"timeColumn":"sentiment_date","keyColumns":["instrument_id","sentiment_date","source"],"maxLimit":1000,"maxWindowDays":400},"titleCn":"EODHD 每日新闻情绪","summaryCn":"将 EODHD 文章按证券和日期聚合为新闻数量与标准化情绪分数，便于直接进入日频研究。","useCasesCn":["比较个股每日新闻情绪","构建情绪变化因子","对照收益研究新闻冲击"],"grainCn":"每行代表“EODHD 每日新闻情绪”的一条记录；逻辑粒度由 instrument_id × sentiment_date 共同确定。","timeSemanticsCn":"以 sentiment_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"sentiment_date","meaningCn":"sentiment date 对应的日历日期。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 cursor，结果过大时必须缩小标的、日期或其他筛选。","caveatsCn":["做历史回测时优先使用 PIT 端点并传 as_of，避免把后来披露的数据带回过去。"],"supportedMarkets":["US"],"coverage":{"measured":true,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{"US":{"latestBusinessDate":"2026-08-28","rows":10156}},"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":28,"costGuard":{"tier":"medium","identityFilters":["code","instrument_id"],"maxWindowDays":400,"requirement":"identity filter or bounded window","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"DENIED","deniedSources":["eodhd"],"reasons":["restricted_license_scope","restricted_visibility_tier"]}},{"object":"dataset_schema","asset":"event.news_social_post","namespace":"event","name":"news_social_post","coverageTags":["news_events"],"description":"Social news posts.","relation":"event.news_social_post","objectKind":"table","rowMagnitude":"10K-99K","grain":"post_id × platform × publish_ts","cadence":"intraday","timeColumn":"publish_ts","defaultOrder":["publish_ts","platform","post_id"],"filters":[{"name":"platform","column":"platform","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"},{"name":"subreddit","column":"subreddit","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":25,"fields":[{"position":1,"name":"platform","displayName":"platform","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: platform.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["platform"],"returned":true},{"position":2,"name":"post_id","displayName":"post id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for post.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key"],"filterNames":[],"returned":true},{"position":3,"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","default_order","warehouse_primary_key","provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":4,"name":"source","displayName":"source","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["filter","provenance"],"filterNames":["source"],"returned":true},{"position":5,"name":"subreddit","displayName":"subreddit","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: subreddit.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["subreddit"],"returned":true},{"position":6,"name":"author","displayName":"author","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: author.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"title","displayName":"title","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Human-readable title supplied or normalized from the source.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"body","displayName":"body","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: body.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"internal body/object-path/raw-payload surface; retrieval requires a separate entitled endpoint"},{"position":9,"name":"blob_path","displayName":"blob path","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: blob path.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"internal body/object-path/raw-payload surface; retrieval requires a separate entitled endpoint"},{"position":10,"name":"score","displayName":"score","clickhouseType":"Nullable(Int64)","jsonType":"integer","nullable":true,"description":"Source-normalized field: score.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"num_comments","displayName":"num comments","clickhouseType":"Nullable(Int64)","jsonType":"integer","nullable":true,"description":"Source-normalized field: num comments.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"tickers","displayName":"tickers","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: tickers.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"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":14,"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":15,"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":16,"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":17,"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":18,"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":19,"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":20,"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":21,"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":22,"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":23,"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":24,"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":25,"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":"每行代表“社交新闻帖子”的一条记录；逻辑粒度由 post_id × platform × publish_ts 共同确定。","timeSemanticsCn":"以 publish_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"交易时段内可多次更新；请检查时间列判断新鲜度。","keyFields":[{"name":"post_id","meaningCn":"用于识别 post 的业务标识。"},{"name":"platform","meaningCn":"用于确定该表业务粒度或默认顺序的 platform 字段。"},{"name":"publish_ts","meaningCn":"PIT 查询使用的可知时间边界。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"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":23,"costGuard":{"tier":"small","identityFilters":[],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.ofac_sdn_snapshot","namespace":"event","name":"ofac_sdn_snapshot","coverageTags":["news_events"],"description":"OFAC SDN snapshot history.","relation":"event.ofac_sdn_snapshot","objectKind":"table","rowMagnitude":"1M-9M","grain":"sdn_id × snapshot_date","cadence":"daily","timeColumn":"snapshot_date","defaultOrder":["snapshot_date","sdn_id","source"],"filters":[{"name":"entity_type","column":"entity_type","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"program","column":"program","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"sdn_id","column":"sdn_id","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":20,"fields":[{"position":1,"name":"snapshot_date","displayName":"snapshot date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for snapshot date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["time","default_order","warehouse_primary_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":2,"name":"sdn_id","displayName":"sdn id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for sdn.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["sdn_id"],"returned":true},{"position":3,"name":"name","displayName":"name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Canonical human-readable name.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":4,"name":"program","displayName":"program","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: program.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["program"],"returned":true},{"position":5,"name":"entity_type","displayName":"entity type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: entity type.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["entity_type"],"returned":true},{"position":6,"name":"raw_json","displayName":"raw json","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: raw json.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"internal body/object-path/raw-payload surface; retrieval requires a separate entitled endpoint"},{"position":7,"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","provenance"],"filterNames":["source"],"returned":true},{"position":8,"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":9,"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":10,"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":11,"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":12,"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":13,"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":14,"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":15,"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":16,"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":17,"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":18,"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":19,"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":20,"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":"OFAC 制裁名单快照","summaryCn":"按快照日期保留美国 OFAC SDN 名单实体，支持查询名单变化和历史时点状态。","useCasesCn":["核查实体是否出现在制裁名单","比较相邻快照新增删除","构建合规事件时间线"],"grainCn":"每行代表“OFAC 制裁名单快照”的一条记录；逻辑粒度由 sdn_id × snapshot_date 共同确定。","timeSemanticsCn":"以 snapshot_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"sdn_id","meaningCn":"用于识别 sdn 的业务标识。"},{"name":"snapshot_date","meaningCn":"snapshot date 对应的日历日期。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 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":19,"costGuard":{"tier":"large","identityFilters":[],"maxWindowDays":400,"requirement":"bounded window","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.ownership_disclosure","namespace":"event","name":"ownership_disclosure","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 受益所有权披露.","relation":"event.ownership_disclosure","objectKind":"table","rowMagnitude":"100K-999K","grain":"accession_no × subject_cik","cadence":"quarterly","timeColumn":"event_date","defaultOrder":["subject_cik","filing_date","accession_no"],"filters":[{"name":"accession_no","column":"accession_no","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"filer_cik","column":"filer_cik","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"form_type","column":"form_type","required":false,"multipleValues":true,"jsonType":"string","example":"10-Q"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"},{"name":"subject_cik","column":"subject_cik","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["subject_cik","filing_date","accession_no"],"provenanceColumns":[],"fieldCount":25,"fields":[{"position":1,"name":"filer_cik","displayName":"filer cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: filer cik.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["filer_cik"],"returned":true},{"position":2,"name":"filer_name","displayName":"filer name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: filer name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":3,"name":"subject_cik","displayName":"subject cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: subject cik.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["subject_cik"],"returned":true},{"position":4,"name":"subject_name","displayName":"subject name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: subject name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"accession_no","displayName":"accession no","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC accession number identifying one filing submission.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["accession_no"],"returned":true},{"position":6,"name":"filing_date","displayName":"filing date","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"Date on which the filing was submitted or published.","descriptionSource":"standard_glossary","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date-time","unit":"date","returned":true},{"position":7,"name":"form_type","displayName":"form type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: form type.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["form_type"],"returned":true},{"position":8,"name":"event_date","displayName":"event date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for event date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["time"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":9,"name":"percent_of_class","displayName":"percent of class","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"Source-normalized field: percent of class.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"sole_voting","displayName":"sole voting","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: sole voting.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"shared_voting","displayName":"shared voting","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: shared voting.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"sole_dispositive","displayName":"sole dispositive","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: sole dispositive.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"shared_dispositive","displayName":"shared dispositive","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: shared dispositive.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"aggregate_amount","displayName":"aggregate amount","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"Source-normalized field: aggregate amount.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"purpose_of_transaction","displayName":"purpose of transaction","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: purpose of transaction.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"is_passive","displayName":"is passive","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Whether passive applies to the row.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"name":"is_amendment","displayName":"is amendment","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Whether amendment applies to the row.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":18,"name":"amendment_no","displayName":"amendment no","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: amendment no.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":19,"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":20,"name":"source_priority","displayName":"source priority","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: source priority.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":21,"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":22,"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":23,"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":24,"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":25,"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":"这是公告、新闻与可交易事件中的“受益所有权披露”数据集；一行由 subject_cik、filing_date、accession_no 定位，主要字段包括 filer_cik、filer_name、subject_name、form_type、event_date。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“受益所有权披露”的一条记录；逻辑粒度由 accession_no × subject_cik 共同确定。","timeSemanticsCn":"以 event_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常随季度报告或持仓披露更新。","keyFields":[{"name":"accession_no","meaningCn":"SEC 对单次申报分配的唯一 accession number。"},{"name":"subject_cik","meaningCn":"用于确定该表业务粒度或默认顺序的 subject cik 字段。"},{"name":"filing_date","meaningCn":"申报提交或公开日期。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"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":25,"costGuard":{"tier":"small","identityFilters":["accession_no"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.prediction_market_catalog","namespace":"event","name":"prediction_market_catalog","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 预测市场合约目录.","relation":"event.prediction_market_catalog","objectKind":"table","rowMagnitude":"1M-9M","grain":"snapshot_date × market_id","cadence":"producer_schedule","timeColumn":"observed_at","defaultOrder":["snapshot_date","market_id"],"filters":[{"name":"event_id","column":"event_id","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"market_id","column":"market_id","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"provider","column":"provider","required":false,"multipleValues":true,"jsonType":"string","example":"PROVIDER_VALUE"},{"name":"snapshot_date","column":"snapshot_date","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":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["snapshot_date","market_id"],"provenanceColumns":[],"fieldCount":36,"fields":[{"position":1,"name":"snapshot_date","displayName":"snapshot date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for snapshot date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["snapshot_date"],"jsonFormat":"date","unit":"date","returned":true},{"position":2,"name":"observed_at","displayName":"observed at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for observed at.","descriptionSource":"name_derived","roles":["time"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":3,"name":"market_id","displayName":"market id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for market.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["market_id"],"returned":true},{"position":4,"name":"slug","displayName":"slug","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: slug.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"question","displayName":"question","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: question.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"category","displayName":"category","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: category.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"tags","displayName":"tags","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: tags.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"event_id","displayName":"event id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Stable identifier of the normalized event.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["event_id"],"returned":true},{"position":9,"name":"end_date","displayName":"end date","clickhouseType":"Nullable(DateTime64(3, 'UTC'))","jsonType":"string","nullable":true,"description":"Calendar date for end date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"date","returned":true},{"position":10,"name":"active","displayName":"active","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: active.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"closed","displayName":"closed","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: closed.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"liquidity_num","displayName":"liquidity num","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: liquidity num.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"volume_num","displayName":"volume num","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: volume num.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"volume_24hr","displayName":"volume 24hr","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: volume 24hr.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"outcomes","displayName":"outcomes","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: outcomes.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"outcome_prices","displayName":"outcome prices","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: outcome prices.","descriptionSource":"name_derived","roles":[],"filterNames":[],"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","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":"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":21,"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":22,"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":23,"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":24,"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":25,"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":26,"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":27,"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":28,"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":29,"name":"condition_id","displayName":"condition id","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Identifier for condition.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":30,"name":"clob_token_ids","displayName":"clob token ids","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: clob token ids.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":31,"name":"description","displayName":"description","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Human-readable description supplied or normalized from the source.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":32,"name":"resolution_source","displayName":"resolution source","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: resolution source.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":33,"name":"uma_resolution_status","displayName":"uma resolution status","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: uma resolution status.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":34,"name":"uma_resolution_statuses","displayName":"uma resolution statuses","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: uma resolution statuses.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":35,"name":"native_observation_json","displayName":"native observation json","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: native observation json.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"internal body/object-path/raw-payload surface; retrieval requires a separate entitled endpoint"},{"position":36,"name":"native_winner_fields_json","displayName":"native winner fields json","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: native winner fields json.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true}],"pit":null,"titleCn":"预测市场合约目录","summaryCn":"这是公告、新闻与可交易事件中的“预测市场合约目录”数据集；一行由 snapshot_date、market_id 定位，主要字段包括 observed_at、slug、question、category、tags。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“预测市场合约目录”的一条记录；逻辑粒度由 snapshot_date × market_id 共同确定。","timeSemanticsCn":"以 observed_at 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"snapshot_date","meaningCn":"snapshot date 对应的日历日期。"},{"name":"market_id","meaningCn":"用于识别 market 的业务标识。"}],"joins":[{"dataset":"event.stream","on":"event_id","guidanceCn":"用 event_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":35,"costGuard":{"tier":"small","identityFilters":["event_id"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.prediction_market_odds","namespace":"event","name":"prediction_market_odds","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 预测市场实时赔率.","relation":"event.prediction_market_odds","objectKind":"table","rowMagnitude":"100M-999M","grain":"market_id × observed_at × outcome_index","cadence":"producer_schedule","timeColumn":"observed_at","defaultOrder":["market_id","observed_at","outcome_index"],"filters":[{"name":"market_id","column":"market_id","required":true,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"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":400,"supportsCursor":true,"readMode":"relation_default","contractVersion":null,"uniqueKey":["market_id","observed_at","outcome_index"],"provenanceColumns":[],"fieldCount":29,"fields":[{"position":1,"name":"observed_at","displayName":"observed at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for observed at.","descriptionSource":"name_derived","roles":["time","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":2,"name":"market_id","displayName":"market id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for market.","descriptionSource":"name_derived","roles":["filter","required_filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["market_id"],"returned":true},{"position":3,"name":"slug","displayName":"slug","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: slug.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":4,"name":"outcome","displayName":"outcome","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: outcome.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"outcome_index","displayName":"outcome index","clickhouseType":"UInt16","jsonType":"integer","nullable":false,"description":"Source-normalized field: outcome index.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":6,"name":"price","displayName":"price","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: price.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"best_bid","displayName":"best bid","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: best bid.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"best_ask","displayName":"best ask","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: best ask.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"spread","displayName":"spread","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: spread.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"last_trade_price","displayName":"last trade price","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Price value for last trade price.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"liquidity_num","displayName":"liquidity num","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: liquidity num.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"volume_num","displayName":"volume num","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: volume num.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"volume_24hr","displayName":"volume 24hr","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: volume 24hr.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"category","displayName":"category","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: category.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"end_date","displayName":"end date","clickhouseType":"Nullable(DateTime64(3, 'UTC'))","jsonType":"string","nullable":true,"description":"Calendar date for end date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"date","returned":true},{"position":16,"name":"active","displayName":"active","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: active.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"name":"closed","displayName":"closed","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: closed.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":18,"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":19,"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":20,"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":21,"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":22,"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":23,"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":24,"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":25,"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":26,"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":27,"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":28,"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":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}],"pit":null,"titleCn":"预测市场实时赔率","summaryCn":"这是公告、新闻与可交易事件中的“预测市场实时赔率”数据集；一行由 market_id、observed_at、outcome_index 定位，主要字段包括 slug、outcome、price、best_bid、best_ask。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“预测市场实时赔率”的一条记录；逻辑粒度由 market_id × observed_at × outcome_index 共同确定。","timeSemanticsCn":"以 observed_at 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"market_id","meaningCn":"用于识别 market 的业务标识。"},{"name":"observed_at","meaningCn":"observed at 对应的时间戳；除表内特别说明外按 UTC 解释。"},{"name":"outcome_index","meaningCn":"用于确定该表业务粒度或默认顺序的 outcome index 字段。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；必须提供 market_id；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["该关系数据量较大，必须提供 market_id；这只限制单次扫描，不减少可访问历史。","单次请求的 start/end 最长 400 天；全历史请按时间窗连续分页。"],"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":29,"costGuard":{"tier":"small","identityFilters":[],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.regulatory_action","namespace":"event","name":"regulatory_action","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 监管执法事件.","relation":"event.regulatory_action","objectKind":"table","rowMagnitude":"<1K","grain":"instrument_id × event_date × document_number","cadence":"event","timeColumn":"event_date","defaultOrder":["instrument_id","event_date","document_number"],"filters":[{"name":"action_type","column":"action_type","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"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"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["instrument_id","event_date","document_number"],"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":"agency","displayName":"agency","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: agency.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":3,"name":"action_type","displayName":"action type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: action type.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["action_type"],"returned":true},{"position":4,"name":"event_date","displayName":"event date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for event date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["time","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":5,"name":"title","displayName":"title","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Human-readable title supplied or normalized from the source.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":6,"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":7,"name":"document_number","displayName":"document number","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: document number.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":8,"name":"html_url","displayName":"html url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: html url.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"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":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":10,"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":11,"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":12,"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":13,"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":14,"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":15,"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":16,"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":17,"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":18,"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":19,"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":20,"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":21,"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":22,"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":23,"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":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、event_date、document_number 定位，主要字段包括 agency、action_type、title、company_name、html_url。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“监管执法事件”的一条记录；逻辑粒度由 instrument_id × event_date × document_number 共同确定。","timeSemanticsCn":"以 event_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"event_date","meaningCn":"event date 对应的日历日期。"},{"name":"document_number","meaningCn":"用于确定该表业务粒度或默认顺序的 document number 字段。"}],"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"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.sec_8k_item","namespace":"event","name":"sec_8k_item","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: SEC 8-K 事项明细.","relation":"event.sec_8k_item","objectKind":"table","rowMagnitude":"1M-9M","grain":"accession_no × item_code × source","cadence":"event","timeColumn":"report_date","defaultOrder":["accession_no","item_code","source"],"filters":[{"name":"accession_no","column":"accession_no","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"cik","column":"cik","required":false,"multipleValues":true,"jsonType":"string","example":"0000320193"},{"name":"form_type","column":"form_type","required":false,"multipleValues":true,"jsonType":"string","example":"10-Q"},{"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":["accession_no","item_code","source"],"provenanceColumns":[],"fieldCount":21,"fields":[{"position":1,"name":"accession_no","displayName":"accession no","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC accession number identifying one filing submission.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["accession_no"],"returned":true},{"position":2,"name":"cik","displayName":"cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC Central Index Key identifying the filer.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["cik"],"returned":true},{"position":3,"name":"item_code","displayName":"item code","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: item code.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":4,"name":"item_group","displayName":"item group","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: item group.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"form_type","displayName":"form type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: form type.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["form_type"],"returned":true},{"position":6,"name":"filing_date","displayName":"filing date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Date on which the filing was submitted or published.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":7,"name":"report_date","displayName":"report date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Reporting-period or statement date.","descriptionSource":"standard_glossary","roles":["time"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":8,"name":"items_raw","displayName":"items raw","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: items raw.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"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":10,"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":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":"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":21,"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":"SEC 8-K 事项明细","summaryCn":"这是公告、新闻与可交易事件中的“SEC 8-K 事项明细”数据集；一行由 accession_no、item_code、source 定位，主要字段包括 cik、item_group、form_type、filing_date、report_date。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“SEC 8-K 事项明细”的一条记录；逻辑粒度由 accession_no × item_code × source 共同确定。","timeSemanticsCn":"以 report_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"accession_no","meaningCn":"SEC 对单次申报分配的唯一 accession number。"},{"name":"item_code","meaningCn":"用于确定该表业务粒度或默认顺序的 item code 字段。"},{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"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":21,"costGuard":{"tier":"small","identityFilters":["accession_no","cik"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.sec_document_blob","namespace":"event","name":"sec_document_blob","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: SEC 申报附件与下载状态.","relation":"event.sec_document_blob","objectKind":"table","rowMagnitude":"1M-9M","grain":"blob_path × accession_no × document_role × sequence × filename × download_provider","cadence":"event","timeColumn":"filing_date","defaultOrder":["accession_no","document_role","sequence","filename","download_provider"],"filters":[{"name":"accession_no","column":"accession_no","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"cik","column":"cik","required":false,"multipleValues":true,"jsonType":"string","example":"0000320193"},{"name":"form_type","column":"form_type","required":false,"multipleValues":true,"jsonType":"string","example":"10-Q"},{"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":["accession_no","document_role","sequence","filename","download_provider"],"provenanceColumns":[],"fieldCount":31,"fields":[{"position":1,"name":"accession_no","displayName":"accession no","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC accession number identifying one filing submission.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["accession_no"],"returned":true},{"position":2,"name":"cik","displayName":"cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC Central Index Key identifying the filer.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["cik"],"returned":true},{"position":3,"name":"form_type","displayName":"form type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: form type.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["form_type"],"returned":true},{"position":4,"name":"filing_date","displayName":"filing date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Date on which the filing was submitted or published.","descriptionSource":"standard_glossary","roles":["time"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":5,"name":"filer_name","displayName":"filer name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: filer name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"document_role","displayName":"document role","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: document role.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":7,"name":"sequence","displayName":"sequence","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: sequence.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":8,"name":"filename","displayName":"filename","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: filename.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":9,"name":"sec_url","displayName":"sec url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: sec url.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"provider_url","displayName":"provider url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: provider url.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"internal body/object-path/raw-payload surface; retrieval requires a separate entitled endpoint"},{"position":11,"name":"download_provider","displayName":"download provider","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: download provider.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":12,"name":"status","displayName":"status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: status.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"internal body/object-path/raw-payload surface; retrieval requires a separate entitled endpoint"},{"position":13,"name":"blob_path","displayName":"blob path","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: blob path.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"internal body/object-path/raw-payload surface; retrieval requires a separate entitled endpoint"},{"position":14,"name":"blob_sha256","displayName":"blob sha256","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: blob sha256.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"size_bytes","displayName":"size bytes","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Source-normalized field: size bytes.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"content_type","displayName":"content type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: content type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"name":"http_status","displayName":"http status","clickhouseType":"Nullable(UInt16)","jsonType":"integer","nullable":true,"description":"Source-normalized field: http status.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"internal body/object-path/raw-payload surface; retrieval requires a separate entitled endpoint"},{"position":18,"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":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":"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":23,"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":24,"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":25,"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":26,"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":27,"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":28,"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":29,"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":30,"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":31,"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":"SEC 申报附件与下载状态","summaryCn":"这是公告、新闻与可交易事件中的“SEC 申报附件与下载状态”数据集；一行由 accession_no、document_role、sequence、filename 定位，主要字段包括 cik、form_type、filing_date、filer_name、sec_url。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“SEC 申报附件与下载状态”的一条记录；逻辑粒度由 blob_path × accession_no × document_role × sequence × filename × download_provider 共同确定。","timeSemanticsCn":"以 filing_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"blob_path","meaningCn":"用于确定该表业务粒度或默认顺序的 blob path 字段。"},{"name":"accession_no","meaningCn":"SEC 对单次申报分配的唯一 accession number。"},{"name":"document_role","meaningCn":"用于确定该表业务粒度或默认顺序的 document role 字段。"},{"name":"sequence","meaningCn":"用于确定该表业务粒度或默认顺序的 sequence 字段。"},{"name":"filename","meaningCn":"用于确定该表业务粒度或默认顺序的 filename 字段。"},{"name":"download_provider","meaningCn":"用于确定该表业务粒度或默认顺序的 download provider 字段。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"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":["accession_no","cik"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.sec_filing_body","namespace":"event","name":"sec_filing_body","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: SEC 申报正文.","relation":"event.sec_filing_body","objectKind":"table","rowMagnitude":"1M-9M","grain":"accession_no × source","cadence":"event","timeColumn":"filing_date","defaultOrder":["accession_no","source"],"filters":[{"name":"accession_no","column":"accession_no","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"cik","column":"cik","required":false,"multipleValues":true,"jsonType":"string","example":"0000320193"},{"name":"form_type","column":"form_type","required":false,"multipleValues":true,"jsonType":"string","example":"10-Q"},{"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":["accession_no","source"],"provenanceColumns":[],"fieldCount":22,"fields":[{"position":1,"name":"accession_no","displayName":"accession no","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC accession number identifying one filing submission.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["accession_no"],"returned":true},{"position":2,"name":"cik","displayName":"cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC Central Index Key identifying the filer.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["cik"],"returned":true},{"position":3,"name":"form_type","displayName":"form type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: form type.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["form_type"],"returned":true},{"position":4,"name":"filing_date","displayName":"filing date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Date on which the filing was submitted or published.","descriptionSource":"standard_glossary","roles":["time"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":5,"name":"body_markdown","displayName":"body markdown","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: body markdown.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"internal body/object-path/raw-payload surface; retrieval requires a separate entitled endpoint"},{"position":6,"name":"body_sha256","displayName":"body sha256","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: body sha256.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"body_size_bytes","displayName":"body size bytes","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Source-normalized field: body size bytes.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"extractor_version","displayName":"extractor version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: extractor version.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"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":10,"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":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":"SEC 申报正文","summaryCn":"这是公告、新闻与可交易事件中的“SEC 申报正文”数据集；一行由 accession_no、source 定位，主要字段包括 cik、form_type、filing_date、body_markdown、body_sha256。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“SEC 申报正文”的一条记录；逻辑粒度由 accession_no × source 共同确定。","timeSemanticsCn":"以 filing_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"accession_no","meaningCn":"SEC 对单次申报分配的唯一 accession number。"},{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"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":21,"costGuard":{"tier":"small","identityFilters":["accession_no","cik"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.sec_filing_document","namespace":"event","name":"sec_filing_document","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: SEC 申报文档清单.","relation":"event.sec_filing_document","objectKind":"table","rowMagnitude":"1M-9M","grain":"accession_no × document_role × sequence × filename × parent_source_doc_id","cadence":"event","timeColumn":"filing_date","defaultOrder":["accession_no","document_role","sequence","filename","parent_source_doc_id"],"filters":[{"name":"accession_no","column":"accession_no","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"cik","column":"cik","required":false,"multipleValues":true,"jsonType":"string","example":"0000320193"},{"name":"form_type","column":"form_type","required":false,"multipleValues":true,"jsonType":"string","example":"10-Q"},{"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":["accession_no","document_role","sequence","filename","parent_source_doc_id"],"provenanceColumns":[],"fieldCount":32,"fields":[{"position":1,"name":"accession_no","displayName":"accession no","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC accession number identifying one filing submission.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["accession_no"],"returned":true},{"position":2,"name":"cik","displayName":"cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC Central Index Key identifying the filer.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["cik"],"returned":true},{"position":3,"name":"form_type","displayName":"form type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: form type.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["form_type"],"returned":true},{"position":4,"name":"filing_date","displayName":"filing date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Date on which the filing was submitted or published.","descriptionSource":"standard_glossary","roles":["time"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":5,"name":"parent_source_doc_id","displayName":"parent source doc id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for parent source doc.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":6,"name":"source_doc_id","displayName":"source doc id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for source doc.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"document_role","displayName":"document role","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: document role.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":8,"name":"sequence","displayName":"sequence","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: sequence.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":9,"name":"sec_document_type","displayName":"sec document type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: sec document type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"filename","displayName":"filename","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: filename.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":11,"name":"description","displayName":"description","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Human-readable description supplied or normalized from the source.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"item_codes","displayName":"item codes","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: item codes.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"is_material_exhibit","displayName":"is material exhibit","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Whether material exhibit applies to the row.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"is_earnings_release","displayName":"is earnings release","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Whether earnings release applies to the row.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"source_document_created","displayName":"source document created","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: source document created.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"body_path","displayName":"body path","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: body path.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"internal body/object-path/raw-payload surface; retrieval requires a separate entitled endpoint"},{"position":17,"name":"body_sha256","displayName":"body sha256","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: body sha256.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":18,"name":"size_bytes","displayName":"size bytes","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Source-normalized field: size bytes.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":19,"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":20,"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":21,"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":22,"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":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":"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":31,"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":32,"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":"SEC 申报文档清单","summaryCn":"这是公告、新闻与可交易事件中的“SEC 申报文档清单”数据集；一行由 accession_no、document_role、sequence、filename 定位，主要字段包括 cik、form_type、filing_date、parent_source_doc_id、source_doc_id。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“SEC 申报文档清单”的一条记录；逻辑粒度由 accession_no × document_role × sequence × filename × parent_source_doc_id 共同确定。","timeSemanticsCn":"以 filing_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"accession_no","meaningCn":"SEC 对单次申报分配的唯一 accession number。"},{"name":"document_role","meaningCn":"用于确定该表业务粒度或默认顺序的 document role 字段。"},{"name":"sequence","meaningCn":"用于确定该表业务粒度或默认顺序的 sequence 字段。"},{"name":"filename","meaningCn":"用于确定该表业务粒度或默认顺序的 filename 字段。"},{"name":"parent_source_doc_id","meaningCn":"用于识别 parent source doc 的业务标识。"}],"joins":[{"dataset":"event.source_document","on":"source_doc_id","guidanceCn":"用文档标识回溯标准化原文和来源信息；先核对两表字段口径。"}],"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":31,"costGuard":{"tier":"small","identityFilters":["accession_no","cik"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.short_interest","namespace":"event","name":"short_interest","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 事件源做空余额.","relation":"event.short_interest","objectKind":"table","rowMagnitude":"10K-99K","grain":"settlement_date × ticker × source","cadence":"event","timeColumn":"settlement_date","defaultOrder":["ticker","settlement_date","source"],"filters":[{"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":["ticker","settlement_date","source"],"provenanceColumns":[],"fieldCount":23,"fields":[{"position":1,"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","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["ticker"],"returned":true},{"position":2,"name":"settlement_date","displayName":"settlement date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for settlement date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["time","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":3,"name":"short_interest","displayName":"short interest","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: short interest.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":4,"name":"avg_daily_volume","displayName":"avg daily volume","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Quantity for avg daily volume.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"days_to_cover","displayName":"days to cover","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: days to cover.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"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":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":7,"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":8,"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":9,"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":10,"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":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":"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":21,"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":22,"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":23,"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":"这是公告、新闻与可交易事件中的“事件源做空余额”数据集；一行由 ticker、settlement_date、source 定位，主要字段包括 short_interest、avg_daily_volume、days_to_cover、publish_ts、source_ts。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“事件源做空余额”的一条记录；逻辑粒度由 settlement_date × ticker × source 共同确定。","timeSemanticsCn":"以 settlement_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"settlement_date","meaningCn":"settlement date 对应的日历日期。"},{"name":"ticker","meaningCn":"来源或证券主表使用的股票代码。"},{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"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":23,"costGuard":{"tier":"small","identityFilters":["ticker"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.short_volume_daily","namespace":"event","name":"short_volume_daily","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 美国每日做空成交明细.","relation":"event.short_volume_daily","objectKind":"table","rowMagnitude":"100K-999K","grain":"trade_date × ticker × source","cadence":"daily","timeColumn":"trade_date","defaultOrder":["ticker","trade_date","source"],"filters":[{"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"},{"name":"trade_date","column":"trade_date","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["ticker","trade_date","source"],"provenanceColumns":[],"fieldCount":33,"fields":[{"position":1,"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","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["ticker"],"returned":true},{"position":2,"name":"trade_date","displayName":"trade date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Trading-session date in the dataset's market calendar.","descriptionSource":"standard_glossary","roles":["time","filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["trade_date"],"jsonFormat":"date","unit":"date","returned":true},{"position":3,"name":"short_volume","displayName":"short volume","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Quantity for short volume.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":4,"name":"total_volume","displayName":"total volume","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Quantity for total volume.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"short_volume_ratio","displayName":"short volume ratio","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Ratio value for short volume ratio.","descriptionSource":"name_derived","roles":[],"filterNames":[],"unit":"ratio","returned":true},{"position":6,"name":"exempt_volume","displayName":"exempt volume","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Quantity for exempt volume.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"non_exempt_volume","displayName":"non exempt volume","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Quantity for non exempt volume.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"nyse_short_volume","displayName":"nyse short volume","clickhouseType":"Nullable(Int64)","jsonType":"integer","nullable":true,"description":"Quantity for nyse short volume.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"nyse_short_volume_exempt","displayName":"nyse short volume exempt","clickhouseType":"Nullable(Int64)","jsonType":"integer","nullable":true,"description":"Source-normalized field: nyse short volume exempt.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"nasdaq_carteret_short_volume","displayName":"nasdaq carteret short volume","clickhouseType":"Nullable(Int64)","jsonType":"integer","nullable":true,"description":"Quantity for nasdaq carteret short volume.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"nasdaq_carteret_short_volume_exempt","displayName":"nasdaq carteret short volume exempt","clickhouseType":"Nullable(Int64)","jsonType":"integer","nullable":true,"description":"Source-normalized field: nasdaq carteret short volume exempt.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"nasdaq_chicago_short_volume","displayName":"nasdaq chicago short volume","clickhouseType":"Nullable(Int64)","jsonType":"integer","nullable":true,"description":"Quantity for nasdaq chicago short volume.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"nasdaq_chicago_short_volume_exempt","displayName":"nasdaq chicago short volume exempt","clickhouseType":"Nullable(Int64)","jsonType":"integer","nullable":true,"description":"Source-normalized field: nasdaq chicago short volume exempt.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"adf_short_volume","displayName":"adf short volume","clickhouseType":"Nullable(Int64)","jsonType":"integer","nullable":true,"description":"Quantity for adf short volume.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"adf_short_volume_exempt","displayName":"adf short volume exempt","clickhouseType":"Nullable(Int64)","jsonType":"integer","nullable":true,"description":"Source-normalized field: adf short volume exempt.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"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":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":17,"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":18,"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":19,"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":20,"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":21,"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":22,"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":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},{"position":32,"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":33,"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":"这是公告、新闻与可交易事件中的“美国每日做空成交明细”数据集；一行由 ticker、trade_date、source 定位，主要字段包括 short_volume、total_volume、short_volume_ratio、exempt_volume、non_exempt_volume。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“美国每日做空成交明细”的一条记录；逻辑粒度由 trade_date × ticker × source 共同确定。","timeSemanticsCn":"以 trade_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"trade_date","meaningCn":"对应市场日历中的交易日。"},{"name":"ticker","meaningCn":"来源或证券主表使用的股票代码。"},{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"}],"joins":[{"dataset":"ref.calendar","on":"market + trade_date（有 market 时）","guidanceCn":"需要计算交易日偏移时联接交易日历；无 market 字段时先确定适用市场。"}],"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":33,"costGuard":{"tier":"small","identityFilters":["ticker"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.social_shoutout","namespace":"event","name":"social_shoutout","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 社交媒体标的提及.","relation":"event.social_shoutout","objectKind":"table","rowMagnitude":"0","grain":"platform × instrument_id × tweet_ts × post_id","cadence":"producer_schedule","timeColumn":"updated_at","defaultOrder":["platform","instrument_id","tweet_ts","post_id"],"filters":[{"name":"direction","column":"direction","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"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"},{"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":["platform","instrument_id","tweet_ts","post_id"],"provenanceColumns":[],"fieldCount":44,"fields":[{"position":1,"name":"platform","displayName":"platform","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: platform.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":2,"name":"post_id","displayName":"post id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for post.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":3,"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":4,"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":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":"tweet_ts","displayName":"tweet ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for tweet ts.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":7,"name":"handle","displayName":"handle","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: handle.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"author_name","displayName":"author name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: author name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"author_id","displayName":"author id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for author.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"author_followers","displayName":"author followers","clickhouseType":"Nullable(UInt64)","jsonType":"integer","nullable":true,"description":"Source-normalized field: author followers.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"author_verified","displayName":"author verified","clickhouseType":"Nullable(UInt8)","jsonType":"integer","nullable":true,"description":"Source-normalized field: author verified.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"direction","displayName":"direction","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: direction.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["direction"],"returned":true},{"position":13,"name":"action","displayName":"action","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: action.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"confidence","displayName":"confidence","clickhouseType":"Nullable(Float32)","jsonType":"number","nullable":true,"description":"Source-normalized field: confidence.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"hard_veto","displayName":"hard veto","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: hard veto.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"trigger_eligible","displayName":"trigger eligible","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: trigger eligible.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"name":"non_triggering","displayName":"non triggering","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: non triggering.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":18,"name":"priority_tier","displayName":"priority tier","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: priority tier.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":19,"name":"lane","displayName":"lane","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: lane.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":20,"name":"role","displayName":"role","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: role.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":21,"name":"account_quality_tier","displayName":"account quality tier","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: account quality tier.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":22,"name":"account_hit_rate","displayName":"account hit rate","clickhouseType":"Nullable(Float32)","jsonType":"number","nullable":true,"description":"Source-normalized field: account hit rate.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":23,"name":"text","displayName":"text","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: text.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"internal body/object-path/raw-payload surface; retrieval requires a separate entitled endpoint"},{"position":24,"name":"cashtags","displayName":"cashtags","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: cashtags.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":25,"name":"favorite_count","displayName":"favorite count","clickhouseType":"Nullable(Int64)","jsonType":"integer","nullable":true,"description":"Count of favorite count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":26,"name":"retweet_count","displayName":"retweet count","clickhouseType":"Nullable(Int64)","jsonType":"integer","nullable":true,"description":"Count of retweet count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":27,"name":"reply_count","displayName":"reply count","clickhouseType":"Nullable(Int64)","jsonType":"integer","nullable":true,"description":"Count of reply count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":28,"name":"quote_count","displayName":"quote count","clickhouseType":"Nullable(Int64)","jsonType":"integer","nullable":true,"description":"Count of quote count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":29,"name":"view_count","displayName":"view count","clickhouseType":"Nullable(Int64)","jsonType":"integer","nullable":true,"description":"Count of view count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":30,"name":"language","displayName":"language","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: language.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":31,"name":"source","displayName":"source","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["filter","provenance"],"filterNames":["source"],"returned":true},{"position":32,"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":33,"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":34,"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":35,"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":36,"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":37,"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":38,"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":39,"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":40,"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":41,"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":42,"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":43,"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":44,"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":["time"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"社交媒体标的提及","summaryCn":"这是公告、新闻与可交易事件中的“社交媒体标的提及”数据集；一行由 platform、instrument_id、tweet_ts、post_id 定位，主要字段包括 symbol、market、handle、author_name、author_id。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“社交媒体标的提及”的一条记录；逻辑粒度由 platform × instrument_id × tweet_ts × post_id 共同确定。","timeSemanticsCn":"以 updated_at 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"platform","meaningCn":"用于确定该表业务粒度或默认顺序的 platform 字段。"},{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"tweet_ts","meaningCn":"tweet ts 对应的时间戳；除表内特别说明外按 UTC 解释。"},{"name":"post_id","meaningCn":"用于识别 post 的业务标识。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["字典采样时该关系可能为空；先查询 catalog 或小范围 rows 判断当前是否已有数据。"],"supportedMarkets":[],"coverage":{"measured":true,"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":43,"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":"event.source_document","namespace":"event","name":"source_document","coverageTags":["news_events"],"description":"Parsed source documents behind filings, PR, government, macro, news, and social events.","relation":"event.source_document","objectKind":"table","rowMagnitude":"1M-9M","grain":"doc_id × published_ts","cadence":"event","timeColumn":"published_ts","defaultOrder":["published_ts","source","doc_id"],"filters":[{"name":"doc_id","column":"doc_id","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"document_type","column":"document_type","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"language","column":"language","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"provider_doc_type","column":"provider_doc_type","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":35,"fields":[{"position":1,"name":"doc_id","displayName":"doc id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for doc.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["doc_id"],"returned":true},{"position":2,"name":"published_ts","displayName":"published ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the source published the record.","descriptionSource":"standard_glossary","roles":["time","default_order","provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":3,"name":"document_type","displayName":"document type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: document type.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["document_type"],"returned":true},{"position":4,"name":"provider_doc_type","displayName":"provider doc type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: provider doc type.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["provider_doc_type"],"returned":true},{"position":5,"name":"title","displayName":"title","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Human-readable title supplied or normalized from the source.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"url","displayName":"url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Canonical URL attached to the record.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"body","displayName":"body","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: body.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"internal body/object-path/raw-payload surface; retrieval requires a separate entitled endpoint"},{"position":8,"name":"body_hash","displayName":"body hash","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: body hash.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"language","displayName":"language","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: language.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["language"],"returned":true},{"position":10,"name":"entities","displayName":"entities","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: entities.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"metadata","displayName":"metadata","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: metadata.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"source","displayName":"source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["filter","default_order","provenance"],"filterNames":["source"],"returned":true},{"position":13,"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":14,"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":15,"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":16,"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":17,"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":18,"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":19,"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":20,"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":21,"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":22,"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":23,"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":24,"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":25,"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},{"position":26,"name":"text_markdown_path","displayName":"text markdown path","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: text markdown path.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":27,"name":"text_markdown_sha256","displayName":"text markdown sha256","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: text markdown sha256.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":28,"name":"text_markdown_size","displayName":"text markdown size","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Source-normalized field: text markdown size.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":29,"name":"text_encoding","displayName":"text encoding","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: text encoding.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":30,"name":"source_layer","displayName":"source layer","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: source layer.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":31,"name":"source_dataset_version","displayName":"source dataset version","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: source dataset version.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":32,"name":"source_priority","displayName":"source priority","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: source priority.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":33,"name":"granularity","displayName":"granularity","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: granularity.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":34,"name":"amends_accession_no","displayName":"amends accession no","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: amends accession no.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":35,"name":"item_codes","displayName":"item codes","clickhouseType":"Array(String)","jsonType":"array","nullable":false,"description":"Source-normalized field: item codes.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true}],"pit":null,"titleCn":"事件原始文档","summaryCn":"统一保存申报、新闻稿、政府、宏观、新闻和社交事件背后的解析文档及来源信息。","useCasesCn":["从事件回溯原始文本","按来源检索证据文档","联接事件流与候选证据"],"grainCn":"每行代表“事件原始文档”的一条记录；逻辑粒度由 doc_id × published_ts 共同确定。","timeSemanticsCn":"以 published_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"doc_id","meaningCn":"标准化原始文档标识；可联接 event.source_document。"},{"name":"published_ts","meaningCn":"来源公开文档或事件的时间。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 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":34,"costGuard":{"tier":"small","identityFilters":[],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":["sec_prebuilt_teraflop_secedgar_smoke_v2","sec_prebuilt_teraflop_secedgar_v1"],"reasons":["source_not_cataloged"]}},{"object":"dataset_schema","asset":"event.source_document_with_ticker","namespace":"event","name":"source_document_with_ticker","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 带股票代码的事件原文.","relation":"event.v_source_document_with_ticker","objectKind":"view","rowMagnitude":"view","grain":"published_ts × doc_id","cadence":"producer_schedule","timeColumn":"published_ts","defaultOrder":["published_ts","doc_id"],"filters":[{"name":"cik","column":"cik","required":false,"multipleValues":true,"jsonType":"string","example":"0000320193"},{"name":"doc_id","column":"doc_id","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"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":"relation_default","contractVersion":null,"uniqueKey":["published_ts","doc_id"],"provenanceColumns":[],"fieldCount":31,"fields":[{"position":1,"name":"doc_id","displayName":"doc id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for doc.","descriptionSource":"name_derived","roles":["filter","default_order","contract_unique_key"],"filterNames":["doc_id"],"returned":true},{"position":2,"name":"published_ts","displayName":"published ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the source published the record.","descriptionSource":"standard_glossary","roles":["time","default_order","contract_unique_key","provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":3,"name":"document_type","displayName":"document type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: document type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":4,"name":"provider_doc_type","displayName":"provider doc type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: provider doc type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"title","displayName":"title","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Human-readable title supplied or normalized from the source.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"url","displayName":"url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Canonical URL attached to the record.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"body","displayName":"body","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: body.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"internal body/object-path/raw-payload surface; retrieval requires a separate entitled endpoint"},{"position":8,"name":"body_hash","displayName":"body hash","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: body hash.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"language","displayName":"language","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: language.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"entities","displayName":"entities","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: entities.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"metadata","displayName":"metadata","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: metadata.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"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":13,"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":14,"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":15,"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":16,"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":17,"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":18,"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":19,"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":20,"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":21,"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":22,"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":23,"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":24,"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":25,"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},{"position":26,"name":"cik","displayName":"cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC Central Index Key identifying the filer.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["cik"],"returned":true},{"position":27,"name":"mapped_ticker","displayName":"mapped ticker","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: mapped ticker.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":28,"name":"mapped_instrument_id","displayName":"mapped instrument id","clickhouseType":"Nullable(UInt64)","jsonType":"integer","nullable":true,"description":"Identifier for mapped instrument.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":29,"name":"ticker_mapping_status","displayName":"ticker mapping status","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: ticker mapping status.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":30,"name":"ticker_pit_status","displayName":"ticker pit status","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: ticker pit status.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":31,"name":"ticker_mapping_confidence","displayName":"ticker mapping confidence","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: ticker mapping confidence.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true}],"pit":null,"titleCn":"带股票代码的事件原文","summaryCn":"这是公告、新闻与可交易事件中的“带股票代码的事件原文”数据集；一行由 published_ts、doc_id 定位，主要字段包括 document_type、provider_doc_type、title、url、body。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“带股票代码的事件原文”的一条记录；逻辑粒度由 published_ts × doc_id 共同确定。","timeSemanticsCn":"以 published_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"published_ts","meaningCn":"来源公开文档或事件的时间。"},{"name":"doc_id","meaningCn":"标准化原始文档标识；可联接 event.source_document。"}],"joins":[{"dataset":"event.source_document","on":"doc_id","guidanceCn":"用文档标识回溯标准化原文和来源信息；先核对两表字段口径。"}],"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":30,"costGuard":{"tier":"small","identityFilters":["cik"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.stream","namespace":"event","name":"stream","coverageTags":["news_events"],"description":"Canonical event stream.","relation":"event.stream","objectKind":"table","rowMagnitude":"1M-9M","grain":"event_id × event_ts","cadence":"intraday","timeColumn":"event_ts","defaultOrder":["event_ts","source","event_id"],"filters":[{"name":"event_code","column":"event_code","required":false,"multipleValues":true,"jsonType":"string","example":"EVENT_CODE"},{"name":"regime","column":"regime","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":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":31,"fields":[{"position":1,"name":"event_id","displayName":"event id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Stable identifier of the normalized event.","descriptionSource":"standard_glossary","roles":["default_order","warehouse_primary_key"],"filterNames":[],"returned":true},{"position":2,"name":"event_ts","displayName":"event ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp of the normalized event.","descriptionSource":"standard_glossary","roles":["time","default_order","warehouse_primary_key"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":3,"name":"event_code","displayName":"event code","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: event code.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["event_code"],"returned":true},{"position":4,"name":"severity","displayName":"severity","clickhouseType":"Nullable(Int16)","jsonType":"integer","nullable":true,"description":"Source-normalized field: severity.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"severity_reason","displayName":"severity reason","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: severity reason.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"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","provenance"],"filterNames":["source"],"returned":true},{"position":7,"name":"title","displayName":"title","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Human-readable title supplied or normalized from the source.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"body","displayName":"body","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: body.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"internal body/object-path/raw-payload surface; retrieval requires a separate entitled endpoint"},{"position":9,"name":"summary","displayName":"summary","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: summary.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"url","displayName":"url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Canonical URL attached to the record.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"entities","displayName":"entities","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: entities.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"sentiment","displayName":"sentiment","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: sentiment.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"confidence","displayName":"confidence","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: confidence.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"surprise_score","displayName":"surprise score","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: surprise score.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"surprise_reason","displayName":"surprise reason","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: surprise reason.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"regime","displayName":"regime","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: regime.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["regime"],"returned":true},{"position":17,"name":"signals_inferred","displayName":"signals inferred","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: signals inferred.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":18,"name":"metadata","displayName":"metadata","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: metadata.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":19,"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":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":"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":23,"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":24,"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":25,"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":26,"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":27,"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":28,"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":29,"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":30,"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":31,"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":"将多来源事件标准化为统一 event_id、事件时间、来源、实体和分类，是跨来源事件查询的主入口。","useCasesCn":["按证券和时间查询统一事件","合并新闻申报与公司事件","构建事件驱动特征"],"grainCn":"每行代表“统一事件流”的一条记录；逻辑粒度由 event_id × event_ts 共同确定。","timeSemanticsCn":"以 event_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"交易时段内可多次更新；请检查时间列判断新鲜度。","keyFields":[{"name":"event_id","meaningCn":"统一事件标识；可联接 event.stream。"},{"name":"event_ts","meaningCn":"标准化事件发生或发布时间，默认按 UTC 解释。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"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":30,"costGuard":{"tier":"small","identityFilters":[],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.stream_quality_current","namespace":"event","name":"stream_quality_current","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 统一事件流质量增强视图.","relation":"event.v_stream_quality_current","objectKind":"view","rowMagnitude":"view","grain":"event_ts × event_id","cadence":"producer_schedule","timeColumn":"event_ts","defaultOrder":["event_ts","event_id"],"filters":[{"name":"event_code","column":"event_code","required":false,"multipleValues":true,"jsonType":"string","example":"EVENT_CODE"},{"name":"event_id","column":"event_id","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"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":"relation_default","contractVersion":null,"uniqueKey":["event_ts","event_id"],"provenanceColumns":[],"fieldCount":45,"fields":[{"position":1,"name":"event_id","displayName":"event id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Stable identifier of the normalized event.","descriptionSource":"standard_glossary","roles":["filter","default_order","contract_unique_key"],"filterNames":["event_id"],"returned":true},{"position":2,"name":"event_ts","displayName":"event ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp of the normalized event.","descriptionSource":"standard_glossary","roles":["time","default_order","contract_unique_key"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":3,"name":"event_code","displayName":"event code","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: event code.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["event_code"],"returned":true},{"position":4,"name":"severity","displayName":"severity","clickhouseType":"Nullable(Int16)","jsonType":"integer","nullable":true,"description":"Source-normalized field: severity.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"severity_reason","displayName":"severity reason","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: severity reason.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"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":7,"name":"title","displayName":"title","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Human-readable title supplied or normalized from the source.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"body","displayName":"body","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: body.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"internal body/object-path/raw-payload surface; retrieval requires a separate entitled endpoint"},{"position":9,"name":"summary","displayName":"summary","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: summary.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"url","displayName":"url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Canonical URL attached to the record.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"entities","displayName":"entities","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: entities.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"sentiment","displayName":"sentiment","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: sentiment.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"confidence","displayName":"confidence","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: confidence.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"surprise_score","displayName":"surprise score","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: surprise score.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"surprise_reason","displayName":"surprise reason","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: surprise reason.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"regime","displayName":"regime","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: regime.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"name":"signals_inferred","displayName":"signals inferred","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: signals inferred.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":18,"name":"metadata","displayName":"metadata","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: metadata.","descriptionSource":"name_derived","roles":[],"filterNames":[],"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":"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":23,"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":24,"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":25,"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":26,"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":27,"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":28,"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":29,"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":30,"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":31,"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},{"position":32,"name":"dedup_group_id","displayName":"dedup group id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for dedup group.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":33,"name":"dedup_rank","displayName":"dedup rank","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Source-normalized field: dedup rank.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":34,"name":"duplicate_count","displayName":"duplicate count","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Count of duplicate count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":35,"name":"is_canonical","displayName":"is canonical","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Whether canonical applies to the row.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":36,"name":"effective_severity","displayName":"effective severity","clickhouseType":"Nullable(Int16)","jsonType":"integer","nullable":true,"description":"Source-normalized field: effective severity.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":37,"name":"severity_source","displayName":"severity source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: severity source.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":38,"name":"severity_reason_effective","displayName":"severity reason effective","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: severity reason effective.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":39,"name":"linked_tickers_json","displayName":"linked tickers json","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: linked tickers json.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":40,"name":"linked_instrument_ids_json","displayName":"linked instrument ids json","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: linked instrument ids json.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":41,"name":"linked_ticker_count","displayName":"linked ticker count","clickhouseType":"UInt16","jsonType":"integer","nullable":false,"description":"Count of linked ticker count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":42,"name":"entity_link_status","displayName":"entity link status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: entity link status.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":43,"name":"quality_bucket","displayName":"quality bucket","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: quality bucket.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":44,"name":"quality_reason","displayName":"quality reason","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: quality reason.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":45,"name":"quality_observed_at","displayName":"quality observed at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for quality observed at.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"统一事件流质量增强视图","summaryCn":"这是公告、新闻与可交易事件中的“统一事件流质量增强视图”数据集；一行由 event_ts、event_id 定位，主要字段包括 event_code、severity、severity_reason、source、title。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“统一事件流质量增强视图”的一条记录；逻辑粒度由 event_ts × event_id 共同确定。","timeSemanticsCn":"以 event_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"event_ts","meaningCn":"标准化事件发生或发布时间，默认按 UTC 解释。"},{"name":"event_id","meaningCn":"统一事件标识；可联接 event.stream。"}],"joins":[{"dataset":"event.stream","on":"event_id","guidanceCn":"用 event_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":44,"costGuard":{"tier":"small","identityFilters":["event_id"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.stream_quality_enrichment","namespace":"event","name":"stream_quality_enrichment","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 事件质量与去重增强.","relation":"event.stream_quality_enrichment","objectKind":"table","rowMagnitude":"100K-999K","grain":"event_id × event_source × event_ts × dedup_group_id","cadence":"intraday","timeColumn":"event_ts","defaultOrder":["event_source","event_ts","event_id","dedup_group_id"],"filters":[{"name":"event_code","column":"event_code","required":false,"multipleValues":true,"jsonType":"string","example":"EVENT_CODE"},{"name":"event_id","column":"event_id","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"provider","column":"provider","required":false,"multipleValues":true,"jsonType":"string","example":"PROVIDER_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["event_source","event_ts","event_id","dedup_group_id"],"provenanceColumns":[],"fieldCount":35,"fields":[{"position":1,"name":"event_id","displayName":"event id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Stable identifier of the normalized event.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["event_id"],"returned":true},{"position":2,"name":"event_ts","displayName":"event ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp of the normalized event.","descriptionSource":"standard_glossary","roles":["time","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":3,"name":"event_source","displayName":"event source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: event source.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":4,"name":"event_code","displayName":"event code","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: event code.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["event_code"],"returned":true},{"position":5,"name":"title","displayName":"title","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Human-readable title supplied or normalized from the source.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"url","displayName":"url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Canonical URL attached to the record.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":7,"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":8,"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":9,"name":"dedup_key","displayName":"dedup key","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: dedup key.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"dedup_group_id","displayName":"dedup group id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for dedup group.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":11,"name":"dedup_rank","displayName":"dedup rank","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Source-normalized field: dedup rank.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"duplicate_count","displayName":"duplicate count","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Count of duplicate count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"is_canonical","displayName":"is canonical","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Whether canonical applies to the row.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"effective_severity","displayName":"effective severity","clickhouseType":"Nullable(Int16)","jsonType":"integer","nullable":true,"description":"Source-normalized field: effective severity.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"severity_source","displayName":"severity source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: severity source.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"severity_reason_effective","displayName":"severity reason effective","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: severity reason effective.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"name":"linked_tickers_json","displayName":"linked tickers json","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: linked tickers json.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":18,"name":"linked_instrument_ids_json","displayName":"linked instrument ids json","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: linked instrument ids json.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":19,"name":"linked_ticker_count","displayName":"linked ticker count","clickhouseType":"UInt16","jsonType":"integer","nullable":false,"description":"Count of linked ticker count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":20,"name":"entity_link_status","displayName":"entity link status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: entity link status.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":21,"name":"quality_bucket","displayName":"quality bucket","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: quality bucket.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":22,"name":"quality_reason","displayName":"quality reason","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: quality reason.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":23,"name":"observed_at","displayName":"observed at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for observed at.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":24,"name":"enrichment_source","displayName":"enrichment source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: enrichment source.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":25,"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":26,"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":27,"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":28,"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":29,"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":30,"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":31,"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":32,"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":33,"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":34,"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":35,"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":"这是公告、新闻与可交易事件中的“事件质量与去重增强”数据集；一行由 event_source、event_ts、event_id、dedup_group_id 定位，主要字段包括 event_code、title、url、source_url、source_record_id。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“事件质量与去重增强”的一条记录；逻辑粒度由 event_id × event_source × event_ts × dedup_group_id 共同确定。","timeSemanticsCn":"以 event_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"交易时段内可多次更新；请检查时间列判断新鲜度。","keyFields":[{"name":"event_id","meaningCn":"统一事件标识；可联接 event.stream。"},{"name":"event_source","meaningCn":"用于确定该表业务粒度或默认顺序的 event source 字段。"},{"name":"event_ts","meaningCn":"标准化事件发生或发布时间，默认按 UTC 解释。"},{"name":"dedup_group_id","meaningCn":"用于识别 dedup group 的业务标识。"}],"joins":[{"dataset":"event.stream","on":"event_id","guidanceCn":"用 event_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":35,"costGuard":{"tier":"small","identityFilters":["event_id"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.taxonomy","namespace":"event","name":"taxonomy","coverageTags":["news_events"],"description":"Event taxonomy definitions.","relation":"event.taxonomy","objectKind":"table","rowMagnitude":"<1K","grain":"event_code × taxonomy_version","cadence":"static","timeColumn":null,"defaultOrder":["updated_at","event_code"],"filters":[{"name":"event_code","column":"event_code","required":false,"multipleValues":true,"jsonType":"string","example":"EVENT_CODE"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"},{"name":"taxonomy_version","column":"taxonomy_version","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":false,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":19,"fields":[{"position":1,"name":"event_code","displayName":"event code","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: event code.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["event_code"],"returned":true},{"position":2,"name":"taxonomy_version","displayName":"taxonomy version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: taxonomy version.","descriptionSource":"name_derived","roles":["filter","warehouse_primary_key"],"filterNames":["taxonomy_version"],"returned":true},{"position":3,"name":"parent_code","displayName":"parent code","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: parent code.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":4,"name":"name","displayName":"name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Canonical human-readable name.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"description","displayName":"description","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Human-readable description supplied or normalized from the source.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":6,"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":7,"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":8,"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":9,"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":10,"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":11,"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":12,"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":13,"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":14,"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":15,"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":16,"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":17,"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":18,"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":19,"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":["default_order"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"事件分类定义","summaryCn":"定义标准 event_code、分类层级、版本和语义，帮助程序一致解释事件流中的类型。","useCasesCn":["解释 event_code 含义","构建事件分类树","检查不同分类版本"],"grainCn":"每行代表“事件分类定义”的一条记录；逻辑粒度由 event_code × taxonomy_version 共同确定。","timeSemanticsCn":"该表没有单一主时间列；请使用业务日期或版本字段，并按关键字段确定范围。","cadenceCn":"参考主数据，只有定义或映射变化时才更新。","keyFields":[{"name":"event_code","meaningCn":"用于确定该表业务粒度或默认顺序的 event code 字段。"},{"name":"taxonomy_version","meaningCn":"用于确定该表业务粒度或默认顺序的 taxonomy version 字段。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 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":19,"costGuard":{"tier":"small","identityFilters":[],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.taxonomy_alias","namespace":"event","name":"taxonomy_alias","coverageTags":["news_events"],"description":"Event taxonomy aliases.","relation":"event.taxonomy_alias","objectKind":"table","rowMagnitude":"<1K","grain":"alias × event_code","cadence":"static","timeColumn":null,"defaultOrder":["updated_at","alias","event_code"],"filters":[{"name":"alias","column":"alias","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"event_code","column":"event_code","required":false,"multipleValues":true,"jsonType":"string","example":"EVENT_CODE"},{"name":"taxonomy_version","column":"taxonomy_version","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":false,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":17,"fields":[{"position":1,"name":"alias","displayName":"alias","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: alias.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["alias"],"returned":true},{"position":2,"name":"event_code","displayName":"event code","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: event code.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["event_code"],"returned":true},{"position":3,"name":"taxonomy_version","displayName":"taxonomy version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: taxonomy version.","descriptionSource":"name_derived","roles":["filter","warehouse_primary_key"],"filterNames":["taxonomy_version"],"returned":true},{"position":4,"name":"source","displayName":"source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":5,"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":6,"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":7,"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":8,"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":9,"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":10,"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":11,"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":12,"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":13,"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":14,"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":15,"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":16,"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":17,"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":["default_order"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"事件分类别名","summaryCn":"将来源术语或历史别名映射到标准 event_code，供跨来源归一化和查询扩展使用。","useCasesCn":["把来源标签映射为标准分类","扩展事件关键词检索","审计分类归一化规则"],"grainCn":"每行代表“事件分类别名”的一条记录；逻辑粒度由 alias × event_code 共同确定。","timeSemanticsCn":"该表没有单一主时间列；请使用业务日期或版本字段，并按关键字段确定范围。","cadenceCn":"参考主数据，只有定义或映射变化时才更新。","keyFields":[{"name":"alias","meaningCn":"用于确定该表业务粒度或默认顺序的 alias 字段。"},{"name":"event_code","meaningCn":"用于确定该表业务粒度或默认顺序的 event code 字段。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 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":17,"costGuard":{"tier":"small","identityFilters":[],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.ticker_lifecycle","namespace":"event","name":"ticker_lifecycle","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 股票代码生命周期事件.","relation":"event.ticker_lifecycle","objectKind":"table","rowMagnitude":"1K-9K","grain":"ticker_current × event_date × event_type × source","cadence":"event","timeColumn":"event_date","defaultOrder":["ticker_current","event_date","event_type","source"],"filters":[{"name":"cik","column":"cik","required":false,"multipleValues":true,"jsonType":"string","example":"0000320193"},{"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":["ticker_current","event_date","event_type","source"],"provenanceColumns":[],"fieldCount":25,"fields":[{"position":1,"name":"ticker_current","displayName":"ticker current","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: ticker current.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":2,"name":"ticker_event","displayName":"ticker event","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: ticker event.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":3,"name":"event_type","displayName":"event type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: event type.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":4,"name":"event_date","displayName":"event date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for event date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["time","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":5,"name":"name_at_event","displayName":"name at event","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: name at event.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"cik","displayName":"cik","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"SEC Central Index Key identifying the filer.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["cik"],"returned":true},{"position":7,"name":"composite_figi","displayName":"composite figi","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: composite figi.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"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":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":9,"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":10,"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":11,"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":12,"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":13,"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":14,"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":15,"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":16,"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":17,"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":18,"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":19,"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":20,"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":21,"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":22,"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":23,"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":24,"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":25,"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":"这是公告、新闻与可交易事件中的“股票代码生命周期事件”数据集；一行由 ticker_current、event_date、event_type、source 定位，主要字段包括 ticker_event、name_at_event、cik、composite_figi、publish_ts。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“股票代码生命周期事件”的一条记录；逻辑粒度由 ticker_current × event_date × event_type × source 共同确定。","timeSemanticsCn":"以 event_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"ticker_current","meaningCn":"用于确定该表业务粒度或默认顺序的 ticker current 字段。"},{"name":"event_date","meaningCn":"event date 对应的日历日期。"},{"name":"event_type","meaningCn":"用于确定该表业务粒度或默认顺序的 event type 字段。"},{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"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":25,"costGuard":{"tier":"small","identityFilters":["cik"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"event.transcript_feature","namespace":"event","name":"transcript_feature","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 业绩电话会文本特征.","relation":"event.transcript_feature","objectKind":"table","rowMagnitude":"10K-99K","grain":"instrument_id × fiscal_year × fiscal_quarter × extractor_version","cadence":"producer_schedule","timeColumn":"published_ts","defaultOrder":["instrument_id","fiscal_year","fiscal_quarter","extractor_version"],"filters":[{"name":"fiscal_quarter","column":"fiscal_quarter","required":false,"multipleValues":true,"jsonType":"integer","example":"FILTER_VALUE"},{"name":"fiscal_year","column":"fiscal_year","required":false,"multipleValues":true,"jsonType":"integer","example":"FILTER_VALUE"},{"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","fiscal_year","fiscal_quarter","extractor_version"],"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":"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":"fiscal_year","displayName":"fiscal year","clickhouseType":"UInt16","jsonType":"integer","nullable":false,"description":"Source-normalized field: fiscal year.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["fiscal_year"],"returned":true},{"position":4,"name":"fiscal_quarter","displayName":"fiscal quarter","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: fiscal quarter.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["fiscal_quarter"],"returned":true},{"position":5,"name":"transcript_date","displayName":"transcript date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for transcript date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":6,"name":"published_ts","displayName":"published ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the source published the record.","descriptionSource":"standard_glossary","roles":["time","provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":7,"name":"feature_available_ts","displayName":"feature available ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for feature available ts.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":8,"name":"qa_cosine_sim","displayName":"qa cosine sim","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: qa cosine sim.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"n_qa_pairs","displayName":"n qa pairs","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Count of qa pairs.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"yoy_remarks_cosine","displayName":"yoy remarks cosine","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: yoy remarks cosine.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"prior_call_fiscal_year","displayName":"prior call fiscal year","clickhouseType":"Nullable(UInt16)","jsonType":"integer","nullable":true,"description":"Source-normalized field: prior call fiscal year.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"prior_call_fiscal_quarter","displayName":"prior call fiscal quarter","clickhouseType":"Nullable(UInt8)","jsonType":"integer","nullable":true,"description":"Source-normalized field: prior call fiscal quarter.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"lm_tone_net","displayName":"lm tone net","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: lm tone net.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"lm_tone_qa","displayName":"lm tone qa","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: lm tone qa.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"lm_tone_prepared","displayName":"lm tone prepared","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: lm tone prepared.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"lm_pos_count","displayName":"lm pos count","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Count of lm pos count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"name":"lm_neg_count","displayName":"lm neg count","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Count of lm neg count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":18,"name":"lm_uncertainty_count","displayName":"lm uncertainty count","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Count of lm uncertainty count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":19,"name":"lm_litigious_count","displayName":"lm litigious count","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Count of lm litigious count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":20,"name":"n_prepared_turns","displayName":"n prepared turns","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Count of prepared turns.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":21,"name":"n_qa_turns","displayName":"n qa turns","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Count of qa turns.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":22,"name":"token_count","displayName":"token count","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Count of token count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":23,"name":"extractor_version","displayName":"extractor version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: extractor version.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"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","provenance"],"filterNames":["source"],"returned":true},{"position":25,"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":26,"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":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、fiscal_year、fiscal_quarter、extractor_version 定位，主要字段包括 symbol、transcript_date、published_ts、feature_available_ts、qa_cosine_sim。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“业绩电话会文本特征”的一条记录；逻辑粒度由 instrument_id × fiscal_year × fiscal_quarter × extractor_version 共同确定。","timeSemanticsCn":"以 published_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"fiscal_year","meaningCn":"用于确定该表业务粒度或默认顺序的 fiscal year 字段。"},{"name":"fiscal_quarter","meaningCn":"用于确定该表业务粒度或默认顺序的 fiscal quarter 字段。"},{"name":"extractor_version","meaningCn":"用于确定该表业务粒度或默认顺序的 extractor version 字段。"}],"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":31,"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":"event.transcript_llm_feature","namespace":"event","name":"transcript_llm_feature","coverageTags":["news_events"],"description":"Canonical Friends financial dataset: 业绩电话会 LLM 特征.","relation":"event.transcript_llm_feature","objectKind":"table","rowMagnitude":"10K-99K","grain":"instrument_id × fiscal_year × fiscal_quarter × model_id × prompt_version × extractor_version","cadence":"producer_schedule","timeColumn":"published_ts","defaultOrder":["instrument_id","fiscal_year","fiscal_quarter","model_id","prompt_version","extractor_version"],"filters":[{"name":"fiscal_quarter","column":"fiscal_quarter","required":false,"multipleValues":true,"jsonType":"integer","example":"FILTER_VALUE"},{"name":"fiscal_year","column":"fiscal_year","required":false,"multipleValues":true,"jsonType":"integer","example":"FILTER_VALUE"},{"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","fiscal_year","fiscal_quarter","model_id","prompt_version","extractor_version"],"provenanceColumns":[],"fieldCount":29,"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":"fiscal_year","displayName":"fiscal year","clickhouseType":"UInt16","jsonType":"integer","nullable":false,"description":"Source-normalized field: fiscal year.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["fiscal_year"],"returned":true},{"position":4,"name":"fiscal_quarter","displayName":"fiscal quarter","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: fiscal quarter.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["fiscal_quarter"],"returned":true},{"position":5,"name":"transcript_date","displayName":"transcript date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for transcript date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":6,"name":"published_ts","displayName":"published ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the source published the record.","descriptionSource":"standard_glossary","roles":["time","provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":7,"name":"feature_available_ts","displayName":"feature available ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for feature available ts.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":8,"name":"qa_nonanswer_rate","displayName":"qa nonanswer rate","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: qa nonanswer rate.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"n_questions","displayName":"n questions","clickhouseType":"UInt16","jsonType":"integer","nullable":false,"description":"Count of questions.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"analyst_tone","displayName":"analyst tone","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: analyst tone.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"mgr_tone","displayName":"mgr tone","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: mgr tone.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"mgr_analyst_tone_divergence","displayName":"mgr analyst tone divergence","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: mgr analyst tone divergence.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"guidance_direction","displayName":"guidance direction","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: guidance direction.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"guidance_specificity","displayName":"guidance specificity","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: guidance specificity.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"n_quant_fls","displayName":"n quant fls","clickhouseType":"Nullable(UInt16)","jsonType":"integer","nullable":true,"description":"Count of quant fls.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"confidence","displayName":"confidence","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: confidence.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"name":"status","displayName":"status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: status.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":18,"name":"model_id","displayName":"model id","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Identifier for model.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":19,"name":"prompt_version","displayName":"prompt version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: prompt version.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":20,"name":"extractor_version","displayName":"extractor version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: extractor version.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":21,"name":"raw_json","displayName":"raw json","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: raw json.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"internal body/object-path/raw-payload surface; retrieval requires a separate entitled endpoint"},{"position":22,"name":"est_cost_usd","displayName":"est cost usd","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"US-dollar value for est cost usd.","descriptionSource":"name_derived","roles":[],"filterNames":[],"unit":"USD","returned":true},{"position":23,"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":24,"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":25,"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":26,"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":27,"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":28,"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":29,"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":"业绩电话会 LLM 特征","summaryCn":"这是公告、新闻与可交易事件中的“业绩电话会 LLM 特征”数据集；一行由 instrument_id、fiscal_year、fiscal_quarter、model_id 定位，主要字段包括 symbol、transcript_date、published_ts、feature_available_ts、qa_nonanswer_rate。","useCasesCn":["按标的和时间检索事件或原文","与行情联接研究事件前后反应"],"grainCn":"每行代表“业绩电话会 LLM 特征”的一条记录；逻辑粒度由 instrument_id × fiscal_year × fiscal_quarter × model_id × prompt_version × extractor_version 共同确定。","timeSemanticsCn":"以 published_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"fiscal_year","meaningCn":"用于确定该表业务粒度或默认顺序的 fiscal year 字段。"},{"name":"fiscal_quarter","meaningCn":"用于确定该表业务粒度或默认顺序的 fiscal quarter 字段。"},{"name":"model_id","meaningCn":"用于识别 model 的业务标识。"},{"name":"prompt_version","meaningCn":"用于确定该表业务粒度或默认顺序的 prompt version 字段。"},{"name":"extractor_version","meaningCn":"用于确定该表业务粒度或默认顺序的 extractor version 字段。"}],"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":28,"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":"event.unlock_schedule","namespace":"event","name":"unlock_schedule","coverageTags":["news_events"],"description":"Share unlock schedule events.","relation":"event.unlock_schedule","objectKind":"table","rowMagnitude":"100K-999K","grain":"unlock_date × code × market","cadence":"event","timeColumn":"unlock_date","defaultOrder":["unlock_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","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":20,"fields":[{"position":1,"name":"unlock_date","displayName":"unlock date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for unlock 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":"holder_name","displayName":"holder name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: holder name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"unlock_shares","displayName":"unlock shares","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Quantity for unlock shares.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"unlock_ratio","displayName":"unlock ratio","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Ratio value for unlock ratio.","descriptionSource":"name_derived","roles":[],"filterNames":[],"unit":"ratio","returned":true},{"position":7,"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":8,"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":9,"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":10,"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":11,"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":12,"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":13,"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":14,"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":15,"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":16,"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":17,"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":18,"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":19,"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":20,"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":"每行代表“限售股解禁日程”的一条记录；逻辑粒度由 unlock_date × code × market 共同确定。","timeSemanticsCn":"以 unlock_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"unlock_date","meaningCn":"unlock 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":["CN","US"],"coverage":{"measured":true,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{"CN":{"latestBusinessDate":"2027-02-22","rows":296361},"US":{"latestBusinessDate":"2027-03-07","rows":1698}},"latestBusinessDate":"2027-03-07","note":"Recent observed coverage, not a lifetime guarantee. An unmeasured dataset carries no support claim in either direction."},"identifier":{"namespace":"mixed","formatByMarket":{"CN":"NNNNNN.SH or NNNNNN.SZ","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":20,"costGuard":{"tier":"medium","identityFilters":["code"],"maxWindowDays":400,"requirement":"identity filter or bounded window","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}}]}