{"$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":"ref","description":"标的、交易日历与跨来源映射等参考主数据。","datasetCount":47,"fieldCount":1103,"datasets":[{"object":"dataset_schema","asset":"ref.calendar","namespace":"ref","name":"calendar","coverageTags":["reference"],"description":"Trading calendars by market.","relation":"ref.calendar","objectKind":"table","rowMagnitude":"1K-9K","grain":"market × trade_date","cadence":"static","timeColumn":"trade_date","defaultOrder":["trade_date","market"],"filters":[{"name":"market","column":"market","required":false,"multipleValues":true,"jsonType":"string","example":"CN","exampleSource":"observed_coverage","allowedValues":["CN"]}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":false,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":16,"fields":[{"position":1,"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":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","default_order","warehouse_primary_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":3,"name":"is_trading_day","displayName":"is trading day","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Whether trading day applies to the row.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":4,"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":5,"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":6,"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":7,"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":8,"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":9,"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":10,"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":11,"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":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":"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":16,"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":"定义各市场日期是否开市及相关会话信息，是按交易日对齐、补齐和计算 T+N 的基础表。","useCasesCn":["判断某日是否交易日","生成市场交易日序列","将日历日转换为下一个交易日"],"grainCn":"每行代表“交易日历”的一条记录；逻辑粒度由 market × trade_date 共同确定。","timeSemanticsCn":"以 trade_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"参考主数据，只有定义或映射变化时才更新。","keyFields":[{"name":"market","meaningCn":"规范市场代码。"},{"name":"trade_date","meaningCn":"对应市场日历中的交易日。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 cursor，结果过大时必须缩小标的、日期或其他筛选。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":["CN"],"coverage":{"measured":true,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{"CN":{"latestBusinessDate":"2026-12-31","rows":156}},"latestBusinessDate":"2026-12-31","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":16,"costGuard":{"tier":"small","identityFilters":[],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"ref.cn_concept_index","namespace":"ref","name":"cn_concept_index","coverageTags":["a_share","reference"],"description":"Canonical Friends financial dataset: A 股概念板块主表.","relation":"ref.cn_concept_index","objectKind":"table","rowMagnitude":"1K-9K","grain":"concept_code × source","cadence":"producer_schedule","timeColumn":"ingested_at","defaultOrder":["concept_code","source"],"filters":[{"name":"exchange","column":"exchange","required":false,"multipleValues":true,"jsonType":"string","example":"NASDAQ"},{"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"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["concept_code","source"],"provenanceColumns":[],"fieldCount":20,"fields":[{"position":1,"name":"concept_code","displayName":"concept code","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: concept code.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":2,"name":"name","displayName":"name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Canonical human-readable name.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":3,"name":"exchange","displayName":"exchange","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Listing or trading exchange.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["exchange"],"returned":true},{"position":4,"name":"list_date","displayName":"list date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for list date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":5,"name":"member_count","displayName":"member count","clickhouseType":"Nullable(Int32)","jsonType":"integer","nullable":true,"description":"Count of member count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"concept_type","displayName":"concept type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: concept type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"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":8,"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":9,"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":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},{"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":["time","provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","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}],"pit":null,"titleCn":"A 股概念板块主表","summaryCn":"定义 A 股概念板块代码、名称、交易所、上市日期和成分数量；一行由 concept_code、source 定位，主要字段包括 name、exchange、list_date、member_count、concept_type。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“A 股概念板块主表”的一条记录；逻辑粒度由 concept_code × source 共同确定。","timeSemanticsCn":"以 ingested_at 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"concept_code","meaningCn":"用于确定该表业务粒度或默认顺序的 concept code 字段。"},{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"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-24","rows":3332}},"latestBusinessDate":"2026-08-24","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":20,"costGuard":{"tier":"small","identityFilters":[],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"ref.cn_concept_member","namespace":"ref","name":"cn_concept_member","coverageTags":["a_share","reference"],"description":"Canonical Friends financial dataset: A 股概念板块成分股.","relation":"ref.cn_concept_member","objectKind":"table","rowMagnitude":"1M-9M","grain":"snapshot_month × concept_code × con_code × source","cadence":"producer_schedule","timeColumn":"ingested_at","defaultOrder":["snapshot_month","concept_code","con_code","source"],"filters":[{"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"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["snapshot_month","concept_code","con_code","source"],"provenanceColumns":[],"fieldCount":18,"fields":[{"position":1,"name":"snapshot_month","displayName":"snapshot month","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Source-normalized field: snapshot month.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","returned":true},{"position":2,"name":"concept_code","displayName":"concept code","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: concept code.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":3,"name":"con_code","displayName":"con code","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: con code.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":4,"name":"con_name","displayName":"con name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: con name.","descriptionSource":"name_derived","roles":[],"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":["time","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 股概念板块在月度快照中的成分证券，用于把个股映射到主题板块；一行由 snapshot_month、concept_code、con_code、source 定位，主要字段包括 con_name、market、ingested_at、provider、source_url。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“A 股概念板块成分股”的一条记录；逻辑粒度由 snapshot_month × concept_code × con_code × source 共同确定。","timeSemanticsCn":"以 ingested_at 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"snapshot_month","meaningCn":"用于确定该表业务粒度或默认顺序的 snapshot month 字段。"},{"name":"concept_code","meaningCn":"用于确定该表业务粒度或默认顺序的 concept code 字段。"},{"name":"con_code","meaningCn":"用于确定该表业务粒度或默认顺序的 con code 字段。"},{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"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-24","rows":1119506}},"latestBusinessDate":"2026-08-24","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":[],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"ref.code_mapping","namespace":"ref","name":"code_mapping","coverageTags":["reference"],"description":"Cross-provider code mappings.","relation":"ref.code_mapping","objectKind":"table","rowMagnitude":"1K-9K","grain":"source × code × target_system","cadence":"static","timeColumn":null,"defaultOrder":["updated_at","source","code"],"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":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"},{"name":"target_system","column":"target_system","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":"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":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","warehouse_primary_key"],"filterNames":["market"],"returned":true},{"position":4,"name":"target_system","displayName":"target system","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: target system.","descriptionSource":"name_derived","roles":["filter","warehouse_primary_key"],"filterNames":["target_system"],"returned":true},{"position":5,"name":"target_code","displayName":"target code","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: target code.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"name","displayName":"name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Canonical human-readable name.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"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":"将来源代码映射到目标系统标识，解决同一证券或合约在不同供应商中的命名差异。","useCasesCn":["把供应商 ticker 映射到规范标识","调试跨源代码不一致","构建来源联接"],"grainCn":"每行代表“跨数据源代码映射”的一条记录；逻辑粒度由 source × code × target_system 共同确定。","timeSemanticsCn":"该表没有单一主时间列；请使用业务日期或版本字段，并按关键字段确定范围。","cadenceCn":"参考主数据，只有定义或映射变化时才更新。","keyFields":[{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"},{"name":"code","meaningCn":"来源规范化后的证券、合约或指标代码。"},{"name":"target_system","meaningCn":"用于确定该表业务粒度或默认顺序的 target system 字段。"}],"joins":[{"dataset":"ref.instrument","on":"code + market（先确认代码口径）","guidanceCn":"需要补证券主数据时可按代码和市场映射；不同来源代码可能不一致，优先先查 ref.code_mapping。"}],"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":["code"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"ref.corporate_action","namespace":"ref","name":"corporate_action","coverageTags":["reference"],"description":"Corporate actions keyed by instrument and effective date.","relation":"ref.corporate_action","objectKind":"table","rowMagnitude":"1K-9K","grain":"instrument_id × effective_date × action_type","cadence":"daily","timeColumn":"effective_date","defaultOrder":["effective_date","instrument_id"],"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}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":false,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":19,"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":"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":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","warehouse_primary_key"],"filterNames":["action_type"],"returned":true},{"position":4,"name":"ratio_numerator","displayName":"ratio numerator","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Source-normalized field: ratio numerator.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"ratio_denominator","displayName":"ratio denominator","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Source-normalized field: ratio denominator.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"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":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":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"规范公司行为","summaryCn":"按证券、生效日和行为类型统一拆股、分红等公司行为，为复权和事件研究提供标准输入。","useCasesCn":["查询证券公司行为时间线","解释价格跳变","生成复权处理输入"],"grainCn":"每行代表“规范公司行为”的一条记录；逻辑粒度由 instrument_id × effective_date × action_type 共同确定。","timeSemanticsCn":"以 effective_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"effective_date","meaningCn":"公司行为或映射开始生效的日期。"},{"name":"action_type","meaningCn":"用于确定该表业务粒度或默认顺序的 action type 字段。"}],"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":19,"costGuard":{"tier":"small","identityFilters":["instrument_id"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"ref.cusip_instrument_mapping","namespace":"ref","name":"cusip_instrument_mapping","coverageTags":["reference"],"description":"Canonical Friends financial dataset: CUSIP 与证券映射.","relation":"ref.cusip_instrument_mapping","objectKind":"table","rowMagnitude":"10K-99K","grain":"cusip × instrument_id","cadence":"static","timeColumn":"observed_at","defaultOrder":["cusip","mapping_status","ticker","market","figi","source"],"filters":[{"name":"exchange","column":"exchange","required":false,"multipleValues":true,"jsonType":"string","example":"NASDAQ"},{"name":"instrument_id","column":"instrument_id","required":false,"multipleValues":true,"jsonType":"integer","example":1},{"name":"market","column":"market","required":false,"multipleValues":true,"jsonType":"string","example":"","exampleSource":"observed_coverage","allowedValues":[""]},{"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":["cusip","mapping_status","ticker","market","figi","source"],"provenanceColumns":[],"fieldCount":33,"fields":[{"position":1,"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":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","contract_unique_key"],"filterNames":["ticker"],"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","contract_unique_key"],"filterNames":["market"],"returned":true},{"position":4,"name":"exchange","displayName":"exchange","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Listing or trading exchange.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["exchange"],"returned":true},{"position":5,"name":"figi","displayName":"figi","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: figi.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":6,"name":"composite_figi","displayName":"composite figi","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: composite figi.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"share_class_figi","displayName":"share class figi","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: share class figi.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"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":9,"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":10,"name":"market_sector","displayName":"market sector","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: market sector.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"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":12,"name":"mapping_status","displayName":"mapping status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: mapping status.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":13,"name":"confidence","displayName":"confidence","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"Source-normalized field: confidence.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"evidence_json","displayName":"evidence json","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: evidence json.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"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":16,"name":"latest_report_date","displayName":"latest report date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for latest report date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":17,"name":"holding_row_count","displayName":"holding row count","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Count of holding row count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":18,"name":"holding_value_usd_sum","displayName":"holding value usd sum","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: holding value usd sum.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":19,"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":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":"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":"CUSIP 与证券映射","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“CUSIP 与证券映射”数据集；一行由 cusip、mapping_status、ticker、market 定位，主要字段包括 exchange、figi、composite_figi、share_class_figi、security_name。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“CUSIP 与证券映射”的一条记录；逻辑粒度由 cusip × instrument_id 共同确定。","timeSemanticsCn":"以 observed_at 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"参考主数据，只有定义或映射变化时才更新。","keyFields":[{"name":"cusip","meaningCn":"用于确定该表业务粒度或默认顺序的 cusip 字段。"},{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"mapping_status","meaningCn":"用于确定该表业务粒度或默认顺序的 mapping status 字段。"},{"name":"ticker","meaningCn":"来源或证券主表使用的股票代码。"},{"name":"market","meaningCn":"规范市场代码。"},{"name":"figi","meaningCn":"用于确定该表业务粒度或默认顺序的 figi 字段。"}],"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":"2026-08-26","rows":300}},"latestBusinessDate":"2026-08-26","note":"Recent observed coverage, not a lifetime guarantee. An unmeasured dataset carries no support claim in either direction."},"identifier":{"namespace":"mixed","formatByMarket":{"":"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":33,"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":"ref.cusip_primary_instrument_mapping","namespace":"ref","name":"cusip_primary_instrument_mapping","coverageTags":["reference"],"description":"Canonical Friends financial dataset: CUSIP 主证券映射.","relation":"ref.v_cusip_primary_instrument_mapping","objectKind":"view","rowMagnitude":"view","grain":"cusip × ticker × market","cadence":"producer_schedule","timeColumn":null,"defaultOrder":["cusip","ticker","market"],"filters":[{"name":"exchange","column":"exchange","required":false,"multipleValues":true,"jsonType":"string","example":"NASDAQ"},{"name":"instrument_id","column":"instrument_id","required":false,"multipleValues":true,"jsonType":"integer","example":1},{"name":"market","column":"market","required":false,"multipleValues":true,"jsonType":"string","example":"US"},{"name":"ticker","column":"ticker","required":false,"multipleValues":true,"jsonType":"string","example":"AAPL"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"relation_default","contractVersion":null,"uniqueKey":["cusip","ticker","market"],"provenanceColumns":[],"fieldCount":15,"fields":[{"position":1,"name":"cusip","displayName":"cusip","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: cusip.","descriptionSource":"name_derived","roles":["default_order","contract_unique_key"],"filterNames":[],"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","contract_unique_key"],"filterNames":["ticker"],"returned":true},{"position":3,"name":"market","displayName":"market","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Canonical market or country-market code.","descriptionSource":"standard_glossary","roles":["filter","default_order","contract_unique_key"],"filterNames":["market"],"returned":true},{"position":4,"name":"exchange","displayName":"exchange","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Listing or trading exchange.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["exchange"],"returned":true},{"position":5,"name":"figi","displayName":"figi","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: figi.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"composite_figi","displayName":"composite figi","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: composite figi.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"share_class_figi","displayName":"share class figi","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: share class figi.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"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":9,"name":"security_type","displayName":"security type","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: security type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"market_sector","displayName":"market sector","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: market sector.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"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":12,"name":"mapping_status","displayName":"mapping status","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: mapping status.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"confidence","displayName":"confidence","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"Source-normalized field: confidence.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"evidence_json","displayName":"evidence json","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: evidence json.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"latest_observed_at","displayName":"latest observed at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for latest observed at.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"CUSIP 主证券映射","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“CUSIP 主证券映射”数据集；一行由 cusip、ticker、market 定位，主要字段包括 exchange、figi、composite_figi、share_class_figi、security_name。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“CUSIP 主证券映射”的一条记录；逻辑粒度由 cusip × ticker × market 共同确定。","timeSemanticsCn":"该表没有单一主时间列；请使用业务日期或版本字段，并按关键字段确定范围。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"cusip","meaningCn":"用于确定该表业务粒度或默认顺序的 cusip 字段。"},{"name":"ticker","meaningCn":"来源或证券主表使用的股票代码。"},{"name":"market","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":15,"costGuard":{"tier":"small","identityFilters":["instrument_id","ticker"],"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":"ref.delisted_us","namespace":"ref","name":"delisted_us","coverageTags":["reference"],"description":"Canonical Friends financial dataset: 美股退市证券主表.","relation":"ref.delisted_us","objectKind":"table","rowMagnitude":"0","grain":"instrument_id","cadence":"daily","timeColumn":"publish_ts","defaultOrder":["instrument_id","delist_date","source"],"filters":[{"name":"code","column":"code","required":false,"multipleValues":true,"jsonType":"string","example":"AAPL"},{"name":"exchange","column":"exchange","required":false,"multipleValues":true,"jsonType":"string","example":"NASDAQ"},{"name":"instrument_id","column":"instrument_id","required":false,"multipleValues":true,"jsonType":"integer","example":1},{"name":"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":["instrument_id","delist_date","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":"name","displayName":"name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Canonical human-readable name.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"list_date","displayName":"list date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for list date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":6,"name":"delist_date","displayName":"delist date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for delist date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":7,"name":"delist_reason","displayName":"delist reason","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: delist reason.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"final_close","displayName":"final close","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: final close.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"successor_instrument_id","displayName":"successor instrument id","clickhouseType":"Nullable(UInt64)","jsonType":"integer","nullable":true,"description":"Identifier for successor instrument.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"successor_symbol","displayName":"successor symbol","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: successor symbol.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"exchange","displayName":"exchange","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Listing or trading exchange.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["exchange"],"returned":true},{"position":12,"name":"sector","displayName":"sector","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: sector.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"industry","displayName":"industry","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: industry.","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":["time","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、delist_date、source 定位，主要字段包括 code、market、name、list_date、delist_reason。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“美股退市证券主表”的一条记录；逻辑粒度由 instrument_id 共同确定。","timeSemanticsCn":"以 publish_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"delist_date","meaningCn":"delist date 对应的日历日期。"},{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"}],"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":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":"ref.entity_alias","namespace":"ref","name":"entity_alias","coverageTags":["reference"],"description":"Cross-source entity aliases for companies, coins, projects, agencies, and tradable assets.","relation":"ref.entity_alias","objectKind":"table","rowMagnitude":"0","grain":"entity_id × alias","cadence":"static","timeColumn":null,"defaultOrder":["updated_at","entity_id","alias"],"filters":[{"name":"alias","column":"alias","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"cik","column":"cik","required":false,"multipleValues":true,"jsonType":"string","example":"0000320193"},{"name":"entity_id","column":"entity_id","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"entity_type","column":"entity_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":"symbol","column":"symbol","required":false,"multipleValues":true,"jsonType":"string","example":"AAPL"},{"name":"uei","column":"uei","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":false,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":29,"fields":[{"position":1,"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":2,"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":3,"name":"canonical_name","displayName":"canonical name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: canonical name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":4,"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":5,"name":"alias_type","displayName":"alias type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: alias type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"symbol","displayName":"symbol","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Display or trading symbol for the instrument.","descriptionSource":"standard_glossary","roles":["filter","warehouse_primary_key"],"filterNames":["symbol"],"returned":true},{"position":7,"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":8,"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":9,"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":10,"name":"lei","displayName":"lei","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: lei.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"uei","displayName":"uei","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: uei.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["uei"],"returned":true},{"position":12,"name":"contract_address","displayName":"contract address","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: contract address.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"chain","displayName":"chain","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: chain.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"confidence","displayName":"confidence","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: confidence.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"status","displayName":"status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: status.","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","warehouse_primary_key","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":["default_order"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"实体别名","summaryCn":"保存公司、币种、项目、机构和可交易资产的跨来源别名，帮助文本和事件正确归属实体。","useCasesCn":["把新闻中的别名归一到实体","扩展实体搜索词","审计别名映射"],"grainCn":"每行代表“实体别名”的一条记录；逻辑粒度由 entity_id × alias 共同确定。","timeSemanticsCn":"该表没有单一主时间列；请使用业务日期或版本字段，并按关键字段确定范围。","cadenceCn":"参考主数据，只有定义或映射变化时才更新。","keyFields":[{"name":"entity_id","meaningCn":"用于识别 entity 的业务标识。"},{"name":"alias","meaningCn":"用于确定该表业务粒度或默认顺序的 alias 字段。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 cursor，结果过大时必须缩小标的、日期或其他筛选。","caveatsCn":["字典采样时该关系可能为空；先查询 catalog 或小范围 rows 判断当前是否已有数据。"],"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":["cik","symbol"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"ref.eodhd_delisted_symbol_pit","namespace":"ref","name":"eodhd_delisted_symbol_pit","coverageTags":["reference"],"description":"Canonical Friends financial dataset: EODHD 退市代码历史快照.","relation":"ref.eodhd_delisted_symbol_pit","objectKind":"table","rowMagnitude":"1M-9M","grain":"instrument_id × exchange_code × symbol_raw × snapshot_date","cadence":"daily","timeColumn":"snapshot_ts","defaultOrder":["exchange_code","symbol_raw","snapshot_date"],"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":"snapshot_date","column":"snapshot_date","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["exchange_code","symbol_raw","snapshot_date"],"provenanceColumns":[],"fieldCount":16,"fields":[{"position":1,"name":"snapshot_ts","displayName":"snapshot ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for snapshot ts.","descriptionSource":"name_derived","roles":["time"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":2,"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":3,"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":4,"name":"symbol_raw","displayName":"symbol raw","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: symbol raw.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":5,"name":"exchange_code","displayName":"exchange code","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: exchange code.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":6,"name":"name","displayName":"name","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Canonical human-readable name.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"country","displayName":"country","clickhouseType":"LowCardinality(Nullable(String))","jsonType":"string","nullable":true,"description":"Source-normalized field: country.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"currency","displayName":"currency","clickhouseType":"LowCardinality(Nullable(String))","jsonType":"string","nullable":true,"description":"ISO-like currency code for monetary values.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"security_type","displayName":"security type","clickhouseType":"LowCardinality(Nullable(String))","jsonType":"string","nullable":true,"description":"Source-normalized field: security type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"delisted_date","displayName":"delisted date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for delisted date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":11,"name":"is_delisted","displayName":"is delisted","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Whether delisted applies to the row.","descriptionSource":"name_derived","roles":[],"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":["filter","provenance"],"filterNames":["provider"],"returned":true},{"position":13,"name":"parser_version","displayName":"parser version","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Version of the parser or normalizer that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":14,"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":15,"name":"version_ts","displayName":"version ts","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"UTC timestamp associated with the row version.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"unit":"UTC_datetime","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}],"pit":null,"titleCn":"EODHD 退市代码历史快照","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“EODHD 退市代码历史快照”数据集；一行由 exchange_code、symbol_raw、snapshot_date 定位，主要字段包括 snapshot_ts、instrument_id、name、country、currency。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“EODHD 退市代码历史快照”的一条记录；逻辑粒度由 instrument_id × exchange_code × symbol_raw × snapshot_date 共同确定。","timeSemanticsCn":"以 snapshot_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"exchange_code","meaningCn":"用于确定该表业务粒度或默认顺序的 exchange code 字段。"},{"name":"symbol_raw","meaningCn":"用于确定该表业务粒度或默认顺序的 symbol raw 字段。"},{"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":16,"costGuard":{"tier":"small","identityFilters":["instrument_id"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"DENIED","deniedSources":[],"reasons":["restricted_license_scope"]}},{"object":"dataset_schema","asset":"ref.eodhd_id_mapping","namespace":"ref","name":"eodhd_id_mapping","coverageTags":["reference"],"description":"Canonical Friends financial dataset: EODHD ID 映射.","relation":"ref.eodhd_id_mapping","objectKind":"table","rowMagnitude":"0","grain":"symbol × source","cadence":"daily","timeColumn":"updated_at","defaultOrder":["symbol","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":"symbol","column":"symbol","required":false,"multipleValues":true,"jsonType":"string","example":"AAPL"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["symbol","source"],"provenanceColumns":[],"fieldCount":20,"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","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["symbol"],"returned":true},{"position":2,"name":"isin","displayName":"isin","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: isin.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":3,"name":"figi","displayName":"figi","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: figi.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":4,"name":"lei","displayName":"lei","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: lei.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"cusip","displayName":"cusip","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: cusip.","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":"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":"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":"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":"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":"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":20,"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":["time"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"EODHD ID 映射","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“EODHD ID 映射”数据集；一行由 symbol、source 定位，主要字段包括 isin、figi、lei、cusip、cik。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“EODHD ID 映射”的一条记录；逻辑粒度由 symbol × source 共同确定。","timeSemanticsCn":"以 updated_at 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"symbol","meaningCn":"证券或交易对的展示代码。"},{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["字典采样时该关系可能为空；先查询 catalog 或小范围 rows 判断当前是否已有数据。"],"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":20,"costGuard":{"tier":"small","identityFilters":["cik","symbol"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"DENIED","deniedSources":[],"reasons":["restricted_license_scope"]}},{"object":"dataset_schema","asset":"ref.eodhd_id_mapping_pit","namespace":"ref","name":"eodhd_id_mapping_pit","coverageTags":["reference"],"description":"Canonical Friends financial dataset: EODHD ID 映射 时点.","relation":"ref.eodhd_id_mapping_pit","objectKind":"table","rowMagnitude":"100K-999K","grain":"instrument_id × snapshot_date","cadence":"daily","timeColumn":"snapshot_ts","defaultOrder":["instrument_id","snapshot_date"],"filters":[{"name":"cik","column":"cik","required":false,"multipleValues":true,"jsonType":"string","example":"0000320193"},{"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":28,"fields":[{"position":1,"name":"snapshot_ts","displayName":"snapshot ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for snapshot ts.","descriptionSource":"name_derived","roles":["time"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":2,"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":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_raw","displayName":"symbol raw","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: symbol raw.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"exchange_code","displayName":"exchange code","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: exchange code.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"isin","displayName":"isin","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: isin.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"figi","displayName":"figi","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: figi.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"cusip","displayName":"cusip","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: cusip.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"lei","displayName":"lei","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: lei.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"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":11,"name":"name","displayName":"name","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Canonical human-readable name.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"country","displayName":"country","clickhouseType":"LowCardinality(Nullable(String))","jsonType":"string","nullable":true,"description":"Source-normalized field: country.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"currency","displayName":"currency","clickhouseType":"LowCardinality(Nullable(String))","jsonType":"string","nullable":true,"description":"ISO-like currency code for monetary values.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"security_type","displayName":"security type","clickhouseType":"LowCardinality(Nullable(String))","jsonType":"string","nullable":true,"description":"Source-normalized field: security type.","descriptionSource":"name_derived","roles":[],"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":["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":"UInt32","jsonType":"integer","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_ts","displayName":"version ts","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"UTC timestamp associated with the row version.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"unit":"UTC_datetime","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","provenance"],"filterNames":["source"],"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":null,"titleCn":"EODHD ID 映射 时点","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“EODHD ID 映射 时点”数据集；一行由 instrument_id、snapshot_date 定位，主要字段包括 snapshot_ts、symbol_raw、exchange_code、isin、figi。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“EODHD ID 映射 时点”的一条记录；逻辑粒度由 instrument_id × snapshot_date 共同确定。","timeSemanticsCn":"以 snapshot_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 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":28,"costGuard":{"tier":"small","identityFilters":["cik","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":"ref.eodhd_symbol_universe","namespace":"ref","name":"eodhd_symbol_universe","coverageTags":["reference"],"description":"Canonical Friends financial dataset: EODHD 全球证券代码全集.","relation":"ref.eodhd_symbol_universe","objectKind":"table","rowMagnitude":"1M-9M","grain":"exchange × observation_date × exchange_code × code × source","cadence":"daily","timeColumn":"updated_at","defaultOrder":["exchange_code","code","observation_date","source"],"filters":[{"name":"code","column":"code","required":false,"multipleValues":true,"jsonType":"string","example":"AAPL"},{"name":"exchange","column":"exchange","required":false,"multipleValues":true,"jsonType":"string","example":"NASDAQ"},{"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":["exchange_code","code","observation_date","source"],"provenanceColumns":[],"fieldCount":23,"fields":[{"position":1,"name":"exchange_code","displayName":"exchange code","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: exchange code.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_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","contract_unique_key"],"filterNames":["code"],"returned":true},{"position":3,"name":"observation_date","displayName":"observation date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for observation date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":4,"name":"instrument_name","displayName":"instrument name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: instrument name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"country","displayName":"country","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: country.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"exchange","displayName":"exchange","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Listing or trading exchange.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["exchange"],"returned":true},{"position":7,"name":"currency","displayName":"currency","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"ISO-like currency code for monetary values.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"instrument_type","displayName":"instrument type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: instrument type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"isin","displayName":"isin","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: isin.","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":["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":"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":"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":"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":23,"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":["time"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"EODHD 全球证券代码全集","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“EODHD 全球证券代码全集”数据集；一行由 exchange_code、code、observation_date、source 定位，主要字段包括 instrument_name、country、exchange、currency、instrument_type。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“EODHD 全球证券代码全集”的一条记录；逻辑粒度由 exchange × observation_date × exchange_code × code × source 共同确定。","timeSemanticsCn":"以 updated_at 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"exchange","meaningCn":"上市或交易场所。"},{"name":"observation_date","meaningCn":"observation date 对应的日历日期。"},{"name":"exchange_code","meaningCn":"用于确定该表业务粒度或默认顺序的 exchange code 字段。"},{"name":"code","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":["code"],"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":"ref.exchange_calendar","namespace":"ref","name":"exchange_calendar","coverageTags":["reference"],"description":"Canonical Friends financial dataset: 交易所 日历.","relation":"ref.exchange_calendar","objectKind":"table","rowMagnitude":"<1K","grain":"exchange_code × calendar_date × source","cadence":"static","timeColumn":"updated_at","defaultOrder":["exchange_code","calendar_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"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["exchange_code","calendar_date","source"],"provenanceColumns":[],"fieldCount":19,"fields":[{"position":1,"name":"exchange_code","displayName":"exchange code","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: exchange code.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":2,"name":"calendar_date","displayName":"calendar date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for calendar 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":"calendar_type","displayName":"calendar type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: calendar type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":4,"name":"holiday_name","displayName":"holiday name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: holiday name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"early_close_local","displayName":"early close local","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: early close local.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"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":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":"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":10,"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":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":"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":13,"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":14,"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":15,"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":16,"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":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":"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":19,"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":["time"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"交易所 日历","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“交易所 日历”数据集；一行由 exchange_code、calendar_date、source 定位，主要字段包括 calendar_type、holiday_name、early_close_local、provider、source_url。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“交易所 日历”的一条记录；逻辑粒度由 exchange_code × calendar_date × source 共同确定。","timeSemanticsCn":"以 updated_at 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"参考主数据，只有定义或映射变化时才更新。","keyFields":[{"name":"exchange_code","meaningCn":"用于确定该表业务粒度或默认顺序的 exchange code 字段。"},{"name":"calendar_date","meaningCn":"calendar 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":19,"costGuard":{"tier":"small","identityFilters":[],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"ref.exchange_eodhd","namespace":"ref","name":"exchange_eodhd","coverageTags":["reference"],"description":"Canonical Friends financial dataset: 交易所 EODHD.","relation":"ref.exchange_eodhd","objectKind":"table","rowMagnitude":"<1K","grain":"exchange_code","cadence":"static","timeColumn":"updated_at","defaultOrder":["exchange_code","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"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["exchange_code","source"],"provenanceColumns":[],"fieldCount":30,"fields":[{"position":1,"name":"exchange_code","displayName":"exchange code","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: exchange code.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":2,"name":"exchange_name","displayName":"exchange name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: exchange name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":3,"name":"operating_mic","displayName":"operating mic","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: operating mic.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":4,"name":"country","displayName":"country","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: country.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"country_iso2","displayName":"country iso2","clickhouseType":"FixedString(2)","jsonType":"string","nullable":false,"description":"Source-normalized field: country iso2.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"country_iso3","displayName":"country iso3","clickhouseType":"FixedString(3)","jsonType":"string","nullable":false,"description":"Source-normalized field: country iso3.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"currency","displayName":"currency","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"ISO-like currency code for monetary values.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"timezone","displayName":"timezone","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: timezone.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"trading_open_local","displayName":"trading open local","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: trading open local.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"trading_close_local","displayName":"trading close local","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: trading close local.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"trading_open_utc","displayName":"trading open utc","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: trading open utc.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"trading_close_utc","displayName":"trading close utc","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: trading close utc.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"working_days","displayName":"working days","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: working days.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"active_tickers","displayName":"active tickers","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Source-normalized field: active tickers.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"updated_tickers","displayName":"updated tickers","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Source-normalized field: updated tickers.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"previous_day_updated_tickers","displayName":"previous day updated tickers","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Source-normalized field: previous day updated tickers.","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":["filter","provenance"],"filterNames":["provider"],"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":"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":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":"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":30,"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":["time"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"交易所 EODHD","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“交易所 EODHD”数据集；一行由 exchange_code、source 定位，主要字段包括 exchange_name、operating_mic、country、country_iso2、country_iso3。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“交易所 EODHD”的一条记录；逻辑粒度由 exchange_code 共同确定。","timeSemanticsCn":"以 updated_at 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"参考主数据，只有定义或映射变化时才更新。","keyFields":[{"name":"exchange_code","meaningCn":"用于确定该表业务粒度或默认顺序的 exchange 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":30,"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":"ref.futures_contract","namespace":"ref","name":"futures_contract","coverageTags":["reference"],"description":"Futures contract metadata and mappings.","relation":"ref.futures_contract","objectKind":"table","rowMagnitude":"10K-99K","grain":"code × market × effective_date","cadence":"weekly","timeColumn":"effective_date","defaultOrder":["effective_date","market","code"],"filters":[{"name":"code","column":"code","required":false,"multipleValues":true,"jsonType":"string","example":"NNNNNN.SH or NNNNNN.SZ","exampleSource":"identifier_format"},{"name":"market","column":"market","required":false,"multipleValues":true,"jsonType":"string","example":"CN","exampleSource":"observed_coverage","allowedValues":["CN"]},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":false,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":35,"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"],"filterNames":["code"],"returned":true},{"position":2,"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":3,"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":4,"name":"effective_date","displayName":"effective date","clickhouseType":"Date32","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":5,"name":"exchange","displayName":"exchange","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Listing or trading exchange.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"product_code","displayName":"product code","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: product code.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"contract_code","displayName":"contract code","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: contract code.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"contract_name","displayName":"contract name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: contract name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"fut_type","displayName":"fut type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: fut type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"list_date","displayName":"list date","clickhouseType":"Nullable(Date32)","jsonType":"string","nullable":true,"description":"Calendar date for list date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":11,"name":"delist_date","displayName":"delist date","clickhouseType":"Nullable(Date32)","jsonType":"string","nullable":true,"description":"Calendar date for delist date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":12,"name":"multiplier","displayName":"multiplier","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Number of timespan units represented by one market bar.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"trade_unit","displayName":"trade unit","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: trade unit.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"per_unit","displayName":"per unit","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: per unit.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"quote_unit","displayName":"quote unit","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: quote unit.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"quote_unit_desc","displayName":"quote unit desc","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: quote unit desc.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"name":"trade_time_desc","displayName":"trade time desc","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: trade time desc.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":18,"name":"d_mode","displayName":"d mode","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: d mode.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":19,"name":"d_mode_desc","displayName":"d mode desc","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: d mode desc.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":20,"name":"continuous_code","displayName":"continuous code","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: continuous code.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":21,"name":"mapped_contract_code","displayName":"mapped contract code","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: mapped contract code.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":22,"name":"mapping_trade_date","displayName":"mapping trade date","clickhouseType":"Nullable(Date32)","jsonType":"string","nullable":true,"description":"Calendar date for mapping trade date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":23,"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":24,"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":25,"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":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":"定义期货代码、市场、生效期和映射关系，用于解释合约身份、到期与连续合约处理。","useCasesCn":["查询合约元数据","处理换月和到期","将来源合约映射到规范代码"],"grainCn":"每行代表“期货合约主数据”的一条记录；逻辑粒度由 code × market × effective_date 共同确定。","timeSemanticsCn":"以 effective_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常每周随上游披露或批处理更新；不是实时数据。","keyFields":[{"name":"code","meaningCn":"来源规范化后的证券、合约或指标代码。"},{"name":"market","meaningCn":"规范市场代码。"},{"name":"effective_date","meaningCn":"公司行为或映射开始生效的日期。"}],"joins":[{"dataset":"ref.instrument","on":"code + market（先确认代码口径）","guidanceCn":"需要补证券主数据时可按代码和市场映射；不同来源代码可能不一致，优先先查 ref.code_mapping。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 cursor，结果过大时必须缩小标的、日期或其他筛选。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":["CN"],"coverage":{"measured":true,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{"CN":{"latestBusinessDate":"2026-08-24","rows":1366}},"latestBusinessDate":"2026-08-24","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":35,"costGuard":{"tier":"small","identityFilters":["code"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"ref.gleif_lei_record","namespace":"ref","name":"gleif_lei_record","coverageTags":["reference"],"description":"Canonical Friends financial dataset: GLEIF LEI 记录.","relation":"ref.gleif_lei_record","objectKind":"table","rowMagnitude":"0","grain":"lei × snapshot_date","cadence":"producer_schedule","timeColumn":"snapshot_ts","defaultOrder":["lei","snapshot_date"],"filters":[{"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":["lei","snapshot_date"],"provenanceColumns":[],"fieldCount":30,"fields":[{"position":1,"name":"snapshot_ts","displayName":"snapshot ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for snapshot ts.","descriptionSource":"name_derived","roles":["time"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":2,"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":3,"name":"lei","displayName":"lei","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: lei.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":4,"name":"legal_name","displayName":"legal name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: legal name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"legal_jurisdiction","displayName":"legal jurisdiction","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: legal jurisdiction.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"entity_legal_form","displayName":"entity legal form","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: entity legal form.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"entity_category","displayName":"entity category","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: entity category.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"entity_status","displayName":"entity status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: entity status.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"registration_status","displayName":"registration status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: registration status.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"initial_reg_date","displayName":"initial reg date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for initial reg date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":11,"name":"last_update_date","displayName":"last update date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for last update date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":12,"name":"next_renewal_date","displayName":"next renewal date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for next renewal date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":13,"name":"managing_lou","displayName":"managing lou","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: managing lou.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"successor_lei","displayName":"successor lei","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: successor lei.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"hq_country","displayName":"hq country","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: hq country.","descriptionSource":"name_derived","roles":[],"filterNames":[],"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_ts","displayName":"version ts","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"UTC timestamp associated with the row version.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"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","provenance"],"filterNames":["source"],"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":"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":29,"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},{"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}],"pit":null,"titleCn":"GLEIF LEI 记录","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“GLEIF LEI 记录”数据集；一行由 lei、snapshot_date 定位，主要字段包括 snapshot_ts、legal_name、legal_jurisdiction、entity_legal_form、entity_category。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“GLEIF LEI 记录”的一条记录；逻辑粒度由 lei × snapshot_date 共同确定。","timeSemanticsCn":"以 snapshot_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"lei","meaningCn":"用于确定该表业务粒度或默认顺序的 lei 字段。"},{"name":"snapshot_date","meaningCn":"snapshot date 对应的日历日期。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["字典采样时该关系可能为空；先查询 catalog 或小范围 rows 判断当前是否已有数据。"],"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":"ref.gleif_lei_relationship","namespace":"ref","name":"gleif_lei_relationship","coverageTags":["reference"],"description":"Canonical Friends financial dataset: GLEIF LEI 关系.","relation":"ref.gleif_lei_relationship","objectKind":"table","rowMagnitude":"0","grain":"child_lei × relationship_type × snapshot_date","cadence":"producer_schedule","timeColumn":"snapshot_ts","defaultOrder":["child_lei","relationship_type","snapshot_date"],"filters":[{"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":["child_lei","relationship_type","snapshot_date"],"provenanceColumns":[],"fieldCount":24,"fields":[{"position":1,"name":"snapshot_ts","displayName":"snapshot ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for snapshot ts.","descriptionSource":"name_derived","roles":["time"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":2,"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":3,"name":"child_lei","displayName":"child lei","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: child lei.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":4,"name":"parent_lei","displayName":"parent lei","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: parent lei.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"relationship_type","displayName":"relationship type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: relationship type.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":6,"name":"relationship_status","displayName":"relationship status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: relationship status.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"exception_reason","displayName":"exception reason","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: exception reason.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"period_start","displayName":"period start","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Source-normalized field: period start.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","returned":true},{"position":9,"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":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_ts","displayName":"version ts","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"UTC timestamp associated with the row version.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"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","provenance"],"filterNames":["source"],"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":"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":23,"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},{"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}],"pit":null,"titleCn":"GLEIF LEI 关系","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“GLEIF LEI 关系”数据集；一行由 child_lei、relationship_type、snapshot_date 定位，主要字段包括 snapshot_ts、parent_lei、relationship_status、exception_reason、period_start。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“GLEIF LEI 关系”的一条记录；逻辑粒度由 child_lei × relationship_type × snapshot_date 共同确定。","timeSemanticsCn":"以 snapshot_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"child_lei","meaningCn":"用于确定该表业务粒度或默认顺序的 child lei 字段。"},{"name":"relationship_type","meaningCn":"用于确定该表业务粒度或默认顺序的 relationship type 字段。"},{"name":"snapshot_date","meaningCn":"snapshot date 对应的日历日期。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["字典采样时该关系可能为空；先查询 catalog 或小范围 rows 判断当前是否已有数据。"],"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":[],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"ref.index_constituents_history","namespace":"ref","name":"index_constituents_history","coverageTags":["reference"],"description":"Canonical Friends financial dataset: 指数 成分股 历史.","relation":"ref.index_constituents_history","objectKind":"table","rowMagnitude":"1K-9K","grain":"instrument_id × effective_date × index_symbol × source","cadence":"event","timeColumn":"publish_ts","defaultOrder":["index_symbol","instrument_id","effective_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":["index_symbol","instrument_id","effective_date","source"],"provenanceColumns":[],"fieldCount":23,"fields":[{"position":1,"name":"index_symbol","displayName":"index symbol","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: index symbol.","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","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["instrument_id"],"returned":true},{"position":3,"name":"member_code","displayName":"member code","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: member code.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":4,"name":"member_market","displayName":"member market","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: member market.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"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":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":6,"name":"removal_date","displayName":"removal date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for removal date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":7,"name":"weight","displayName":"weight","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: weight.","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":["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":"这是证券主数据、交易日历与跨来源映射中的“指数 成分股 历史”数据集；一行由 index_symbol、instrument_id、effective_date、source 定位，主要字段包括 member_code、member_market、removal_date、weight、publish_ts。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“指数 成分股 历史”的一条记录；逻辑粒度由 instrument_id × effective_date × index_symbol × source 共同确定。","timeSemanticsCn":"以 publish_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"effective_date","meaningCn":"公司行为或映射开始生效的日期。"},{"name":"index_symbol","meaningCn":"用于确定该表业务粒度或默认顺序的 index symbol 字段。"},{"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":"ref.industry_mapping","namespace":"ref","name":"industry_mapping","coverageTags":["reference"],"description":"Industry classifications by code and standard.","relation":"ref.industry_mapping","objectKind":"table","rowMagnitude":"<1K","grain":"code × standard","cadence":"static","timeColumn":null,"defaultOrder":["updated_at","code","standard"],"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":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"},{"name":"standard","column":"standard","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":false,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":20,"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"],"filterNames":["code"],"returned":true},{"position":2,"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":3,"name":"standard","displayName":"standard","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: standard.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["standard"],"returned":true},{"position":4,"name":"industry_code","displayName":"industry code","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: industry code.","descriptionSource":"name_derived","roles":["warehouse_primary_key"],"filterNames":[],"returned":true},{"position":5,"name":"industry_name","displayName":"industry name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: industry name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"level","displayName":"level","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: level.","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":"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":["default_order"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"行业分类映射","summaryCn":"按代码和分类标准保存行业归属，支持在不同标准之间解释公司或行业代码。","useCasesCn":["查询证券行业分类","比较不同分类标准","构建行业中性分组"],"grainCn":"每行代表“行业分类映射”的一条记录；逻辑粒度由 code × standard 共同确定。","timeSemanticsCn":"该表没有单一主时间列；请使用业务日期或版本字段，并按关键字段确定范围。","cadenceCn":"参考主数据，只有定义或映射变化时才更新。","keyFields":[{"name":"code","meaningCn":"来源规范化后的证券、合约或指标代码。"},{"name":"standard","meaningCn":"用于确定该表业务粒度或默认顺序的 standard 字段。"}],"joins":[{"dataset":"ref.instrument","on":"code + market（先确认代码口径）","guidanceCn":"需要补证券主数据时可按代码和市场映射；不同来源代码可能不一致，优先先查 ref.code_mapping。"}],"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":20,"costGuard":{"tier":"small","identityFilters":["code"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"ref.instrument","namespace":"ref","name":"instrument","coverageTags":["a_share","reference"],"description":"Canonical instrument universe.","relation":"ref.instrument","objectKind":"table","rowMagnitude":"100K-999K","grain":"instrument_id","cadence":"daily","timeColumn":null,"defaultOrder":["updated_at","instrument_id"],"filters":[{"name":"asset_type","column":"asset_type","required":false,"multipleValues":true,"jsonType":"string","example":"equity"},{"name":"exchange","column":"exchange","required":false,"multipleValues":true,"jsonType":"string","example":"NASDAQ"},{"name":"market","column":"market","required":false,"multipleValues":true,"jsonType":"string","example":"HK","exampleSource":"verified_production_value"},{"name":"symbol","column":"symbol","required":false,"multipleValues":true,"jsonType":"string","example":"1208.HK","exampleSource":"verified_production_value"}],"maxLimit":50000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"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":["default_order","warehouse_primary_key"],"filterNames":[],"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":"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":"asset_type","displayName":"asset type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Instrument asset-class classification.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["asset_type"],"returned":true},{"position":5,"name":"exchange","displayName":"exchange","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Listing or trading exchange.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["exchange"],"returned":true},{"position":6,"name":"name","displayName":"name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Canonical human-readable name.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"name_en","displayName":"name en","clickhouseType":"String","jsonType":"string","nullable":false,"description":"English human-readable name when available.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"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":["default_order"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":21,"name":"list_date","displayName":"list date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for list date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":22,"name":"delist_date","displayName":"delist date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for delist date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":23,"name":"country","displayName":"country","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: country.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":24,"name":"currency","displayName":"currency","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"ISO-like currency code for monetary values.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":25,"name":"sector","displayName":"sector","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: sector.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":26,"name":"industry","displayName":"industry","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: industry.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":27,"name":"cusip","displayName":"cusip","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: cusip.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":28,"name":"isin","displayName":"isin","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: isin.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":29,"name":"figi","displayName":"figi","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: figi.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":30,"name":"is_active","displayName":"is active","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Whether active applies to the row.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true}],"pit":null,"titleCn":"规范证券主表","summaryCn":"Friends Data API 的统一标的入口，定义 instrument_id、代码、名称、市场、交易所和资产类型。","useCasesCn":["用名称或代码解析 instrument_id","联接跨数据集证券记录","构建可查询标的宇宙"],"grainCn":"每行代表“规范证券主表”的一条记录；逻辑粒度由 instrument_id 共同确定。","timeSemanticsCn":"该表没有单一主时间列；请使用业务日期或版本字段，并按关键字段确定范围。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"}],"joins":[{"dataset":"","on":"instrument_id","guidanceCn":"这是证券维表：market、fundamental、flow、ownership 等表只要含 instrument_id，就优先用该字段关联到这里补代码、名称、市场、交易所和资产类型。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 50000 行，响应有 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":["symbol"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"ref.instrument_overview_massive","namespace":"ref","name":"instrument_overview_massive","coverageTags":["reference"],"description":"Canonical Friends financial dataset: Massive 证券概览.","relation":"ref.instrument_overview_massive","objectKind":"table","rowMagnitude":"1K-9K","grain":"ticker","cadence":"daily","timeColumn":"publish_ts","defaultOrder":["ticker","source"],"filters":[{"name":"cik","column":"cik","required":false,"multipleValues":true,"jsonType":"string","example":"0000320193"},{"name":"market","column":"market","required":false,"multipleValues":true,"jsonType":"string","example":"otc","exampleSource":"observed_coverage","allowedValues":["otc","stocks"]},{"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":["ticker","source"],"provenanceColumns":[],"fieldCount":47,"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":"name","displayName":"name","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Canonical human-readable name.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"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":"locale","displayName":"locale","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: locale.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"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":6,"name":"type","displayName":"type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"active","displayName":"active","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: active.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"currency_name","displayName":"currency name","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: currency name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"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":10,"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":11,"name":"share_class_figi","displayName":"share class figi","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: share class figi.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"market_cap","displayName":"market cap","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: market cap.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"phone_number","displayName":"phone number","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: phone number.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"address1","displayName":"address1","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: address1.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"city","displayName":"city","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: city.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"state","displayName":"state","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: state.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"name":"postal_code","displayName":"postal code","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: postal code.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":18,"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":19,"name":"sic_code","displayName":"sic code","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: sic code.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":20,"name":"sic_description","displayName":"sic description","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: sic description.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":21,"name":"ticker_root","displayName":"ticker root","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: ticker root.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":22,"name":"homepage_url","displayName":"homepage url","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: homepage url.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":23,"name":"total_employees","displayName":"total employees","clickhouseType":"Nullable(UInt32)","jsonType":"integer","nullable":true,"description":"Source-normalized field: total employees.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":24,"name":"list_date","displayName":"list date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for list date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":25,"name":"branding_logo_url","displayName":"branding logo url","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: branding logo url.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":26,"name":"branding_icon_url","displayName":"branding icon url","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: branding icon url.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":27,"name":"share_class_shares_outstanding","displayName":"share class shares outstanding","clickhouseType":"Nullable(UInt64)","jsonType":"integer","nullable":true,"description":"Source-normalized field: share class shares outstanding.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":28,"name":"weighted_shares_outstanding","displayName":"weighted shares outstanding","clickhouseType":"Nullable(UInt64)","jsonType":"integer","nullable":true,"description":"Source-normalized field: weighted shares outstanding.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":29,"name":"round_lot","displayName":"round lot","clickhouseType":"Nullable(UInt32)","jsonType":"integer","nullable":true,"description":"Source-normalized field: round lot.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":30,"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":31,"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":32,"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":33,"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":34,"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":35,"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":36,"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":37,"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":38,"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":39,"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":40,"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":41,"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":42,"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":43,"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":44,"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":45,"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":46,"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":47,"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":"Massive 证券概览","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“Massive 证券概览”数据集；一行由 ticker、source 定位，主要字段包括 name、market、locale、primary_exchange、type。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“Massive 证券概览”的一条记录；逻辑粒度由 ticker 共同确定。","timeSemanticsCn":"以 publish_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"ticker","meaningCn":"来源或证券主表使用的股票代码。"},{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":["otc","stocks"],"coverage":{"measured":true,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{"otc":{"latestBusinessDate":"2026-08-25","rows":24},"stocks":{"latestBusinessDate":"2026-08-25","rows":4220}},"latestBusinessDate":"2026-08-25","note":"Recent observed coverage, not a lifetime guarantee. An unmeasured dataset carries no support claim in either direction."},"identifier":{"namespace":"mixed","formatByMarket":{"otc":"TICKER","stocks":"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},"coverageDisclosure":{"coveredInstruments":4479,"universeInstruments":106795,"measuredOn":"2026-08-29","note":"Massive/Polygon ticker-overview landing table. Every one of its 4,479 tickers resolves to a canonical instrument, but it covers 4.2% of the universe; an empty result for a ticker outside that set is a coverage gap, not an absent company."},"returnedFieldCount":47,"costGuard":{"tier":"small","identityFilters":["cik","ticker"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"DENIED","deniedSources":["massive"],"reasons":["restricted_license_scope","restricted_visibility_tier"]}},{"object":"dataset_schema","asset":"ref.market_holiday","namespace":"ref","name":"market_holiday","coverageTags":["reference"],"description":"Canonical Friends financial dataset: 市场 休市日.","relation":"ref.market_holiday","objectKind":"table","rowMagnitude":"<1K","grain":"date × exchange × name","cadence":"static","timeColumn":"date","defaultOrder":["date","exchange","name"],"filters":[{"name":"exchange","column":"exchange","required":false,"multipleValues":true,"jsonType":"string","example":"NASDAQ"},{"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":["date","exchange","name"],"provenanceColumns":[],"fieldCount":21,"fields":[{"position":1,"name":"date","displayName":"date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for 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":2,"name":"exchange","displayName":"exchange","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Listing or trading exchange.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["exchange"],"returned":true},{"position":3,"name":"name","displayName":"name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Canonical human-readable name.","descriptionSource":"standard_glossary","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":4,"name":"status","displayName":"status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: status.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"open_ts","displayName":"open ts","clickhouseType":"Nullable(DateTime64(3, 'UTC'))","jsonType":"string","nullable":true,"description":"UTC timestamp for open ts.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":6,"name":"close_ts","displayName":"close ts","clickhouseType":"Nullable(DateTime64(3, 'UTC'))","jsonType":"string","nullable":true,"description":"UTC timestamp for close ts.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","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":"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":"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":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":"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":"这是证券主数据、交易日历与跨来源映射中的“市场 休市日”数据集；一行由 date、exchange、name 定位，主要字段包括 status、open_ts、close_ts、ingested_at、source。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“市场 休市日”的一条记录；逻辑粒度由 date × exchange × name 共同确定。","timeSemanticsCn":"以 date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"参考主数据，只有定义或映射变化时才更新。","keyFields":[{"name":"date","meaningCn":"该记录所属的日历日期。"},{"name":"exchange","meaningCn":"上市或交易场所。"},{"name":"name","meaningCn":"用于确定该表业务粒度或默认顺序的 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":21,"costGuard":{"tier":"small","identityFilters":[],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"ref.market_status_snapshot","namespace":"ref","name":"market_status_snapshot","coverageTags":["reference"],"description":"Canonical Friends financial dataset: 市场 状态 快照.","relation":"ref.market_status_snapshot","objectKind":"table","rowMagnitude":"1K-9K","grain":"market × observed_at","cadence":"intraday","timeColumn":"observed_at","defaultOrder":["observed_at","market"],"filters":[{"name":"market","column":"market","required":false,"multipleValues":true,"jsonType":"string","example":"extended-hours","exampleSource":"observed_coverage","allowedValues":["extended-hours","open"]},{"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","market"],"provenanceColumns":[],"fieldCount":26,"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":"server_time","displayName":"server time","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: server time.","descriptionSource":"name_derived","roles":[],"filterNames":[],"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","contract_unique_key"],"filterNames":["market"],"returned":true},{"position":4,"name":"early_hours","displayName":"early hours","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: early hours.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"after_hours","displayName":"after hours","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: after hours.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"exchange_nyse","displayName":"exchange nyse","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: exchange nyse.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"exchange_nasdaq","displayName":"exchange nasdaq","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: exchange nasdaq.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"exchange_otc","displayName":"exchange otc","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: exchange otc.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"currency_crypto","displayName":"currency crypto","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: currency crypto.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"currency_fx","displayName":"currency fx","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: currency fx.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"indices_groups_json","displayName":"indices groups json","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: indices groups json.","descriptionSource":"name_derived","roles":[],"filterNames":[],"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":"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":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":"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":"这是证券主数据、交易日历与跨来源映射中的“市场 状态 快照”数据集；一行由 observed_at、market 定位，主要字段包括 server_time、early_hours、after_hours、exchange_nyse、exchange_nasdaq。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“市场 状态 快照”的一条记录；逻辑粒度由 market × observed_at 共同确定。","timeSemanticsCn":"以 observed_at 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"交易时段内可多次更新；请检查时间列判断新鲜度。","keyFields":[{"name":"market","meaningCn":"规范市场代码。"},{"name":"observed_at","meaningCn":"observed at 对应的时间戳；除表内特别说明外按 UTC 解释。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":["extended-hours","open"],"coverage":{"measured":true,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{"extended-hours":{"latestBusinessDate":"2026-08-25","rows":160},"open":{"latestBusinessDate":"2026-08-28","rows":502}},"latestBusinessDate":"2026-08-28","note":"Recent observed coverage, not a lifetime guarantee. An unmeasured dataset carries no support claim in either direction."},"identifier":{"namespace":"mixed","formatByMarket":{"extended-hours":"TICKER","open":"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":26,"costGuard":{"tier":"small","identityFilters":[],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"ref.massive_condition_codes","namespace":"ref","name":"massive_condition_codes","coverageTags":["reference"],"description":"Canonical Friends financial dataset: Massive 条件码 代码.","relation":"ref.massive_condition_codes","objectKind":"table","rowMagnitude":"<1K","grain":"asset_class × id × source","cadence":"weekly","timeColumn":"publish_ts","defaultOrder":["asset_class","id","source"],"filters":[{"name":"exchange","column":"exchange","required":false,"multipleValues":true,"jsonType":"integer","example":"NASDAQ"},{"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":["asset_class","id","source"],"provenanceColumns":[],"fieldCount":28,"fields":[{"position":1,"name":"asset_class","displayName":"asset class","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: asset class.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":2,"name":"id","displayName":"id","clickhouseType":"Int32","jsonType":"integer","nullable":false,"description":"Source-normalized field: id.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":3,"name":"type","displayName":"type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: type.","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":"exchange","displayName":"exchange","clickhouseType":"Nullable(Int32)","jsonType":"integer","nullable":true,"description":"Listing or trading exchange.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["exchange"],"returned":true},{"position":7,"name":"legacy","displayName":"legacy","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: legacy.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"data_types","displayName":"data types","clickhouseType":"Array(String)","jsonType":"array","nullable":false,"description":"Source-normalized field: data types.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"sip_mapping_json","displayName":"sip mapping json","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: sip mapping json.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"update_rules_json","displayName":"update rules json","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: update rules 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":["time","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},{"position":27,"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":28,"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":"Massive 条件码 代码","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“Massive 条件码 代码”数据集；一行由 asset_class、id、source 定位，主要字段包括 type、name、description、exchange、legacy。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“Massive 条件码 代码”的一条记录；逻辑粒度由 asset_class × id × source 共同确定。","timeSemanticsCn":"以 publish_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常每周随上游披露或批处理更新；不是实时数据。","keyFields":[{"name":"asset_class","meaningCn":"用于确定该表业务粒度或默认顺序的 asset class 字段。"},{"name":"id","meaningCn":"用于确定该表业务粒度或默认顺序的 id 字段。"},{"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":28,"costGuard":{"tier":"small","identityFilters":[],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"DENIED","deniedSources":["massive"],"reasons":["restricted_license_scope","restricted_visibility_tier"]}},{"object":"dataset_schema","asset":"ref.massive_exchange","namespace":"ref","name":"massive_exchange","coverageTags":["reference"],"description":"Canonical Friends financial dataset: Massive 交易所.","relation":"ref.massive_exchange","objectKind":"table","rowMagnitude":"<1K","grain":"asset_class × id × source","cadence":"weekly","timeColumn":"publish_ts","defaultOrder":["asset_class","id","source"],"filters":[{"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":["asset_class","id","source"],"provenanceColumns":[],"fieldCount":29,"fields":[{"position":1,"name":"asset_class","displayName":"asset class","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: asset class.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":2,"name":"id","displayName":"id","clickhouseType":"Int32","jsonType":"integer","nullable":false,"description":"Source-normalized field: id.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":3,"name":"type","displayName":"type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":4,"name":"market","displayName":"market","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Canonical market or country-market code.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["market"],"returned":true},{"position":5,"name":"mic","displayName":"mic","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: mic.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"operating_mic","displayName":"operating mic","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: operating mic.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"participant_id","displayName":"participant id","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Identifier for participant.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"name","displayName":"name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Canonical human-readable name.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"acronym","displayName":"acronym","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: acronym.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"locale","displayName":"locale","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: locale.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"url","displayName":"url","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Canonical URL attached to the record.","descriptionSource":"standard_glossary","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":["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},{"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":"Massive 交易所","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“Massive 交易所”数据集；一行由 asset_class、id、source 定位，主要字段包括 type、market、mic、operating_mic、participant_id。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“Massive 交易所”的一条记录；逻辑粒度由 asset_class × id × source 共同确定。","timeSemanticsCn":"以 publish_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常每周随上游披露或批处理更新；不是实时数据。","keyFields":[{"name":"asset_class","meaningCn":"用于确定该表业务粒度或默认顺序的 asset class 字段。"},{"name":"id","meaningCn":"用于确定该表业务粒度或默认顺序的 id 字段。"},{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"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":[],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"DENIED","deniedSources":["massive"],"reasons":["restricted_license_scope","restricted_visibility_tier"]}},{"object":"dataset_schema","asset":"ref.massive_risk_taxonomy","namespace":"ref","name":"massive_risk_taxonomy","coverageTags":["reference"],"description":"Canonical Friends financial dataset: Massive 风险 分类表.","relation":"ref.massive_risk_taxonomy","objectKind":"table","rowMagnitude":"<1K","grain":"primary_category × secondary_category × tertiary_category × source","cadence":"weekly","timeColumn":"publish_ts","defaultOrder":["primary_category","secondary_category","tertiary_category","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"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["primary_category","secondary_category","tertiary_category","source"],"provenanceColumns":[],"fieldCount":23,"fields":[{"position":1,"name":"primary_category","displayName":"primary category","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: primary category.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":2,"name":"secondary_category","displayName":"secondary category","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: secondary category.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":3,"name":"tertiary_category","displayName":"tertiary category","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: tertiary category.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":4,"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":5,"name":"taxonomy_version","displayName":"taxonomy version","clickhouseType":"Nullable(Float32)","jsonType":"number","nullable":true,"description":"Source-normalized field: taxonomy version.","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":["time","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":"Massive 风险 分类表","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“Massive 风险 分类表”数据集；一行由 primary_category、secondary_category、tertiary_category、source 定位，主要字段包括 description、taxonomy_version、publish_ts、source_ts、ingested_at。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“Massive 风险 分类表”的一条记录；逻辑粒度由 primary_category × secondary_category × tertiary_category × source 共同确定。","timeSemanticsCn":"以 publish_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常每周随上游披露或批处理更新；不是实时数据。","keyFields":[{"name":"primary_category","meaningCn":"用于确定该表业务粒度或默认顺序的 primary category 字段。"},{"name":"secondary_category","meaningCn":"用于确定该表业务粒度或默认顺序的 secondary category 字段。"},{"name":"tertiary_category","meaningCn":"用于确定该表业务粒度或默认顺序的 tertiary category 字段。"},{"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":[],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"DENIED","deniedSources":["massive"],"reasons":["restricted_license_scope","restricted_visibility_tier"]}},{"object":"dataset_schema","asset":"ref.massive_ticker_type","namespace":"ref","name":"massive_ticker_type","coverageTags":["reference"],"description":"Canonical Friends financial dataset: Massive 证券类型代码.","relation":"ref.massive_ticker_type","objectKind":"table","rowMagnitude":"<1K","grain":"asset_class × code × source","cadence":"weekly","timeColumn":"publish_ts","defaultOrder":["asset_class","code","source"],"filters":[{"name":"code","column":"code","required":false,"multipleValues":true,"jsonType":"string","example":"AAPL"},{"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":["asset_class","code","source"],"provenanceColumns":[],"fieldCount":22,"fields":[{"position":1,"name":"asset_class","displayName":"asset class","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: asset class.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":2,"name":"code","displayName":"code","clickhouseType":"LowCardinality(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":"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":4,"name":"locale","displayName":"locale","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: locale.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"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":6,"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":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":"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":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":"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":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":"Massive 证券类型代码","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“Massive 证券类型代码”数据集；一行由 asset_class、code、source 定位，主要字段包括 description、locale、publish_ts、source_ts、ingested_at。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“Massive 证券类型代码”的一条记录；逻辑粒度由 asset_class × code × source 共同确定。","timeSemanticsCn":"以 publish_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常每周随上游披露或批处理更新；不是实时数据。","keyFields":[{"name":"asset_class","meaningCn":"用于确定该表业务粒度或默认顺序的 asset class 字段。"},{"name":"code","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":22,"costGuard":{"tier":"small","identityFilters":["code"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"DENIED","deniedSources":["massive"],"reasons":["restricted_license_scope","restricted_visibility_tier"]}},{"object":"dataset_schema","asset":"ref.news_subject_anchor","namespace":"ref","name":"news_subject_anchor","coverageTags":["reference"],"description":"Canonical Friends financial dataset: 新闻主题与股票锚点.","relation":"ref.news_subject_anchor","objectKind":"table","rowMagnitude":"1K-9K","grain":"ticker","cadence":"producer_schedule","timeColumn":"updated_at","defaultOrder":["ticker"],"filters":[{"name":"provider","column":"provider","required":false,"multipleValues":true,"jsonType":"string","example":"PROVIDER_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"],"provenanceColumns":[],"fieldCount":14,"fields":[{"position":1,"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","contract_unique_key"],"filterNames":["ticker"],"returned":true},{"position":2,"name":"subject_anchor","displayName":"subject anchor","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: subject anchor.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":3,"name":"anchor_source","displayName":"anchor source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: anchor source.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":4,"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},{"position":5,"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":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}],"pit":null,"titleCn":"新闻主题与股票锚点","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“新闻主题与股票锚点”数据集；一行由 ticker 定位，主要字段包括 subject_anchor、anchor_source、updated_at、provider、source_url。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“新闻主题与股票锚点”的一条记录；逻辑粒度由 ticker 共同确定。","timeSemanticsCn":"以 updated_at 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"ticker","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":14,"costGuard":{"tier":"small","identityFilters":["ticker"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"ref.option_contract","namespace":"ref","name":"option_contract","coverageTags":["options","reference"],"description":"Canonical Friends financial dataset: 期权合约主表.","relation":"ref.option_contract","objectKind":"table","rowMagnitude":"10M-99M","grain":"ticker","cadence":"daily","timeColumn":"publish_ts","defaultOrder":["underlying_ticker","expiration_date","strike_price","contract_type","ticker","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":true,"multipleValues":true,"jsonType":"string","example":"AAPL"}],"maxLimit":5000,"maxWindowDays":400,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["underlying_ticker","expiration_date","strike_price","contract_type","ticker","source"],"provenanceColumns":[],"fieldCount":30,"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","required_filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["ticker"],"returned":true},{"position":2,"name":"underlying_ticker","displayName":"underlying ticker","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: underlying ticker.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":3,"name":"contract_type","displayName":"contract type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: contract type.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":4,"name":"exercise_style","displayName":"exercise style","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: exercise style.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"expiration_date","displayName":"expiration date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for expiration date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":6,"name":"strike_price","displayName":"strike price","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"Price value for strike price.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":7,"name":"shares_per_contract","displayName":"shares per contract","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Source-normalized field: shares per contract.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"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":9,"name":"cfi","displayName":"cfi","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: cfi.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"additional_underlyings","displayName":"additional underlyings","clickhouseType":"Array(String)","jsonType":"array","nullable":false,"description":"Source-normalized field: additional underlyings.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"expired","displayName":"expired","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: expired.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"as_of_date","displayName":"as of date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for as of date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":13,"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":14,"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":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","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":17,"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":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":"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":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":"这是证券主数据、交易日历与跨来源映射中的“期权合约主表”数据集；一行由 underlying_ticker、expiration_date、strike_price、contract_type 定位，主要字段包括 ticker、exercise_style、shares_per_contract、primary_exchange、cfi。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“期权合约主表”的一条记录；逻辑粒度由 ticker 共同确定。","timeSemanticsCn":"以 publish_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"ticker","meaningCn":"来源或证券主表使用的股票代码。"},{"name":"underlying_ticker","meaningCn":"用于确定该表业务粒度或默认顺序的 underlying ticker 字段。"},{"name":"expiration_date","meaningCn":"expiration date 对应的日历日期。"},{"name":"strike_price","meaningCn":"用于确定该表业务粒度或默认顺序的 strike price 字段。"},{"name":"contract_type","meaningCn":"用于确定该表业务粒度或默认顺序的 contract type 字段。"},{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；必须提供 ticker；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["该关系数据量较大，必须提供 ticker；这只限制单次扫描，不减少可访问历史。","单次请求的 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":30,"costGuard":{"tier":"small","identityFilters":["ticker"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"ref.quant_exchange_session_calendar","namespace":"ref","name":"quant_exchange_session_calendar","coverageTags":["reference"],"description":"Canonical Friends financial dataset: 量化交易所会话日历.","relation":"ref.quant_exchange_session_calendar","objectKind":"table","rowMagnitude":"<1K","grain":"calendar_id × exchange × source_version × session_index × record_id","cadence":"producer_schedule","timeColumn":"created_at","defaultOrder":["calendar_id","exchange","source_version","session_index","record_id"],"filters":[{"name":"exchange","column":"exchange","required":false,"multipleValues":true,"jsonType":"string","example":"NASDAQ"},{"name":"provider","column":"provider","required":false,"multipleValues":true,"jsonType":"string","example":"PROVIDER_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"relation_default","contractVersion":null,"uniqueKey":["calendar_id","exchange","source_version","session_index","record_id"],"provenanceColumns":[],"fieldCount":36,"fields":[{"position":1,"name":"record_id","displayName":"record id","clickhouseType":"FixedString(64)","jsonType":"string","nullable":false,"description":"Identifier for record.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":2,"name":"calendar_id","displayName":"calendar id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for calendar.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":3,"name":"exchange","displayName":"exchange","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Listing or trading exchange.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["exchange"],"returned":true},{"position":4,"name":"timezone","displayName":"timezone","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: timezone.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"coverage_start","displayName":"coverage start","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Source-normalized field: coverage start.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","returned":true},{"position":6,"name":"coverage_end","displayName":"coverage end","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Source-normalized field: coverage end.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","returned":true},{"position":7,"name":"expected_session_count","displayName":"expected session count","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Count of expected session count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"session_date","displayName":"session date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for session date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":9,"name":"session_index","displayName":"session index","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Source-normalized field: session index.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":10,"name":"open_ts","displayName":"open ts","clickhouseType":"DateTime64(6, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for open ts.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":11,"name":"close_ts","displayName":"close ts","clickhouseType":"DateTime64(6, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for close ts.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":12,"name":"knowledge_available_at","displayName":"knowledge available at","clickhouseType":"DateTime64(6, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for knowledge available at.","descriptionSource":"name_derived","roles":["warehouse_primary_key"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":13,"name":"source_system","displayName":"source system","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: source system.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"source_version","displayName":"source version","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: source version.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"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":["warehouse_primary_key","provenance"],"filterNames":[],"returned":true},{"position":16,"name":"raw_payload_sha256","displayName":"raw payload sha256","clickhouseType":"FixedString(64)","jsonType":"string","nullable":false,"description":"Source-normalized field: raw payload sha256.","descriptionSource":"name_derived","roles":[],"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":"snapshot_sha256","displayName":"snapshot sha256","clickhouseType":"FixedString(64)","jsonType":"string","nullable":false,"description":"Source-normalized field: snapshot sha256.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":20,"name":"content_sha256","displayName":"content sha256","clickhouseType":"FixedString(64)","jsonType":"string","nullable":false,"description":"Source-normalized field: content sha256.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":21,"name":"dataset_sha256","displayName":"dataset sha256","clickhouseType":"FixedString(64)","jsonType":"string","nullable":false,"description":"Source-normalized field: dataset sha256.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":22,"name":"import_contract_sha256","displayName":"import contract sha256","clickhouseType":"FixedString(64)","jsonType":"string","nullable":false,"description":"Source-normalized field: import contract sha256.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":23,"name":"reviewer_key_id","displayName":"reviewer key id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for reviewer key.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":24,"name":"reviewer_key_record_sha256","displayName":"reviewer key record sha256","clickhouseType":"FixedString(64)","jsonType":"string","nullable":false,"description":"Source-normalized field: reviewer key record sha256.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":25,"name":"reviewed_at","displayName":"reviewed at","clickhouseType":"DateTime64(6, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for reviewed at.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":26,"name":"review_signature_sha256","displayName":"review signature sha256","clickhouseType":"FixedString(64)","jsonType":"string","nullable":false,"description":"Source-normalized field: review signature sha256.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":27,"name":"calendar_source_sha256","displayName":"calendar source sha256","clickhouseType":"FixedString(64)","jsonType":"string","nullable":false,"description":"Source-normalized field: calendar source sha256.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":28,"name":"source_manifest_sha256","displayName":"source manifest sha256","clickhouseType":"FixedString(64)","jsonType":"string","nullable":false,"description":"Source-normalized field: source manifest sha256.","descriptionSource":"name_derived","roles":[],"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":["warehouse_primary_key","provenance"],"filterNames":[],"returned":true},{"position":30,"name":"created_at","displayName":"created at","clickhouseType":"DateTime64(6, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was first created.","descriptionSource":"standard_glossary","roles":["time"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":31,"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":32,"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":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":"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":35,"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":36,"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}],"pit":null,"titleCn":"量化交易所会话日历","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“量化交易所会话日历”数据集；一行由 calendar_id、exchange、source_version、session_index 定位，主要字段包括 record_id、timezone、coverage_start、coverage_end、expected_session_count。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“量化交易所会话日历”的一条记录；逻辑粒度由 calendar_id × exchange × source_version × session_index × record_id 共同确定。","timeSemanticsCn":"以 created_at 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"calendar_id","meaningCn":"用于识别 calendar 的业务标识。"},{"name":"exchange","meaningCn":"上市或交易场所。"},{"name":"source_version","meaningCn":"用于确定该表业务粒度或默认顺序的 source version 字段。"},{"name":"session_index","meaningCn":"用于确定该表业务粒度或默认顺序的 session index 字段。"},{"name":"record_id","meaningCn":"用于识别 record 的业务标识。"}],"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":36,"costGuard":{"tier":"small","identityFilters":[],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"ref.quant_flow_symbol_identity_pit","namespace":"ref","name":"quant_flow_symbol_identity_pit","coverageTags":["reference"],"description":"Canonical Friends financial dataset: 量化资金流代码时点映射.","relation":"ref.quant_flow_symbol_identity_pit","objectKind":"table","rowMagnitude":"0","grain":"source_system × market × symbol_normalized × valid_from × source_record_id × version","cadence":"producer_schedule","timeColumn":"created_at","defaultOrder":["source_system","market","symbol_normalized","valid_from","source_record_id","version"],"filters":[{"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"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"relation_default","contractVersion":null,"uniqueKey":["source_system","market","symbol_normalized","valid_from","source_record_id","version"],"provenanceColumns":[],"fieldCount":33,"fields":[{"position":1,"name":"record_id","displayName":"record id","clickhouseType":"FixedString(64)","jsonType":"string","nullable":false,"description":"Identifier for record.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":2,"name":"source_system","displayName":"source system","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: source system.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"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","contract_unique_key"],"filterNames":["market"],"returned":true},{"position":4,"name":"symbol_raw","displayName":"symbol raw","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: symbol raw.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"symbol_normalized","displayName":"symbol normalized","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: symbol normalized.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":6,"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":7,"name":"economic_underlying_symbol","displayName":"economic underlying symbol","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: economic underlying symbol.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"economic_underlying_instrument_id","displayName":"economic underlying instrument id","clickhouseType":"Nullable(UInt64)","jsonType":"integer","nullable":true,"description":"Identifier for economic underlying instrument.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"valid_from","displayName":"valid from","clickhouseType":"DateTime64(6, 'UTC')","jsonType":"string","nullable":false,"description":"Source-normalized field: valid from.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date-time","returned":true},{"position":10,"name":"valid_to","displayName":"valid to","clickhouseType":"Nullable(DateTime64(6, 'UTC'))","jsonType":"string","nullable":true,"description":"Source-normalized field: valid to.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date-time","returned":true},{"position":11,"name":"knowledge_available_at","displayName":"knowledge available at","clickhouseType":"DateTime64(6, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for knowledge available at.","descriptionSource":"name_derived","roles":["warehouse_primary_key"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":12,"name":"mapping_as_of","displayName":"mapping as of","clickhouseType":"DateTime64(6, 'UTC')","jsonType":"string","nullable":false,"description":"Source-normalized field: mapping as of.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date-time","returned":true},{"position":13,"name":"mapping_status","displayName":"mapping status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: mapping status.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"resolution_basis","displayName":"resolution basis","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: resolution basis.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"stable_id_kind","displayName":"stable id kind","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: stable id kind.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"stable_id_value","displayName":"stable id value","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: stable id value.","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":["filter","provenance"],"filterNames":["provider"],"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":["default_order","warehouse_primary_key","contract_unique_key","provenance"],"filterNames":[],"returned":true},{"position":20,"name":"raw_payload_sha256","displayName":"raw payload sha256","clickhouseType":"FixedString(64)","jsonType":"string","nullable":false,"description":"Source-normalized field: raw payload sha256.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":21,"name":"dataset_sha256","displayName":"dataset sha256","clickhouseType":"FixedString(64)","jsonType":"string","nullable":false,"description":"Source-normalized field: dataset sha256.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":22,"name":"source_payload_sha256","displayName":"source payload sha256","clickhouseType":"FixedString(64)","jsonType":"string","nullable":false,"description":"Source-normalized field: source payload sha256.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":23,"name":"import_contract_sha256","displayName":"import contract sha256","clickhouseType":"FixedString(64)","jsonType":"string","nullable":false,"description":"Source-normalized field: import contract sha256.","descriptionSource":"name_derived","roles":[],"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":"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":"mapping_contract_version","displayName":"mapping contract version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: mapping contract version.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":27,"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":28,"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":29,"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":30,"name":"version","displayName":"version","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Monotonic row version used for correction-aware reads.","descriptionSource":"standard_glossary","roles":["default_order","warehouse_primary_key","contract_unique_key","provenance"],"filterNames":[],"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(6, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was first created.","descriptionSource":"standard_glossary","roles":["time"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","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}],"pit":null,"titleCn":"量化资金流代码时点映射","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“量化资金流代码时点映射”数据集；一行由 source_system、market、symbol_normalized、valid_from 定位，主要字段包括 record_id、symbol_raw、instrument_id、economic_underlying_symbol、economic_underlying_instrument_id。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“量化资金流代码时点映射”的一条记录；逻辑粒度由 source_system × market × symbol_normalized × valid_from × source_record_id × version 共同确定。","timeSemanticsCn":"以 created_at 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"source_system","meaningCn":"用于确定该表业务粒度或默认顺序的 source system 字段。"},{"name":"market","meaningCn":"规范市场代码。"},{"name":"symbol_normalized","meaningCn":"用于确定该表业务粒度或默认顺序的 symbol normalized 字段。"},{"name":"valid_from","meaningCn":"用于确定该表业务粒度或默认顺序的 valid from 字段。"},{"name":"source_record_id","meaningCn":"用于识别 source record 的业务标识。"},{"name":"version","meaningCn":"用于确定该表业务粒度或默认顺序的 version 字段。"}],"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":33,"costGuard":{"tier":"small","identityFilters":["instrument_id"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"ref.quant_sector_benchmark_identity_pit","namespace":"ref","name":"quant_sector_benchmark_identity_pit","coverageTags":["reference"],"description":"Canonical Friends financial dataset: 行业基准时点映射.","relation":"ref.quant_sector_benchmark_identity_pit","objectKind":"table","rowMagnitude":"0","grain":"market × instrument_id × valid_from × source_record_id × version","cadence":"producer_schedule","timeColumn":"created_at","defaultOrder":["market","instrument_id","valid_from","source_record_id","version"],"filters":[{"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"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"relation_default","contractVersion":null,"uniqueKey":["market","instrument_id","valid_from","source_record_id","version"],"provenanceColumns":[],"fieldCount":26,"fields":[{"position":1,"name":"record_id","displayName":"record id","clickhouseType":"FixedString(64)","jsonType":"string","nullable":false,"description":"Identifier for record.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":2,"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","contract_unique_key"],"filterNames":["market"],"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":"sector","displayName":"sector","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: sector.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"sector_etf_symbol","displayName":"sector etf symbol","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: sector etf symbol.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"sector_etf_instrument_id","displayName":"sector etf instrument id","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Identifier for sector etf instrument.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"valid_from","displayName":"valid from","clickhouseType":"DateTime64(6, 'UTC')","jsonType":"string","nullable":false,"description":"Source-normalized field: valid from.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date-time","returned":true},{"position":8,"name":"valid_to","displayName":"valid to","clickhouseType":"Nullable(DateTime64(6, 'UTC'))","jsonType":"string","nullable":true,"description":"Source-normalized field: valid to.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date-time","returned":true},{"position":9,"name":"knowledge_available_at","displayName":"knowledge available at","clickhouseType":"DateTime64(6, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for knowledge available at.","descriptionSource":"name_derived","roles":["warehouse_primary_key"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":10,"name":"classification_as_of","displayName":"classification as of","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Source-normalized field: classification as of.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","returned":true},{"position":11,"name":"source_system","displayName":"source system","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: source system.","descriptionSource":"name_derived","roles":[],"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":["default_order","warehouse_primary_key","contract_unique_key","provenance"],"filterNames":[],"returned":true},{"position":13,"name":"raw_payload_sha256","displayName":"raw payload sha256","clickhouseType":"FixedString(64)","jsonType":"string","nullable":false,"description":"Source-normalized field: raw payload sha256.","descriptionSource":"name_derived","roles":[],"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":"mapping_contract_version","displayName":"mapping contract version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: mapping contract version.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"dataset_sha256","displayName":"dataset sha256","clickhouseType":"FixedString(64)","jsonType":"string","nullable":false,"description":"Source-normalized field: dataset sha256.","descriptionSource":"name_derived","roles":[],"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":"version","displayName":"version","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Monotonic row version used for correction-aware reads.","descriptionSource":"standard_glossary","roles":["default_order","warehouse_primary_key","contract_unique_key","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(6, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was first created.","descriptionSource":"standard_glossary","roles":["time"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","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":"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":"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}],"pit":null,"titleCn":"行业基准时点映射","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“行业基准时点映射”数据集；一行由 market、instrument_id、valid_from、source_record_id 定位，主要字段包括 record_id、sector、sector_etf_symbol、sector_etf_instrument_id、valid_to。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“行业基准时点映射”的一条记录；逻辑粒度由 market × instrument_id × valid_from × source_record_id × version 共同确定。","timeSemanticsCn":"以 created_at 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"market","meaningCn":"规范市场代码。"},{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"valid_from","meaningCn":"用于确定该表业务粒度或默认顺序的 valid from 字段。"},{"name":"source_record_id","meaningCn":"用于识别 source record 的业务标识。"},{"name":"version","meaningCn":"用于确定该表业务粒度或默认顺序的 version 字段。"}],"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":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":"ref.related_company_massive","namespace":"ref","name":"related_company_massive","coverageTags":["reference"],"description":"Canonical Friends financial dataset: Massive 关联公司.","relation":"ref.related_company_massive","objectKind":"table","rowMagnitude":"10K-99K","grain":"ticker × related_ticker","cadence":"weekly","timeColumn":"publish_ts","defaultOrder":["ticker","related_ticker","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","related_ticker","source"],"provenanceColumns":[],"fieldCount":21,"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":"related_ticker","displayName":"related ticker","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: related ticker.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"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":[],"filterNames":[],"returned":true},{"position":4,"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":5,"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":6,"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":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","contract_unique_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":["filter","provenance"],"filterNames":["provider"],"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":"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":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":"Massive 关联公司","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“Massive 关联公司”数据集；一行由 ticker、related_ticker、source 定位，主要字段包括 rank、publish_ts、source_ts、ingested_at、provider。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“Massive 关联公司”的一条记录；逻辑粒度由 ticker × related_ticker 共同确定。","timeSemanticsCn":"以 publish_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常每周随上游披露或批处理更新；不是实时数据。","keyFields":[{"name":"ticker","meaningCn":"来源或证券主表使用的股票代码。"},{"name":"related_ticker","meaningCn":"用于确定该表业务粒度或默认顺序的 related ticker 字段。"},{"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},"coverageDisclosure":{"coveredInstruments":1760,"universeInstruments":106795,"measuredOn":"2026-08-29","note":"Massive/Polygon related-company landing table, 1.6% of the universe. An empty result means this ticker has no peer list loaded, never that the company has no peers."},"returnedFieldCount":21,"costGuard":{"tier":"small","identityFilters":["ticker"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"DENIED","deniedSources":["massive"],"reasons":["restricted_license_scope","restricted_visibility_tier"]}},{"object":"dataset_schema","asset":"ref.sec_accession_period_end","namespace":"ref","name":"sec_accession_period_end","coverageTags":["reference"],"description":"Canonical Friends financial dataset: SEC 申报期末日映射.","relation":"ref.sec_accession_period_end","objectKind":"table","rowMagnitude":"100K-999K","grain":"accession_no","cadence":"event","timeColumn":"period_end","defaultOrder":["accession_no"],"filters":[{"name":"accession_no","column":"accession_no","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":["accession_no"],"provenanceColumns":[],"fieldCount":8,"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":"period_end","displayName":"period end","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Source-normalized field: period end.","descriptionSource":"name_derived","roles":["time"],"filterNames":[],"jsonFormat":"date","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","provenance"],"filterNames":["source"],"returned":true},{"position":4,"name":"user_agent","displayName":"user agent","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: user agent.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"raw_status","displayName":"raw status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: raw status.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"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":7,"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":8,"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":"SEC 申报期末日映射","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“SEC 申报期末日映射”数据集；一行由 accession_no 定位，主要字段包括 period_end、source、user_agent、raw_status、created_at。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“SEC 申报期末日映射”的一条记录；逻辑粒度由 accession_no 共同确定。","timeSemanticsCn":"以 period_end 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"accession_no","meaningCn":"SEC 对单次申报分配的唯一 accession 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":["accession_no"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"ref.sec_accession_subject_cik","namespace":"ref","name":"sec_accession_subject_cik","coverageTags":["reference"],"description":"Canonical Friends financial dataset: SEC 申报主体 CIK 映射.","relation":"ref.sec_accession_subject_cik","objectKind":"table","rowMagnitude":"<1K","grain":"accession_no × subject_cik","cadence":"event","timeColumn":"observed_at","defaultOrder":["accession_no"],"filters":[{"name":"accession_no","column":"accession_no","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"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":["accession_no"],"provenanceColumns":[],"fieldCount":8,"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":"subject_cik","displayName":"subject cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: subject cik.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["subject_cik"],"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","provenance"],"filterNames":["source"],"returned":true},{"position":4,"name":"observed_at","displayName":"observed at","clickhouseType":"DateTime64(3)","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":5,"name":"user_agent","displayName":"user agent","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: user agent.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"raw_status","displayName":"raw status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: raw status.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"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":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}],"pit":null,"titleCn":"SEC 申报主体 CIK 映射","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“SEC 申报主体 CIK 映射”数据集；一行由 accession_no 定位，主要字段包括 subject_cik、source、observed_at、user_agent、raw_status。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“SEC 申报主体 CIK 映射”的一条记录；逻辑粒度由 accession_no × subject_cik 共同确定。","timeSemanticsCn":"以 observed_at 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"accession_no","meaningCn":"SEC 对单次申报分配的唯一 accession number。"},{"name":"subject_cik","meaningCn":"用于确定该表业务粒度或默认顺序的 subject cik 字段。"}],"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":["accession_no"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"ref.sec_cik_primary_ticker","namespace":"ref","name":"sec_cik_primary_ticker","coverageTags":["reference"],"description":"Canonical Friends financial dataset: SEC CIK 主映射 股票代码.","relation":"ref.v_sec_cik_primary_ticker","objectKind":"view","rowMagnitude":"view","grain":"cik × instrument_id","cadence":"producer_schedule","timeColumn":null,"defaultOrder":["cik","instrument_id"],"filters":[{"name":"cik","column":"cik","required":false,"multipleValues":true,"jsonType":"string","example":"0000320193"},{"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":"ticker","column":"ticker","required":false,"multipleValues":true,"jsonType":"string","example":"AAPL"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"relation_default","contractVersion":null,"uniqueKey":["cik","instrument_id"],"provenanceColumns":[],"fieldCount":9,"fields":[{"position":1,"name":"cik","displayName":"cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC Central Index Key identifying the filer.","descriptionSource":"standard_glossary","roles":["filter","default_order","contract_unique_key"],"filterNames":["cik"],"returned":true},{"position":2,"name":"ticker","displayName":"ticker","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Ticker symbol reported by the source or mapped security master.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["ticker"],"returned":true},{"position":3,"name":"market","displayName":"market","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Canonical market or country-market code.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["market"],"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","default_order","contract_unique_key"],"filterNames":["instrument_id"],"returned":true},{"position":5,"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":6,"name":"mapping_status","displayName":"mapping status","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: mapping status.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"pit_status","displayName":"pit status","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: pit status.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"confidence","displayName":"confidence","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: confidence.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"primary_sec_rank","displayName":"primary sec rank","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Source-normalized field: primary sec rank.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true}],"pit":null,"titleCn":"SEC CIK 主映射 股票代码","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“SEC CIK 主映射 股票代码”数据集；一行由 cik、instrument_id 定位，主要字段包括 ticker、market、company_name、mapping_status、pit_status。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“SEC CIK 主映射 股票代码”的一条记录；逻辑粒度由 cik × instrument_id 共同确定。","timeSemanticsCn":"该表没有单一主时间列；请使用业务日期或版本字段，并按关键字段确定范围。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"cik","meaningCn":"SEC Central Index Key，用于识别申报主体。"},{"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":9,"costGuard":{"tier":"small","identityFilters":["cik","instrument_id","ticker"],"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":"ref.sec_cik_sic_pit","namespace":"ref","name":"sec_cik_sic_pit","coverageTags":["reference"],"description":"Canonical Friends financial dataset: SEC CIK SIC 时点.","relation":"ref.sec_cik_sic_pit","objectKind":"table","rowMagnitude":"100K-999K","grain":"cik × as_of_date × sic","cadence":"producer_schedule","timeColumn":"updated_at","defaultOrder":["cik","as_of_date","sic"],"filters":[{"name":"cik","column":"cik","required":false,"multipleValues":true,"jsonType":"string","example":"0000320193"},{"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":["cik","as_of_date","sic"],"provenanceColumns":[],"fieldCount":22,"fields":[{"position":1,"name":"cik","displayName":"cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC Central Index Key identifying the filer.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["cik"],"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":"sic","displayName":"sic","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: sic.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":4,"name":"sic_description","displayName":"sic description","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: sic description.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"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":6,"name":"tickers","displayName":"tickers","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: tickers.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"as_of_date","displayName":"as of date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for as of 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":"pit_quality","displayName":"pit quality","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: pit quality.","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":"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":["time"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"SEC CIK SIC 时点","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“SEC CIK SIC 时点”数据集；一行由 cik、as_of_date、sic 定位，主要字段包括 instrument_id、sic_description、company_name、tickers、pit_quality。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“SEC CIK SIC 时点”的一条记录；逻辑粒度由 cik × as_of_date × sic 共同确定。","timeSemanticsCn":"以 updated_at 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"cik","meaningCn":"SEC Central Index Key，用于识别申报主体。"},{"name":"as_of_date","meaningCn":"as of date 对应的日历日期。"},{"name":"sic","meaningCn":"用于确定该表业务粒度或默认顺序的 sic 字段。"}],"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":22,"costGuard":{"tier":"small","identityFilters":["cik","instrument_id"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"ref.sec_cik_ticker_mapping","namespace":"ref","name":"sec_cik_ticker_mapping","coverageTags":["reference"],"description":"Canonical Friends financial dataset: SEC CIK 股票代码 映射.","relation":"ref.sec_cik_ticker_mapping","objectKind":"table","rowMagnitude":"10K-99K","grain":"cik × ticker","cadence":"weekly","timeColumn":"observed_at","defaultOrder":["cik","ticker","market","evidence_type","source"],"filters":[{"name":"cik","column":"cik","required":false,"multipleValues":true,"jsonType":"string","example":"0000320193"},{"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":["cik","ticker","market","evidence_type","source"],"provenanceColumns":[],"fieldCount":31,"fields":[{"position":1,"name":"cik","displayName":"cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC Central Index Key identifying the filer.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["cik"],"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","contract_unique_key"],"filterNames":["ticker"],"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","contract_unique_key"],"filterNames":["market"],"returned":true},{"position":4,"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":5,"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":6,"name":"instrument_symbol","displayName":"instrument symbol","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: instrument symbol.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"instrument_name","displayName":"instrument name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: instrument name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"valid_from","displayName":"valid from","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Source-normalized field: valid from.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","returned":true},{"position":9,"name":"valid_to","displayName":"valid to","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Source-normalized field: valid to.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","returned":true},{"position":10,"name":"is_current","displayName":"is current","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Whether current applies to the row.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"pit_status","displayName":"pit status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: pit status.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"mapping_status","displayName":"mapping status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: mapping status.","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":"evidence_type","displayName":"evidence type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: evidence type.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":15,"name":"evidence_url","displayName":"evidence url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: evidence url.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"sec_rank","displayName":"sec rank","clickhouseType":"UInt32","jsonType":"integer","nullable":false,"description":"Source-normalized field: sec rank.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"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":18,"name":"source","displayName":"source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key","provenance"],"filterNames":["source"],"returned":true},{"position":19,"name":"provider","displayName":"provider","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Upstream data provider identifier.","descriptionSource":"standard_glossary","roles":["filter","provenance"],"filterNames":["provider"],"returned":true},{"position":20,"name":"source_url","displayName":"source url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"URL of the upstream evidence or record when distributable.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":21,"name":"source_record_id","displayName":"source record id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Provider-side identifier for the source record.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":22,"name":"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 CIK 股票代码 映射","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“SEC CIK 股票代码 映射”数据集；一行由 cik、ticker、market、evidence_type 定位，主要字段包括 instrument_id、company_name、instrument_symbol、instrument_name、valid_from。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“SEC CIK 股票代码 映射”的一条记录；逻辑粒度由 cik × ticker 共同确定。","timeSemanticsCn":"以 observed_at 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常每周随上游披露或批处理更新；不是实时数据。","keyFields":[{"name":"cik","meaningCn":"SEC Central Index Key，用于识别申报主体。"},{"name":"ticker","meaningCn":"来源或证券主表使用的股票代码。"},{"name":"market","meaningCn":"规范市场代码。"},{"name":"evidence_type","meaningCn":"用于确定该表业务粒度或默认顺序的 evidence type 字段。"},{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":["US"],"coverage":{"measured":true,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{"US":{"latestBusinessDate":"2026-08-26","rows":9818}},"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":31,"costGuard":{"tier":"small","identityFilters":["cik","instrument_id","ticker"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"ref.sector_classification_pit","namespace":"ref","name":"sector_classification_pit","coverageTags":["reference"],"description":"Canonical Friends financial dataset: 行业 分类 时点.","relation":"ref.sector_classification_pit","objectKind":"table","rowMagnitude":"100K-999K","grain":"instrument_id × as_of_date","cadence":"producer_schedule","timeColumn":"updated_at","defaultOrder":["instrument_id","as_of_date"],"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","as_of_date"],"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":"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":"sector","displayName":"sector","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: sector.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"industry","displayName":"industry","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: industry.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"sic4","displayName":"sic4","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: sic4.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"sector_src","displayName":"sector src","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: sector src.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"as_of_date","displayName":"as of date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for as of 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":"pit_quality","displayName":"pit quality","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: pit quality.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"source","displayName":"source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["filter","provenance"],"filterNames":["source"],"returned":true},{"position":11,"name":"provider","displayName":"provider","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Upstream data provider identifier.","descriptionSource":"standard_glossary","roles":["filter","provenance"],"filterNames":["provider"],"returned":true},{"position":12,"name":"source_url","displayName":"source url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"URL of the upstream evidence or record when distributable.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":13,"name":"source_record_id","displayName":"source record id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Provider-side identifier for the source record.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":14,"name":"raw_payload_hash","displayName":"raw payload hash","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Opaque fingerprint of the normalized source payload for provenance checks.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":15,"name":"parser_version","displayName":"parser version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Version of the parser or normalizer that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":16,"name":"quality_status","displayName":"quality status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Machine-readable data-quality classification.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":17,"name":"license_scope","displayName":"license scope","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"License or redistribution scope attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":18,"name":"visibility_tier","displayName":"visibility tier","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Serving visibility tier attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":19,"name":"ingest_run_id","displayName":"ingest run id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier of the ingestion run that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":20,"name":"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":["time"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"行业 分类 时点","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“行业 分类 时点”数据集；一行由 instrument_id、as_of_date 定位，主要字段包括 code、market、sector、industry、sic4。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“行业 分类 时点”的一条记录；逻辑粒度由 instrument_id × as_of_date 共同确定。","timeSemanticsCn":"以 updated_at 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"as_of_date","meaningCn":"as of date 对应的日历日期。"}],"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":25972}},"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":23,"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":"ref.sic4_sector_bucket","namespace":"ref","name":"sic4_sector_bucket","coverageTags":["reference"],"description":"Canonical Friends financial dataset: SIC4 行业分组.","relation":"ref.sic4_sector_bucket","objectKind":"table","rowMagnitude":"1K-9K","grain":"sic4","cadence":"producer_schedule","timeColumn":"updated_at","defaultOrder":["sic4"],"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":["sic4"],"provenanceColumns":[],"fieldCount":18,"fields":[{"position":1,"name":"sic4","displayName":"sic4","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: sic4.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":2,"name":"sic_division","displayName":"sic division","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: sic division.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":3,"name":"sector","displayName":"sector","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: sector.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":4,"name":"sector_etf","displayName":"sector etf","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: sector etf.","descriptionSource":"name_derived","roles":[],"filterNames":[],"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":"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":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":"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":10,"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":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":"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":13,"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":14,"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":15,"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":16,"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":17,"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":18,"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":"SIC4 行业分组","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“SIC4 行业分组”数据集；一行由 sic4 定位，主要字段包括 sic_division、sector、sector_etf、source、provider。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“SIC4 行业分组”的一条记录；逻辑粒度由 sic4 共同确定。","timeSemanticsCn":"以 updated_at 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"sic4","meaningCn":"用于确定该表业务粒度或默认顺序的 sic4 字段。"}],"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":18,"costGuard":{"tier":"small","identityFilters":[],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"ref.stock_float","namespace":"ref","name":"stock_float","coverageTags":["reference"],"description":"Canonical Friends financial dataset: 历史流通股本.","relation":"ref.stock_float","objectKind":"table","rowMagnitude":"100K-999K","grain":"ticker × effective_date × source","cadence":"weekly","timeColumn":"publish_ts","defaultOrder":["ticker","effective_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","effective_date","source"],"provenanceColumns":[],"fieldCount":25,"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":"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":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":3,"name":"free_float","displayName":"free float","clickhouseType":"Nullable(Int64)","jsonType":"integer","nullable":true,"description":"Source-normalized field: free float.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":4,"name":"free_float_percent","displayName":"free float percent","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: free float percent.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"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":6,"name":"restricted_shares","displayName":"restricted shares","clickhouseType":"Nullable(Int64)","jsonType":"integer","nullable":true,"description":"Quantity for restricted shares.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"report_period","displayName":"report period","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: report period.","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":["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},{"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、effective_date、source 定位，主要字段包括 free_float、free_float_percent、shares_outstanding、restricted_shares、report_period。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“历史流通股本”的一条记录；逻辑粒度由 ticker × effective_date × source 共同确定。","timeSemanticsCn":"以 publish_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常每周随上游披露或批处理更新；不是实时数据。","keyFields":[{"name":"ticker","meaningCn":"来源或证券主表使用的股票代码。"},{"name":"effective_date","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":25,"costGuard":{"tier":"small","identityFilters":["ticker"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"ref.symbol_change_history","namespace":"ref","name":"symbol_change_history","coverageTags":["reference"],"description":"Canonical Friends financial dataset: 交易代码 变更 历史.","relation":"ref.symbol_change_history","objectKind":"table","rowMagnitude":"1K-9K","grain":"instrument_id × change_date","cadence":"event","timeColumn":"publish_ts","defaultOrder":["instrument_id","change_date","source"],"filters":[{"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","change_date","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":"old_symbol","displayName":"old symbol","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: old symbol.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":3,"name":"new_symbol","displayName":"new symbol","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: new symbol.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":4,"name":"company_name","displayName":"company name","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: company name.","descriptionSource":"name_derived","roles":[],"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":"change_date","displayName":"change date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for change date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":7,"name":"change_reason","displayName":"change reason","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: change reason.","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":["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、change_date、source 定位，主要字段包括 old_symbol、new_symbol、company_name、market、change_reason。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“交易代码 变更 历史”的一条记录；逻辑粒度由 instrument_id × change_date 共同确定。","timeSemanticsCn":"以 publish_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由公告、新闻或业务事件触发更新，没有固定日历频率。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"change_date","meaningCn":"change 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":["US"],"coverage":{"measured":true,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{"US":{"latestBusinessDate":"2026-08-26","rows":1472}},"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":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":"ref.symbology_crosswalk","namespace":"ref","name":"symbology_crosswalk","coverageTags":["reference"],"description":"Canonical Friends financial dataset: 跨来源证券标识对照.","relation":"ref.symbology_crosswalk","objectKind":"table","rowMagnitude":"0","grain":"id_type × id_value × instrument_id × source × snapshot_date","cadence":"producer_schedule","timeColumn":"snapshot_ts","defaultOrder":["id_type","id_value","instrument_id","source","snapshot_date"],"filters":[{"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":"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":["id_type","id_value","instrument_id","source","snapshot_date"],"provenanceColumns":[],"fieldCount":24,"fields":[{"position":1,"name":"snapshot_ts","displayName":"snapshot ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for snapshot ts.","descriptionSource":"name_derived","roles":["time"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":2,"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":3,"name":"id_type","displayName":"id type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: id type.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":4,"name":"id_value","displayName":"id value","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: id value.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":5,"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":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":"exch_code","displayName":"exch code","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: exch code.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"valid_from","displayName":"valid from","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Source-normalized field: valid from.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","returned":true},{"position":9,"name":"match_confidence","displayName":"match confidence","clickhouseType":"Float32","jsonType":"number","nullable":false,"description":"Source-normalized field: match confidence.","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":["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_ts","displayName":"version ts","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"UTC timestamp associated with the row version.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"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":"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":"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":23,"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},{"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}],"pit":null,"titleCn":"跨来源证券标识对照","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“跨来源证券标识对照”数据集；一行由 id_type、id_value、instrument_id、source 定位，主要字段包括 snapshot_ts、snapshot_date、market、exch_code、valid_from。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“跨来源证券标识对照”的一条记录；逻辑粒度由 id_type × id_value × instrument_id × source × snapshot_date 共同确定。","timeSemanticsCn":"以 snapshot_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"id_type","meaningCn":"用于确定该表业务粒度或默认顺序的 id type 字段。"},{"name":"id_value","meaningCn":"用于确定该表业务粒度或默认顺序的 id value 字段。"},{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"},{"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":["字典采样时该关系可能为空；先查询 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":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":"ref.ust_bill_rate","namespace":"ref","name":"ust_bill_rate","coverageTags":["reference"],"description":"Canonical Friends financial dataset: 美国短期国债拍卖利率.","relation":"ref.ust_bill_rate","objectKind":"table","rowMagnitude":"1K-9K","grain":"cusip × auction_date","cadence":"daily","timeColumn":"updated_at","defaultOrder":["auction_date","tenor","cusip","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"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["auction_date","tenor","cusip","source"],"provenanceColumns":[],"fieldCount":22,"fields":[{"position":1,"name":"auction_date","displayName":"auction date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for auction date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":2,"name":"tenor","displayName":"tenor","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: tenor.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"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":"discount_rate","displayName":"discount rate","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"Source-normalized field: discount rate.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"coupon_equiv","displayName":"coupon equiv","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"Source-normalized field: coupon equiv.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"avg_discount","displayName":"avg discount","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: avg discount.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"avg_coupon","displayName":"avg coupon","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: avg coupon.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"maturity_date","displayName":"maturity date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for maturity date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","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":"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":"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":"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":22,"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":["time"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"美国短期国债拍卖利率","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“美国短期国债拍卖利率”数据集；一行由 auction_date、tenor、cusip、source 定位，主要字段包括 discount_rate、coupon_equiv、avg_discount、avg_coupon、maturity_date。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“美国短期国债拍卖利率”的一条记录；逻辑粒度由 cusip × auction_date 共同确定。","timeSemanticsCn":"以 updated_at 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"cusip","meaningCn":"用于确定该表业务粒度或默认顺序的 cusip 字段。"},{"name":"auction_date","meaningCn":"auction date 对应的日历日期。"},{"name":"tenor","meaningCn":"用于确定该表业务粒度或默认顺序的 tenor 字段。"},{"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":22,"costGuard":{"tier":"small","identityFilters":[],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"ref.ust_yield_curve","namespace":"ref","name":"ust_yield_curve","coverageTags":["reference"],"description":"Canonical Friends financial dataset: 美国国债收益率曲线.","relation":"ref.ust_yield_curve","objectKind":"table","rowMagnitude":"1K-9K","grain":"tenor × yield_date × rate_type × source","cadence":"daily","timeColumn":"updated_at","defaultOrder":["yield_date","tenor","rate_type","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"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["yield_date","tenor","rate_type","source"],"provenanceColumns":[],"fieldCount":19,"fields":[{"position":1,"name":"yield_date","displayName":"yield date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for yield date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":2,"name":"tenor","displayName":"tenor","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: tenor.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":3,"name":"rate_type","displayName":"rate type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: rate type.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":4,"name":"rate","displayName":"rate","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"Source-normalized field: rate.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"extrapolation_factor","displayName":"extrapolation factor","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: extrapolation factor.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"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":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":"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":10,"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":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":"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":13,"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":14,"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":15,"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":16,"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":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":"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":19,"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":["time"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"美国国债收益率曲线","summaryCn":"这是证券主数据、交易日历与跨来源映射中的“美国国债收益率曲线”数据集；一行由 yield_date、tenor、rate_type、source 定位，主要字段包括 rate、extrapolation_factor、provider、source_url、source_record_id。","useCasesCn":["解析证券与来源标识映射","为跨表查询补充分类和主数据"],"grainCn":"每行代表“美国国债收益率曲线”的一条记录；逻辑粒度由 tenor × yield_date × rate_type × source 共同确定。","timeSemanticsCn":"以 updated_at 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"tenor","meaningCn":"用于确定该表业务粒度或默认顺序的 tenor 字段。"},{"name":"yield_date","meaningCn":"yield date 对应的日历日期。"},{"name":"rate_type","meaningCn":"用于确定该表业务粒度或默认顺序的 rate 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":19,"costGuard":{"tier":"small","identityFilters":[],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"ref.zt_pool","namespace":"ref","name":"zt_pool","coverageTags":["reference"],"description":"A-share limit-up pool membership.","relation":"ref.zt_pool","objectKind":"table","rowMagnitude":"10K-99K","grain":"trade_date × pool_type × code × market","cadence":"daily","timeColumn":"trade_date","defaultOrder":["trade_date","code","market"],"filters":[{"name":"code","column":"code","required":false,"multipleValues":true,"jsonType":"string","example":"NNNNNN.SH or NNNNNN.SZ","exampleSource":"identifier_format"},{"name":"market","column":"market","required":false,"multipleValues":true,"jsonType":"string","example":"CN","exampleSource":"observed_coverage","allowedValues":["CN"]},{"name":"pool_type","column":"pool_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":19,"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","default_order","warehouse_primary_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":2,"name":"code","displayName":"code","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized security or contract code.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["code"],"returned":true},{"position":3,"name":"market","displayName":"market","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Canonical market or country-market code.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["market"],"returned":true},{"position":4,"name":"source","displayName":"source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["filter","warehouse_primary_key","provenance"],"filterNames":["source"],"returned":true},{"position":5,"name":"pool_type","displayName":"pool type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: pool type.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["pool_type"],"returned":true},{"position":6,"name":"reason","displayName":"reason","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: reason.","descriptionSource":"name_derived","roles":[],"filterNames":[],"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":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"A 股涨停池","summaryCn":"按证券、交易日和池类型记录涨停相关名单，支持研究涨停、连板和强势股结构。","useCasesCn":["查询每日涨停股票","统计连板或池类型","研究涨停后续表现"],"grainCn":"每行代表“A 股涨停池”的一条记录；逻辑粒度由 trade_date × pool_type × code × market 共同确定。","timeSemanticsCn":"以 trade_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"trade_date","meaningCn":"对应市场日历中的交易日。"},{"name":"pool_type","meaningCn":"用于确定该表业务粒度或默认顺序的 pool type 字段。"},{"name":"code","meaningCn":"来源规范化后的证券、合约或指标代码。"},{"name":"market","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 行，该表不提供稳定 cursor，结果过大时必须缩小标的、日期或其他筛选。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":["CN"],"coverage":{"measured":true,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{"CN":{"latestBusinessDate":"2026-08-26","rows":2395}},"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":19,"costGuard":{"tier":"small","identityFilters":["code"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}}]}