{"$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":"social","description":"社交关注度和讨论热度快照。","datasetCount":5,"fieldCount":88,"datasets":[{"object":"dataset_schema","asset":"social.attention_snapshot","namespace":"social","name":"attention_snapshot","coverageTags":["social"],"description":"Bucketed social attention and sentiment by platform/entity/symbol.","relation":"social.attention_snapshot","objectKind":"table","rowMagnitude":"0","grain":"platform × entity_id × symbol × bucket_ts","cadence":"intraday","timeColumn":"bucket_ts","defaultOrder":["bucket_ts","platform","entity_id","symbol"],"filters":[{"name":"entity_id","column":"entity_id","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"market","column":"market","required":false,"multipleValues":true,"jsonType":"string","example":"US"},{"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":"symbol","column":"symbol","required":false,"multipleValues":true,"jsonType":"string","example":"AAPL"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":false,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":29,"fields":[{"position":1,"name":"bucket_ts","displayName":"bucket ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for bucket ts.","descriptionSource":"name_derived","roles":["time","default_order","warehouse_primary_key"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":2,"name":"bucket_minutes","displayName":"bucket minutes","clickhouseType":"UInt16","jsonType":"integer","nullable":false,"description":"Source-normalized field: bucket minutes.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":3,"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":4,"name":"entity_id","displayName":"entity id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for entity.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["entity_id"],"returned":true},{"position":5,"name":"symbol","displayName":"symbol","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Display or trading symbol for the instrument.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["symbol"],"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","warehouse_primary_key"],"filterNames":["market"],"returned":true},{"position":7,"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":8,"name":"post_count","displayName":"post count","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Count of post count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"unique_authors","displayName":"unique authors","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Source-normalized field: unique authors.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"engagement_score","displayName":"engagement score","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: engagement score.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"sentiment","displayName":"sentiment","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: sentiment.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"bullish_count","displayName":"bullish count","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Count of bullish count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"bearish_count","displayName":"bearish count","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Count of bearish count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"top_terms","displayName":"top terms","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: top terms.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"sample_refs","displayName":"sample refs","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: sample refs.","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":"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":"社交关注与情绪快照","summaryCn":"按平台、实体、证券和时间桶聚合讨论量与情绪，展示跨平台社交关注的短周期变化。","useCasesCn":["发现讨论量突然放大","比较平台情绪差异","联接价格研究社交冲击"],"grainCn":"每行代表“社交关注与情绪快照”的一条记录；逻辑粒度由 platform × entity_id × symbol × bucket_ts 共同确定。","timeSemanticsCn":"以 bucket_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"交易时段内可多次更新；请检查时间列判断新鲜度。","keyFields":[{"name":"platform","meaningCn":"用于确定该表业务粒度或默认顺序的 platform 字段。"},{"name":"entity_id","meaningCn":"用于识别 entity 的业务标识。"},{"name":"symbol","meaningCn":"证券或交易对的展示代码。"},{"name":"bucket_ts","meaningCn":"聚合时间桶的起始或代表时点。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 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":29,"costGuard":{"tier":"small","identityFilters":["symbol"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"social.stocktwits_sentiment_daily","namespace":"social","name":"stocktwits_sentiment_daily","coverageTags":["social"],"description":"Canonical Friends financial dataset: StockTwits 每日情绪.","relation":"social.stocktwits_sentiment_daily","objectKind":"table","rowMagnitude":"1K-9K","grain":"instrument_id × snapshot_date","cadence":"producer_schedule","timeColumn":"snapshot_date","defaultOrder":["instrument_id","snapshot_date"],"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":"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":["instrument_id","snapshot_date"],"provenanceColumns":[],"fieldCount":21,"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":"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":4,"name":"messages","displayName":"messages","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Source-normalized field: messages.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"bullish","displayName":"bullish","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Source-normalized field: bullish.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"bearish","displayName":"bearish","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Source-normalized field: bearish.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"sentiment","displayName":"sentiment","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"Source-normalized field: sentiment.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"truncated","displayName":"truncated","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: truncated.","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","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":"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":"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":13,"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":14,"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":15,"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":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":"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}],"pit":null,"titleCn":"StockTwits 每日情绪","summaryCn":"这是社交热度与情绪中的“StockTwits 每日情绪”数据集；一行由 instrument_id、snapshot_date 定位，主要字段包括 code、messages、bullish、bearish、sentiment。","useCasesCn":["跟踪社交讨论热度和方向","构建舆情变化与价格联动指标"],"grainCn":"每行代表“StockTwits 每日情绪”的一条记录；逻辑粒度由 instrument_id × snapshot_date 共同确定。","timeSemanticsCn":"以 snapshot_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"snapshot_date","meaningCn":"snapshot date 对应的日历日期。"}],"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":21,"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":"social.wsb_mentions_arcticshift","namespace":"social","name":"wsb_mentions_arcticshift","coverageTags":["social"],"description":"Canonical Friends financial dataset: WSB 提及与方向情绪.","relation":"social.wsb_mentions_arcticshift","objectKind":"table","rowMagnitude":"10K-99K","grain":"instrument_id × mention_date","cadence":"producer_schedule","timeColumn":"snapshot_date","defaultOrder":["instrument_id","mention_date"],"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":"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":["instrument_id","mention_date"],"provenanceColumns":[],"fieldCount":15,"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":"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"],"filterNames":["snapshot_date"],"jsonFormat":"date","unit":"date","returned":true},{"position":4,"name":"mention_date","displayName":"mention date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for mention 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":"mentions","displayName":"mentions","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Source-normalized field: mentions.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"rank","displayName":"rank","clickhouseType":"Int32","jsonType":"integer","nullable":false,"description":"One-based or source-defined rank within the row's cohort.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"sentiment","displayName":"sentiment","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: sentiment.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"subreddit","displayName":"subreddit","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: subreddit.","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","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":"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":"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":13,"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":14,"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":15,"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}],"pit":null,"titleCn":"WSB 提及与方向情绪","summaryCn":"这是社交热度与情绪中的“WSB 提及与方向情绪”数据集；一行由 instrument_id、mention_date 定位，主要字段包括 code、snapshot_date、mentions、rank、sentiment。","useCasesCn":["跟踪社交讨论热度和方向","构建舆情变化与价格联动指标"],"grainCn":"每行代表“WSB 提及与方向情绪”的一条记录；逻辑粒度由 instrument_id × mention_date 共同确定。","timeSemanticsCn":"以 snapshot_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"mention_date","meaningCn":"mention date 对应的日历日期。"}],"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":15,"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":"social.wsb_mentions_hist","namespace":"social","name":"wsb_mentions_hist","coverageTags":["social"],"description":"Canonical Friends financial dataset: WSB 历史提及与情绪.","relation":"social.wsb_mentions_hist","objectKind":"table","rowMagnitude":"100K-999K","grain":"instrument_id × mention_date","cadence":"producer_schedule","timeColumn":"snapshot_date","defaultOrder":["instrument_id","mention_date"],"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":"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":["instrument_id","mention_date"],"provenanceColumns":[],"fieldCount":11,"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":"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"],"filterNames":["snapshot_date"],"jsonFormat":"date","unit":"date","returned":true},{"position":4,"name":"mention_date","displayName":"mention date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for mention 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":"mentions","displayName":"mentions","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Source-normalized field: mentions.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"rank","displayName":"rank","clickhouseType":"Int32","jsonType":"integer","nullable":false,"description":"One-based or source-defined rank within the row's cohort.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"sentiment","displayName":"sentiment","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"Source-normalized field: sentiment.","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":"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":"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":11,"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":"WSB 历史提及与情绪","summaryCn":"这是社交热度与情绪中的“WSB 历史提及与情绪”数据集；一行由 instrument_id、mention_date 定位，主要字段包括 code、snapshot_date、mentions、rank、sentiment。","useCasesCn":["跟踪社交讨论热度和方向","构建舆情变化与价格联动指标"],"grainCn":"每行代表“WSB 历史提及与情绪”的一条记录；逻辑粒度由 instrument_id × mention_date 共同确定。","timeSemanticsCn":"以 snapshot_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"mention_date","meaningCn":"mention date 对应的日历日期。"}],"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":11,"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":"social.wsb_mentions_live","namespace":"social","name":"wsb_mentions_live","coverageTags":["social"],"description":"WallStreetBets live mention counts + sentiment (Quiver).","relation":"social.wsb_mentions_live","objectKind":"table","rowMagnitude":"10K-99K","grain":"snapshot_date × instrument_id","cadence":"producer_schedule","timeColumn":"snapshot_date","defaultOrder":["snapshot_date","instrument_id"],"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}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":12,"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":"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":"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":4,"name":"mentions","displayName":"mentions","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Source-normalized field: mentions.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"sentiment","displayName":"sentiment","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"Source-normalized field: sentiment.","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":["provenance"],"filterNames":[],"returned":true},{"position":7,"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":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":"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":"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":12,"name":"provider","displayName":"provider","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Upstream data provider identifier.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true}],"pit":null,"titleCn":"WallStreetBets 实时提及","summaryCn":"记录 Quiver 提供的 WSB 股票提及次数和情绪，用于观察散户社区关注度与拥挤。","useCasesCn":["筛选 WSB 热门股票","跟踪提及和情绪变化","识别社交拥挤风险"],"grainCn":"每行代表“WallStreetBets 实时提及”的一条记录；逻辑粒度由 snapshot_date × instrument_id 共同确定。","timeSemanticsCn":"以 snapshot_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"snapshot_date","meaningCn":"snapshot date 对应的日历日期。"},{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"}],"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":12,"costGuard":{"tier":"small","identityFilters":["code","instrument_id"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}}]}