{"$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":"fundamental","description":"财务报表、指标、盈利日历与历史市值。","datasetCount":28,"fieldCount":897,"datasets":[{"object":"dataset_schema","asset":"fundamental.analyst_estimate","namespace":"fundamental","name":"analyst_estimate","coverageTags":["fundamentals"],"description":"Canonical Friends financial dataset: 分析师一致预期长表.","relation":"fundamental.analyst_estimate","objectKind":"table","rowMagnitude":"1M-9M","grain":"instrument_id × metric × estimate_date × period_end_date × source","cadence":"weekly","timeColumn":"estimate_date","defaultOrder":["instrument_id","estimate_date","period_end_date","metric","source"],"filters":[{"name":"code","column":"code","required":false,"multipleValues":true,"jsonType":"string","example":"TICKER","exampleSource":"identifier_format"},{"name":"instrument_id","column":"instrument_id","required":false,"multipleValues":true,"jsonType":"integer","example":1},{"name":"market","column":"market","required":false,"multipleValues":true,"jsonType":"string","example":"US","exampleSource":"observed_coverage","allowedValues":["US"]},{"name":"metric","column":"metric","required":false,"multipleValues":true,"jsonType":"string","example":"METRIC_VALUE"},{"name":"period_type","column":"period_type","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"provider","column":"provider","required":false,"multipleValues":true,"jsonType":"string","example":"PROVIDER_VALUE"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["instrument_id","estimate_date","period_end_date","metric","source"],"provenanceColumns":[],"fieldCount":30,"fields":[{"position":1,"name":"instrument_id","displayName":"instrument id","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"WarrenHub canonical instrument identifier; use it for cross-dataset joins.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["instrument_id"],"returned":true},{"position":2,"name":"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":"estimate_date","displayName":"estimate date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for estimate date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["time","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":5,"name":"period_end_date","displayName":"period end date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for period end 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":"period_type","displayName":"period type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Reporting-period classification such as annual or quarterly.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["period_type"],"returned":true},{"position":7,"name":"metric","displayName":"metric","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Machine-readable metric name.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["metric"],"returned":true},{"position":8,"name":"consensus_value","displayName":"consensus value","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: consensus value.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"high_value","displayName":"high value","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: high value.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"low_value","displayName":"low value","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: low value.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"median_value","displayName":"median value","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: median value.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"analyst_count","displayName":"analyst count","clickhouseType":"Nullable(UInt32)","jsonType":"integer","nullable":true,"description":"Count of analyst count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"standard_deviation","displayName":"standard deviation","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: standard deviation.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"surprise_pct","displayName":"surprise pct","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Percentage value for surprise pct.","descriptionSource":"name_derived","roles":[],"filterNames":[],"unit":"percent","returned":true},{"position":15,"name":"publish_ts","displayName":"publish ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC point-in-time availability timestamp used by PIT reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":16,"name":"source_ts","displayName":"source ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"Timestamp asserted by the upstream source.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":17,"name":"ingested_at","displayName":"ingested at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the source record entered the warehouse.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":18,"name":"source","displayName":"source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key","provenance"],"filterNames":["source"],"returned":true},{"position":19,"name":"provider","displayName":"provider","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Upstream data provider identifier.","descriptionSource":"standard_glossary","roles":["filter","provenance"],"filterNames":["provider"],"returned":true},{"position":20,"name":"source_url","displayName":"source url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"URL of the upstream evidence or record when distributable.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":21,"name":"source_record_id","displayName":"source record id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Provider-side identifier for the source record.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":22,"name":"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":"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":30,"name":"is_deleted","displayName":"is deleted","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Soft-delete marker; public serving excludes current tombstones.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true}],"pit":null,"titleCn":"分析师一致预期长表","summaryCn":"这是财务报表、估值与分析师预期中的“分析师一致预期长表”数据集；一行由 instrument_id、estimate_date、period_end_date、metric 定位，主要字段包括 code、market、period_type、consensus_value、high_value。","useCasesCn":["比较公司财务与分析师预期","构建基本面筛选和历史回测输入"],"grainCn":"每行代表“分析师一致预期长表”的一条记录；逻辑粒度由 instrument_id × metric × estimate_date × period_end_date × source 共同确定。","timeSemanticsCn":"以 estimate_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常每周随上游披露或批处理更新；不是实时数据。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"metric","meaningCn":"长表中的机器可读指标名。"},{"name":"estimate_date","meaningCn":"estimate date 对应的日历日期。"},{"name":"period_end_date","meaningCn":"period end 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-24","rows":753762}},"latestBusinessDate":"2026-08-24","note":"Recent observed coverage, not a lifetime guarantee. An unmeasured dataset carries no support claim in either direction."},"identifier":{"namespace":"us_ticker","formatByMarket":{"US":"TICKER"},"storesZeroPaddedHkCode":false,"stableJoinKey":"instrument_id","resolverPath":"/api/v1/data/instruments/resolve"},"sparseSemantics":null,"emptyResultCodes":["VALID_EMPTY","NOT_IN_RANKING","UNSUPPORTED_MARKET","STALE_SOURCE","NO_MATCH","IDENTIFIER_INVALID","COVERAGE_UNKNOWN","PARTIAL_UNIVERSE"],"publication":{"published":true,"reason":null,"projectionReviewed":true},"returnedFieldCount":30,"costGuard":{"tier":"small","identityFilters":["code","instrument_id","metric"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"fundamental.analyst_estimate_revision","namespace":"fundamental","name":"analyst_estimate_revision","coverageTags":["fundamentals"],"description":"Canonical Friends financial dataset: 分析师预期修订.","relation":"fundamental.analyst_estimate_revision","objectKind":"view","rowMagnitude":"view","grain":"instrument_id × estimate_date","cadence":"daily","timeColumn":"estimate_date","defaultOrder":["instrument_id","period_end_date","estimate_date","source_record_id"],"filters":[{"name":"code","column":"code","required":false,"multipleValues":true,"jsonType":"string","example":"TICKER","exampleSource":"identifier_format"},{"name":"instrument_id","column":"instrument_id","required":false,"multipleValues":true,"jsonType":"integer","example":1},{"name":"market","column":"market","required":false,"multipleValues":true,"jsonType":"string","example":"US","exampleSource":"observed_coverage","allowedValues":["US"]},{"name":"period","column":"period","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"provider","column":"provider","required":false,"multipleValues":true,"jsonType":"string","example":"PROVIDER_VALUE"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"relation_default","contractVersion":null,"uniqueKey":["instrument_id","period_end_date","estimate_date","source_record_id"],"provenanceColumns":[],"fieldCount":43,"fields":[{"position":1,"name":"instrument_id","displayName":"instrument id","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"WarrenHub canonical instrument identifier; use it for cross-dataset joins.","descriptionSource":"standard_glossary","roles":["filter","default_order","contract_unique_key"],"filterNames":["instrument_id"],"returned":true},{"position":2,"name":"code","displayName":"code","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized security or contract code.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["code"],"returned":true},{"position":3,"name":"market","displayName":"market","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Canonical market or country-market code.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["market"],"returned":true},{"position":4,"name":"period_end_date","displayName":"period end date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for period end date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["default_order","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":5,"name":"estimate_date","displayName":"estimate date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for estimate date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["time","default_order","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":6,"name":"period","displayName":"period","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Reporting or observation period label.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["period"],"returned":true},{"position":7,"name":"growth","displayName":"growth","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: growth.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"earnings_estimate_avg","displayName":"earnings estimate avg","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: earnings estimate avg.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"earnings_estimate_low","displayName":"earnings estimate low","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: earnings estimate low.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"earnings_estimate_high","displayName":"earnings estimate high","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: earnings estimate high.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"earnings_estimate_year_ago","displayName":"earnings estimate year ago","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: earnings estimate year ago.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"earnings_estimate_count","displayName":"earnings estimate count","clickhouseType":"Nullable(UInt32)","jsonType":"integer","nullable":true,"description":"Count of earnings estimate count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"revenue_estimate_avg","displayName":"revenue estimate avg","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: revenue estimate avg.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"revenue_estimate_low","displayName":"revenue estimate low","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: revenue estimate low.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"revenue_estimate_high","displayName":"revenue estimate high","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: revenue estimate high.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"revenue_estimate_year_ago","displayName":"revenue estimate year ago","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: revenue estimate year ago.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"name":"revenue_estimate_count","displayName":"revenue estimate count","clickhouseType":"Nullable(UInt32)","jsonType":"integer","nullable":true,"description":"Count of revenue estimate count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":18,"name":"eps_trend_current","displayName":"eps trend current","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: eps trend current.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":19,"name":"eps_trend_7days_ago","displayName":"eps trend 7days ago","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: eps trend 7days ago.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":20,"name":"eps_trend_30days_ago","displayName":"eps trend 30days ago","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: eps trend 30days ago.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":21,"name":"eps_trend_60days_ago","displayName":"eps trend 60days ago","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: eps trend 60days ago.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":22,"name":"eps_trend_90days_ago","displayName":"eps trend 90days ago","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: eps trend 90days ago.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":23,"name":"eps_revisions_up_last7d","displayName":"eps revisions up last7d","clickhouseType":"Nullable(Int32)","jsonType":"integer","nullable":true,"description":"Source-normalized field: eps revisions up last7d.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":24,"name":"eps_revisions_up_last30d","displayName":"eps revisions up last30d","clickhouseType":"Nullable(Int32)","jsonType":"integer","nullable":true,"description":"Source-normalized field: eps revisions up last30d.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":25,"name":"eps_revisions_down_last30d","displayName":"eps revisions down last30d","clickhouseType":"Nullable(Int32)","jsonType":"integer","nullable":true,"description":"Source-normalized field: eps revisions down last30d.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":26,"name":"publish_ts","displayName":"publish ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC point-in-time availability timestamp used by PIT reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":27,"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":28,"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":29,"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":30,"name":"provider","displayName":"provider","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Upstream data provider identifier.","descriptionSource":"standard_glossary","roles":["filter","provenance"],"filterNames":["provider"],"returned":true},{"position":31,"name":"source_url","displayName":"source url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"URL of the upstream evidence or record when distributable.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":32,"name":"source_record_id","displayName":"source record id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Provider-side identifier for the source record.","descriptionSource":"standard_glossary","roles":["default_order","contract_unique_key","provenance"],"filterNames":[],"returned":true},{"position":33,"name":"raw_payload_hash","displayName":"raw payload hash","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Opaque fingerprint of the normalized source payload for provenance checks.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":34,"name":"parser_version","displayName":"parser version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Version of the parser or normalizer that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":35,"name":"quality_status","displayName":"quality status","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Machine-readable data-quality classification.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":36,"name":"license_scope","displayName":"license scope","clickhouseType":"String","jsonType":"string","nullable":false,"description":"License or redistribution scope attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":37,"name":"visibility_tier","displayName":"visibility tier","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Serving visibility tier attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":38,"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":39,"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":40,"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":41,"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":42,"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":43,"name":"updated_at","displayName":"updated at","clickhouseType":"DateTime","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was last updated.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"分析师预期修订","summaryCn":"这是财务报表、估值与分析师预期中的“分析师预期修订”数据集；一行由 instrument_id、period_end_date、estimate_date、source_record_id 定位，主要字段包括 code、market、period、growth、earnings_estimate_avg。","useCasesCn":["比较公司财务与分析师预期","构建基本面筛选和历史回测输入"],"grainCn":"每行代表“分析师预期修订”的一条记录；逻辑粒度由 instrument_id × estimate_date 共同确定。","timeSemanticsCn":"以 estimate_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"estimate_date","meaningCn":"estimate date 对应的日历日期。"},{"name":"period_end_date","meaningCn":"period end date 对应的日历日期。"},{"name":"source_record_id","meaningCn":"用于识别 source record 的业务标识。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":["US"],"coverage":{"measured":true,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{"US":{"latestBusinessDate":"2026-08-26","rows":4382338}},"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":43,"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":"fundamental.analyst_trend_pit","namespace":"fundamental","name":"analyst_trend_pit","coverageTags":["fundamentals"],"description":"Canonical Friends financial dataset: 分析师预期时点趋势.","relation":"fundamental.analyst_trend_pit","objectKind":"table","rowMagnitude":"10M-99M","grain":"instrument_id × snapshot_date","cadence":"daily","timeColumn":"snapshot_ts","defaultOrder":["instrument_id","period","period_end_date","snapshot_date"],"filters":[{"name":"code","column":"code","required":false,"multipleValues":true,"jsonType":"string","example":"TICKER","exampleSource":"identifier_format"},{"name":"instrument_id","column":"instrument_id","required":true,"multipleValues":true,"jsonType":"integer","example":1},{"name":"market","column":"market","required":false,"multipleValues":true,"jsonType":"string","example":"US","exampleSource":"observed_coverage","allowedValues":["US"]},{"name":"period","column":"period","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"provider","column":"provider","required":false,"multipleValues":true,"jsonType":"string","example":"PROVIDER_VALUE"},{"name":"snapshot_date","column":"snapshot_date","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"}],"maxLimit":5000,"maxWindowDays":400,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["instrument_id","period","period_end_date","snapshot_date"],"provenanceColumns":[],"fieldCount":37,"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","required_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":"code","displayName":"code","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized security or contract code.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["code"],"returned":true},{"position":6,"name":"market","displayName":"market","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Canonical market or country-market code.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["market"],"returned":true},{"position":7,"name":"period","displayName":"period","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Reporting or observation period label.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["period"],"returned":true},{"position":8,"name":"period_end_date","displayName":"period end date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for period end 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":"growth","displayName":"growth","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: growth.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"earnings_estimate_avg","displayName":"earnings estimate avg","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: earnings estimate avg.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"earnings_estimate_low","displayName":"earnings estimate low","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: earnings estimate low.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"earnings_estimate_high","displayName":"earnings estimate high","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: earnings estimate high.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"earnings_estimate_year_ago","displayName":"earnings estimate year ago","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: earnings estimate year ago.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"earnings_estimate_number_of_analysts","displayName":"earnings estimate number of analysts","clickhouseType":"Nullable(UInt32)","jsonType":"integer","nullable":true,"description":"Source-normalized field: earnings estimate number of analysts.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"revenue_estimate_avg","displayName":"revenue estimate avg","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: revenue estimate avg.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"revenue_estimate_low","displayName":"revenue estimate low","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: revenue estimate low.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"name":"revenue_estimate_high","displayName":"revenue estimate high","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: revenue estimate high.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":18,"name":"revenue_estimate_year_ago","displayName":"revenue estimate year ago","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: revenue estimate year ago.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":19,"name":"revenue_estimate_number_of_analysts","displayName":"revenue estimate number of analysts","clickhouseType":"Nullable(UInt32)","jsonType":"integer","nullable":true,"description":"Source-normalized field: revenue estimate number of analysts.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":20,"name":"eps_trend_current","displayName":"eps trend current","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: eps trend current.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":21,"name":"eps_trend_7days_ago","displayName":"eps trend 7days ago","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: eps trend 7days ago.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":22,"name":"eps_trend_30days_ago","displayName":"eps trend 30days ago","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: eps trend 30days ago.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":23,"name":"eps_trend_60days_ago","displayName":"eps trend 60days ago","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: eps trend 60days ago.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":24,"name":"eps_trend_90days_ago","displayName":"eps trend 90days ago","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: eps trend 90days ago.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":25,"name":"eps_revisions_up_last7d","displayName":"eps revisions up last7d","clickhouseType":"Nullable(Int32)","jsonType":"integer","nullable":true,"description":"Source-normalized field: eps revisions up last7d.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":26,"name":"eps_revisions_up_last30d","displayName":"eps revisions up last30d","clickhouseType":"Nullable(Int32)","jsonType":"integer","nullable":true,"description":"Source-normalized field: eps revisions up last30d.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":27,"name":"eps_revisions_down_last7d","displayName":"eps revisions down last7d","clickhouseType":"Nullable(Int32)","jsonType":"integer","nullable":true,"description":"Source-normalized field: eps revisions down last7d.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":28,"name":"eps_revisions_down_last30d","displayName":"eps revisions down last30d","clickhouseType":"Nullable(Int32)","jsonType":"integer","nullable":true,"description":"Source-normalized field: eps revisions down last30d.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":29,"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":30,"name":"provider","displayName":"provider","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Upstream data provider identifier.","descriptionSource":"standard_glossary","roles":["filter","provenance"],"filterNames":["provider"],"returned":true},{"position":31,"name":"parser_version","displayName":"parser version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Version of the parser or normalizer that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":32,"name":"raw_payload_hash","displayName":"raw payload hash","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Opaque fingerprint of the normalized source payload for provenance checks.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":33,"name":"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":34,"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":35,"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":36,"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":37,"name":"updated_at","displayName":"updated at","clickhouseType":"DateTime","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was last updated.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"分析师预期时点趋势","summaryCn":"这是财务报表、估值与分析师预期中的“分析师预期时点趋势”数据集；一行由 instrument_id、period、period_end_date、snapshot_date 定位，主要字段包括 snapshot_ts、symbol_raw、code、market、growth。","useCasesCn":["比较公司财务与分析师预期","构建基本面筛选和历史回测输入"],"grainCn":"每行代表“分析师预期时点趋势”的一条记录；逻辑粒度由 instrument_id × snapshot_date 共同确定。","timeSemanticsCn":"以 snapshot_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"snapshot_date","meaningCn":"snapshot date 对应的日历日期。"},{"name":"period","meaningCn":"财务或统计所属期间。"},{"name":"period_end_date","meaningCn":"period end date 对应的日历日期。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；必须提供 instrument_id；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["该关系数据量较大，必须提供 instrument_id；这只限制单次扫描，不减少可访问历史。","单次请求的 start/end 最长 400 天；全历史请按时间窗连续分页。"],"supportedMarkets":["US"],"coverage":{"measured":true,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{"US":{"latestBusinessDate":"2026-08-26","rows":4382338}},"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":37,"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":"fundamental.balance_sheet","namespace":"fundamental","name":"balance_sheet","coverageTags":["fundamentals"],"description":"Balance-sheet fundamentals.","relation":"fundamental.balance_sheet","objectKind":"table","rowMagnitude":"100K-999K","grain":"instrument_id × report_date × period","cadence":"weekly","timeColumn":"report_date","defaultOrder":["report_date","code","period"],"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":"period","column":"period","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":false,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":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","warehouse_primary_key"],"filterNames":["market"],"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":[],"filterNames":[],"returned":true},{"position":4,"name":"report_date","displayName":"report date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Reporting-period or statement date.","descriptionSource":"standard_glossary","roles":["time","default_order","warehouse_primary_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":5,"name":"period","displayName":"period","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Reporting or observation period label.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["period"],"returned":true},{"position":6,"name":"ann_date","displayName":"ann date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Announcement date.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","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","warehouse_primary_key","provenance"],"filterNames":["source"],"returned":true},{"position":8,"name":"publish_ts","displayName":"publish ts","clickhouseType":"Nullable(DateTime64(3, 'UTC'))","jsonType":"string","nullable":true,"description":"UTC point-in-time availability timestamp used by PIT reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":9,"name":"source_ts","displayName":"source ts","clickhouseType":"Nullable(DateTime64(3, 'UTC'))","jsonType":"string","nullable":true,"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":"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":12,"name":"total_assets","displayName":"total assets","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total assets.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"total_liab","displayName":"total liab","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total liab.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"total_equity","displayName":"total equity","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total equity.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"money_cap","displayName":"money cap","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: money cap.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"accounts_receiv","displayName":"accounts receiv","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: accounts receiv.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"name":"inventories","displayName":"inventories","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: inventories.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":18,"name":"fix_assets","displayName":"fix assets","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: fix assets.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":19,"name":"intan_assets","displayName":"intan assets","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: intan assets.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":20,"name":"goodwill","displayName":"goodwill","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: goodwill.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":21,"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":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},{"position":34,"name":"publish_ts_source","displayName":"publish ts source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: publish ts source.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":35,"name":"filing_date","displayName":"filing date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Date on which the filing was submitted or published.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true}],"pit":{"supported":true,"asOfRequired":true,"timeColumn":"report_date","keyColumns":["instrument_id","report_date","period","source"],"maxLimit":1000,"maxWindowDays":400},"titleCn":"资产负债表","summaryCn":"按证券、报告期和期间保存资产、负债与权益科目，是公司偿债能力和资本结构研究的基础表。","useCasesCn":["分析资产负债结构","计算流动性与杠杆指标","做跨期或同行比较"],"grainCn":"每行代表“资产负债表”的一条记录；逻辑粒度由 instrument_id × report_date × period 共同确定。","timeSemanticsCn":"以 report_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常每周随上游披露或批处理更新；不是实时数据。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"report_date","meaningCn":"财务、持仓或统计报告所属日期。"},{"name":"period","meaningCn":"财务或统计所属期间。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 cursor，结果过大时必须缩小标的、日期或其他筛选。","caveatsCn":["做历史回测时优先使用 PIT 端点并传 as_of，避免把后来披露的数据带回过去。"],"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":35,"costGuard":{"tier":"medium","identityFilters":["code"],"maxWindowDays":400,"requirement":"identity filter or bounded window","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"fundamental.balance_sheet_massive","namespace":"fundamental","name":"balance_sheet_massive","coverageTags":["fundamentals"],"description":"Canonical Friends financial dataset: Massive 资产负债表.","relation":"fundamental.balance_sheet_massive","objectKind":"table","rowMagnitude":"100K-999K","grain":"cik × period_end × timeframe","cadence":"weekly","timeColumn":"filing_date","defaultOrder":["ticker","period_end","timeframe","fiscal_quarter","source"],"filters":[{"name":"cik","column":"cik","required":false,"multipleValues":true,"jsonType":"string","example":"0000320193"},{"name":"fiscal_quarter","column":"fiscal_quarter","required":false,"multipleValues":true,"jsonType":"integer","example":"FILTER_VALUE"},{"name":"fiscal_year","column":"fiscal_year","required":false,"multipleValues":true,"jsonType":"integer","example":"FILTER_VALUE"},{"name":"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","period_end","timeframe","fiscal_quarter","source"],"provenanceColumns":[],"fieldCount":51,"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":"cik","displayName":"cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC Central Index Key identifying the filer.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["cik"],"returned":true},{"position":3,"name":"period_end","displayName":"period end","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Source-normalized field: period end.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","returned":true},{"position":4,"name":"filing_date","displayName":"filing date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Date on which the filing was submitted or published.","descriptionSource":"standard_glossary","roles":["time"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":5,"name":"fiscal_quarter","displayName":"fiscal quarter","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: fiscal quarter.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["fiscal_quarter"],"returned":true},{"position":6,"name":"fiscal_year","displayName":"fiscal year","clickhouseType":"Nullable(UInt16)","jsonType":"integer","nullable":true,"description":"Source-normalized field: fiscal year.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["fiscal_year"],"returned":true},{"position":7,"name":"timeframe","displayName":"timeframe","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: timeframe.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":8,"name":"cash_and_equivalents","displayName":"cash and equivalents","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: cash and equivalents.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"short_term_investments","displayName":"short term investments","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: short term investments.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"receivables","displayName":"receivables","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: receivables.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"inventories","displayName":"inventories","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: inventories.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"other_current_assets","displayName":"other current assets","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: other current assets.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"total_current_assets","displayName":"total current assets","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total current assets.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"property_plant_equipment_net","displayName":"property plant equipment net","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: property plant equipment net.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"goodwill","displayName":"goodwill","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: goodwill.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"intangible_assets_net","displayName":"intangible assets net","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: intangible assets net.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"name":"other_assets","displayName":"other assets","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: other assets.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":18,"name":"total_assets","displayName":"total assets","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total assets.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":19,"name":"accounts_payable","displayName":"accounts payable","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: accounts payable.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":20,"name":"deferred_revenue_current","displayName":"deferred revenue current","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: deferred revenue current.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":21,"name":"accrued_and_other_current_liabilities","displayName":"accrued and other current liabilities","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: accrued and other current liabilities.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":22,"name":"total_current_liabilities","displayName":"total current liabilities","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total current liabilities.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":23,"name":"long_term_debt","displayName":"long term debt","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: long term debt.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":24,"name":"other_noncurrent_liabilities","displayName":"other noncurrent liabilities","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: other noncurrent liabilities.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":25,"name":"total_liabilities","displayName":"total liabilities","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total liabilities.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":26,"name":"common_stock","displayName":"common stock","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: common stock.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":27,"name":"accumulated_other_comprehensive_income","displayName":"accumulated other comprehensive income","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: accumulated other comprehensive income.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":28,"name":"retained_earnings_deficit","displayName":"retained earnings deficit","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: retained earnings deficit.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":29,"name":"other_equity","displayName":"other equity","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: other equity.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":30,"name":"total_equity_attributable_to_parent","displayName":"total equity attributable to parent","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total equity attributable to parent.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":31,"name":"total_equity","displayName":"total equity","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total equity.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":32,"name":"total_liabilities_and_equity","displayName":"total liabilities and equity","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total liabilities and equity.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":33,"name":"extra_json","displayName":"extra json","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: extra json.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":34,"name":"publish_ts","displayName":"publish ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC point-in-time availability timestamp used by PIT reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":35,"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":36,"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":37,"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":38,"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":39,"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":40,"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":41,"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":42,"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":43,"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":44,"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":45,"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":46,"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":47,"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":48,"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":49,"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":50,"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":51,"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、period_end、timeframe、fiscal_quarter 定位，主要字段包括 cik、filing_date、fiscal_year、cash_and_equivalents、short_term_investments。","useCasesCn":["比较公司财务与分析师预期","构建基本面筛选和历史回测输入"],"grainCn":"每行代表“Massive 资产负债表”的一条记录；逻辑粒度由 cik × period_end × timeframe 共同确定。","timeSemanticsCn":"以 filing_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常每周随上游披露或批处理更新；不是实时数据。","keyFields":[{"name":"cik","meaningCn":"SEC Central Index Key，用于识别申报主体。"},{"name":"period_end","meaningCn":"用于确定该表业务粒度或默认顺序的 period end 字段。"},{"name":"timeframe","meaningCn":"用于确定该表业务粒度或默认顺序的 timeframe 字段。"},{"name":"ticker","meaningCn":"来源或证券主表使用的股票代码。"},{"name":"fiscal_quarter","meaningCn":"用于确定该表业务粒度或默认顺序的 fiscal quarter 字段。"},{"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":51,"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":"fundamental.cash_flow_massive","namespace":"fundamental","name":"cash_flow_massive","coverageTags":["fundamentals"],"description":"Canonical Friends financial dataset: Massive 现金流量表.","relation":"fundamental.cash_flow_massive","objectKind":"table","rowMagnitude":"100K-999K","grain":"cik × period_end × timeframe","cadence":"weekly","timeColumn":"filing_date","defaultOrder":["ticker","period_end","timeframe","fiscal_quarter","source"],"filters":[{"name":"cik","column":"cik","required":false,"multipleValues":true,"jsonType":"string","example":"0000320193"},{"name":"fiscal_quarter","column":"fiscal_quarter","required":false,"multipleValues":true,"jsonType":"integer","example":"FILTER_VALUE"},{"name":"fiscal_year","column":"fiscal_year","required":false,"multipleValues":true,"jsonType":"integer","example":"FILTER_VALUE"},{"name":"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","period_end","timeframe","fiscal_quarter","source"],"provenanceColumns":[],"fieldCount":44,"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":"cik","displayName":"cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC Central Index Key identifying the filer.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["cik"],"returned":true},{"position":3,"name":"period_end","displayName":"period end","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Source-normalized field: period end.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","returned":true},{"position":4,"name":"filing_date","displayName":"filing date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Date on which the filing was submitted or published.","descriptionSource":"standard_glossary","roles":["time"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":5,"name":"fiscal_quarter","displayName":"fiscal quarter","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: fiscal quarter.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["fiscal_quarter"],"returned":true},{"position":6,"name":"fiscal_year","displayName":"fiscal year","clickhouseType":"Nullable(UInt16)","jsonType":"integer","nullable":true,"description":"Source-normalized field: fiscal year.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["fiscal_year"],"returned":true},{"position":7,"name":"timeframe","displayName":"timeframe","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: timeframe.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":8,"name":"net_income","displayName":"net income","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: net income.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"depreciation_depletion_and_amortization","displayName":"depreciation depletion and amortization","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: depreciation depletion and amortization.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"other_operating_activities","displayName":"other operating activities","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: other operating activities.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"change_in_other_operating_assets_and_liabilities_net","displayName":"change in other operating assets and liabilities net","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: change in other operating assets and liabilities net.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"cash_from_operating_activities_continuing_operations","displayName":"cash from operating activities continuing operations","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: cash from operating activities continuing operations.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"net_cash_from_operating_activities","displayName":"net cash from operating activities","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: net cash from operating activities.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"purchase_of_property_plant_and_equipment","displayName":"purchase of property plant and equipment","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: purchase of property plant and equipment.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"other_investing_activities","displayName":"other investing activities","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: other investing activities.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"net_cash_from_investing_activities_continuing_operations","displayName":"net cash from investing activities continuing operations","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: net cash from investing activities continuing operations.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"name":"net_cash_from_investing_activities","displayName":"net cash from investing activities","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: net cash from investing activities.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":18,"name":"long_term_debt_issuances_repayments","displayName":"long term debt issuances repayments","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: long term debt issuances repayments.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":19,"name":"dividends","displayName":"dividends","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: dividends.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":20,"name":"other_financing_activities","displayName":"other financing activities","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: other financing activities.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":21,"name":"net_cash_from_financing_activities_continuing_operations","displayName":"net cash from financing activities continuing operations","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: net cash from financing activities continuing operations.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":22,"name":"net_cash_from_financing_activities","displayName":"net cash from financing activities","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: net cash from financing activities.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":23,"name":"change_in_cash_and_equivalents","displayName":"change in cash and equivalents","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: change in cash and equivalents.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":24,"name":"capex","displayName":"capex","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: capex.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":25,"name":"free_cash_flow","displayName":"free cash flow","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: free cash flow.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":26,"name":"extra_json","displayName":"extra json","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: extra json.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":27,"name":"publish_ts","displayName":"publish ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC point-in-time availability timestamp used by PIT reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":28,"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":29,"name":"ingested_at","displayName":"ingested at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the source record entered the warehouse.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":30,"name":"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":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":"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":34,"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":35,"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":36,"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":37,"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":38,"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":39,"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":40,"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":41,"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":42,"name":"is_deleted","displayName":"is deleted","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Soft-delete marker; public serving excludes current tombstones.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":43,"name":"created_at","displayName":"created at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was first created.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":44,"name":"updated_at","displayName":"updated at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was last updated.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"Massive 现金流量表","summaryCn":"这是财务报表、估值与分析师预期中的“Massive 现金流量表”数据集；一行由 ticker、period_end、timeframe、fiscal_quarter 定位，主要字段包括 cik、filing_date、fiscal_year、net_income、depreciation_depletion_and_amortization。","useCasesCn":["比较公司财务与分析师预期","构建基本面筛选和历史回测输入"],"grainCn":"每行代表“Massive 现金流量表”的一条记录；逻辑粒度由 cik × period_end × timeframe 共同确定。","timeSemanticsCn":"以 filing_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常每周随上游披露或批处理更新；不是实时数据。","keyFields":[{"name":"cik","meaningCn":"SEC Central Index Key，用于识别申报主体。"},{"name":"period_end","meaningCn":"用于确定该表业务粒度或默认顺序的 period end 字段。"},{"name":"timeframe","meaningCn":"用于确定该表业务粒度或默认顺序的 timeframe 字段。"},{"name":"ticker","meaningCn":"来源或证券主表使用的股票代码。"},{"name":"fiscal_quarter","meaningCn":"用于确定该表业务粒度或默认顺序的 fiscal quarter 字段。"},{"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":44,"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":"fundamental.cashflow","namespace":"fundamental","name":"cashflow","coverageTags":["fundamentals"],"description":"Cash-flow fundamentals.","relation":"fundamental.cashflow","objectKind":"table","rowMagnitude":"100K-999K","grain":"instrument_id × report_date × period","cadence":"weekly","timeColumn":"report_date","defaultOrder":["report_date","code","period"],"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":"period","column":"period","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":false,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":33,"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":"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":4,"name":"report_date","displayName":"report date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Reporting-period or statement date.","descriptionSource":"standard_glossary","roles":["time","default_order","warehouse_primary_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":5,"name":"period","displayName":"period","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Reporting or observation period label.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["period"],"returned":true},{"position":6,"name":"ann_date","displayName":"ann date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Announcement date.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","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","warehouse_primary_key","provenance"],"filterNames":["source"],"returned":true},{"position":8,"name":"publish_ts","displayName":"publish ts","clickhouseType":"Nullable(DateTime64(3, 'UTC'))","jsonType":"string","nullable":true,"description":"UTC point-in-time availability timestamp used by PIT reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":9,"name":"source_ts","displayName":"source ts","clickhouseType":"Nullable(DateTime64(3, 'UTC'))","jsonType":"string","nullable":true,"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":"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":12,"name":"net_oper_cf","displayName":"net oper cf","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: net oper cf.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"net_invest_cf","displayName":"net invest cf","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: net invest cf.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"net_fin_cf","displayName":"net fin cf","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: net fin cf.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"cash_end","displayName":"cash end","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: cash end.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"cash_begin","displayName":"cash begin","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: cash begin.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"name":"capex","displayName":"capex","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: capex.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":18,"name":"free_cashflow","displayName":"free cashflow","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: free cashflow.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":19,"name":"provider","displayName":"provider","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Upstream data provider identifier.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":20,"name":"source_url","displayName":"source url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"URL of the upstream evidence or record when distributable.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":21,"name":"source_record_id","displayName":"source record id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Provider-side identifier for the source record.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":22,"name":"raw_payload_hash","displayName":"raw payload hash","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Opaque fingerprint of the normalized source payload for provenance checks.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":23,"name":"parser_version","displayName":"parser version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Version of the parser or normalizer that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":24,"name":"quality_status","displayName":"quality status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Machine-readable data-quality classification.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":25,"name":"license_scope","displayName":"license scope","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"License or redistribution scope attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":26,"name":"visibility_tier","displayName":"visibility tier","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Serving visibility tier attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":27,"name":"ingest_run_id","displayName":"ingest run id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier of the ingestion run that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":28,"name":"version","displayName":"version","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Monotonic row version used for correction-aware reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":29,"name":"is_deleted","displayName":"is deleted","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Soft-delete marker; public serving excludes current tombstones.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":30,"name":"created_at","displayName":"created at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was first created.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":31,"name":"updated_at","displayName":"updated at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was last updated.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":32,"name":"publish_ts_source","displayName":"publish ts source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: publish ts source.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":33,"name":"filing_date","displayName":"filing date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Date on which the filing was submitted or published.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true}],"pit":{"supported":true,"asOfRequired":true,"timeColumn":"report_date","keyColumns":["instrument_id","report_date","period","source"],"maxLimit":1000,"maxWindowDays":400},"titleCn":"现金流量表","summaryCn":"按证券、报告期和期间记录经营、投资、融资现金流及其明细，展示利润之外的真实现金变化。","useCasesCn":["评估经营现金流质量","分析资本开支与自由现金流","检查融资依赖"],"grainCn":"每行代表“现金流量表”的一条记录；逻辑粒度由 instrument_id × report_date × period 共同确定。","timeSemanticsCn":"以 report_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常每周随上游披露或批处理更新；不是实时数据。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"report_date","meaningCn":"财务、持仓或统计报告所属日期。"},{"name":"period","meaningCn":"财务或统计所属期间。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 cursor，结果过大时必须缩小标的、日期或其他筛选。","caveatsCn":["做历史回测时优先使用 PIT 端点并传 as_of，避免把后来披露的数据带回过去。"],"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":"medium","identityFilters":["code"],"maxWindowDays":400,"requirement":"identity filter or bounded window","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"fundamental.cn_analyst_report","namespace":"fundamental","name":"cn_analyst_report","coverageTags":["a_share","fundamentals"],"description":"Canonical Friends financial dataset: A 股分析师研报.","relation":"fundamental.cn_analyst_report","objectKind":"table","rowMagnitude":"10K-99K","grain":"code × report_date × org_name × report_title × source","cadence":"producer_schedule","timeColumn":"report_date","defaultOrder":["code","report_date","org_name","report_title","source"],"filters":[{"name":"code","column":"code","required":false,"multipleValues":true,"jsonType":"string","example":"NNNNNN.SH or NNNNNN.SZ","exampleSource":"identifier_format"},{"name":"market","column":"market","required":false,"multipleValues":true,"jsonType":"string","example":"CN","exampleSource":"observed_coverage","allowedValues":["CN"]},{"name":"provider","column":"provider","required":false,"multipleValues":true,"jsonType":"string","example":"PROVIDER_VALUE"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["code","report_date","org_name","report_title","source"],"provenanceColumns":[],"fieldCount":36,"fields":[{"position":1,"name":"code","displayName":"code","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized security or contract code.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["code"],"returned":true},{"position":2,"name":"report_date","displayName":"report date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Reporting-period or statement date.","descriptionSource":"standard_glossary","roles":["time","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":3,"name":"name","displayName":"name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Canonical human-readable name.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":4,"name":"report_title","displayName":"report title","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: report title.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":5,"name":"report_type","displayName":"report type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: report type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"classify","displayName":"classify","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: classify.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"org_name","displayName":"org name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: org name.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":8,"name":"author_name","displayName":"author name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: author name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"quarter","displayName":"quarter","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: quarter.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"rating","displayName":"rating","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: rating.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"op_rt","displayName":"op rt","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: op rt.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"op_pr","displayName":"op pr","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: op pr.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"tp","displayName":"tp","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: tp.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"np","displayName":"np","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: np.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"eps","displayName":"eps","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: eps.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"pe","displayName":"pe","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: pe.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"name":"rd","displayName":"rd","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: rd.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":18,"name":"roe","displayName":"roe","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: roe.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":19,"name":"ev_ebitda","displayName":"ev ebitda","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: ev ebitda.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":20,"name":"max_price","displayName":"max price","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Price value for max price.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":21,"name":"min_price","displayName":"min price","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Price value for min price.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":22,"name":"imp_dg","displayName":"imp dg","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: imp dg.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":23,"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":24,"name":"source","displayName":"source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key","provenance"],"filterNames":["source"],"returned":true},{"position":25,"name":"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":"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":29,"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":30,"name":"source_url","displayName":"source url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"URL of the upstream evidence or record when distributable.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":31,"name":"source_record_id","displayName":"source record id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Provider-side identifier for the source record.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":32,"name":"raw_payload_hash","displayName":"raw payload hash","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Opaque fingerprint of the normalized source payload for provenance checks.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":33,"name":"parser_version","displayName":"parser version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Version of the parser or normalizer that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":34,"name":"quality_status","displayName":"quality status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Machine-readable data-quality classification.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":35,"name":"license_scope","displayName":"license scope","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"License or redistribution scope attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":36,"name":"visibility_tier","displayName":"visibility tier","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Serving visibility tier attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true}],"pit":null,"titleCn":"A 股分析师研报","summaryCn":"收录 A 股卖方研报的机构、作者、标题、报告期和分类，可用于追踪覆盖热度与观点变化；一行由 code、report_date、org_name、report_title 定位，主要字段包括 name、report_type、classify、author_name、quarter。","useCasesCn":["比较公司财务与分析师预期","构建基本面筛选和历史回测输入"],"grainCn":"每行代表“A 股分析师研报”的一条记录；逻辑粒度由 code × report_date × org_name × report_title × source 共同确定。","timeSemanticsCn":"以 report_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"code","meaningCn":"来源规范化后的证券、合约或指标代码。"},{"name":"report_date","meaningCn":"财务、持仓或统计报告所属日期。"},{"name":"org_name","meaningCn":"用于确定该表业务粒度或默认顺序的 org name 字段。"},{"name":"report_title","meaningCn":"用于确定该表业务粒度或默认顺序的 report title 字段。"},{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"}],"joins":[{"dataset":"ref.instrument","on":"code + market（先确认代码口径）","guidanceCn":"需要补证券主数据时可按代码和市场映射；不同来源代码可能不一致，优先先查 ref.code_mapping。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":["CN"],"coverage":{"measured":true,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{"CN":{"latestBusinessDate":"2026-08-26","rows":1833}},"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":36,"costGuard":{"tier":"small","identityFilters":["code"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"fundamental.cn_fundamental_metric","namespace":"fundamental","name":"cn_fundamental_metric","coverageTags":["a_share","fundamentals"],"description":"Canonical Friends financial dataset: A 股财务指标长表.","relation":"fundamental.cn_fundamental_metric","objectKind":"table","rowMagnitude":"10M-99M","grain":"code × report_period × statement × metric × source","cadence":"producer_schedule","timeColumn":"report_period","defaultOrder":["code","report_period","statement","metric","source"],"filters":[{"name":"code","column":"code","required":true,"multipleValues":true,"jsonType":"string","example":"AAPL"},{"name":"market","column":"market","required":false,"multipleValues":true,"jsonType":"string","example":"US"},{"name":"metric","column":"metric","required":false,"multipleValues":true,"jsonType":"string","example":"METRIC_VALUE"},{"name":"provider","column":"provider","required":false,"multipleValues":true,"jsonType":"string","example":"PROVIDER_VALUE"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"}],"maxLimit":5000,"maxWindowDays":400,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["code","report_period","statement","metric","source"],"provenanceColumns":[],"fieldCount":22,"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","required_filter","default_order","warehouse_primary_key","contract_unique_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"],"filterNames":["market"],"returned":true},{"position":3,"name":"report_period","displayName":"report period","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Source-normalized field: report period.","descriptionSource":"name_derived","roles":["time","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","returned":true},{"position":4,"name":"ann_date","displayName":"ann date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Announcement date.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":5,"name":"f_ann_date","displayName":"f ann date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for f ann date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":6,"name":"statement","displayName":"statement","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: statement.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":7,"name":"metric","displayName":"metric","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Machine-readable metric name.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["metric"],"returned":true},{"position":8,"name":"value","displayName":"value","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Numeric or source-normalized value for the metric.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"update_flag","displayName":"update flag","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: update flag.","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","default_order","warehouse_primary_key","contract_unique_key","provenance"],"filterNames":["source"],"returned":true},{"position":11,"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":12,"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":13,"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":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":"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}],"pit":null,"titleCn":"A 股财务指标长表","summaryCn":"把 A 股三大报表及财务指标整理为证券、报告期、报表和指标的长表，便于跨公司比较和回测；一行由 code、report_period、statement、metric 定位，主要字段包括 market、ann_date、f_ann_date、value、update_flag。","useCasesCn":["比较公司财务与分析师预期","构建基本面筛选和历史回测输入"],"grainCn":"每行代表“A 股财务指标长表”的一条记录；逻辑粒度由 code × report_period × statement × metric × source 共同确定。","timeSemanticsCn":"以 report_period 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"code","meaningCn":"来源规范化后的证券、合约或指标代码。"},{"name":"report_period","meaningCn":"用于确定该表业务粒度或默认顺序的 report period 字段。"},{"name":"statement","meaningCn":"用于确定该表业务粒度或默认顺序的 statement 字段。"},{"name":"metric","meaningCn":"长表中的机器可读指标名。"},{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"}],"joins":[{"dataset":"ref.instrument","on":"code + market（先确认代码口径）","guidanceCn":"需要补证券主数据时可按代码和市场映射；不同来源代码可能不一致，优先先查 ref.code_mapping。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；必须提供 code；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["该关系数据量较大，必须提供 code；这只限制单次扫描，不减少可访问历史。","单次请求的 start/end 最长 400 天；全历史请按时间窗连续分页。"],"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":22,"costGuard":{"tier":"small","identityFilters":["code","metric"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"fundamental.dividend_calendar","namespace":"fundamental","name":"dividend_calendar","coverageTags":["fundamentals"],"description":"Canonical Friends financial dataset: 分红日历.","relation":"fundamental.dividend_calendar","objectKind":"table","rowMagnitude":"10K-99K","grain":"instrument_id × ex_date","cadence":"daily","timeColumn":"ex_date","defaultOrder":["instrument_id","ex_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"},{"name":"symbol","column":"symbol","required":false,"multipleValues":true,"jsonType":"string","example":"AAPL"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["instrument_id","ex_date","source"],"provenanceColumns":[],"fieldCount":22,"fields":[{"position":1,"name":"instrument_id","displayName":"instrument id","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"WarrenHub canonical instrument identifier; use it for cross-dataset joins.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["instrument_id"],"returned":true},{"position":2,"name":"symbol","displayName":"symbol","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Display or trading symbol for the instrument.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["symbol"],"returned":true},{"position":3,"name":"ex_date","displayName":"ex date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for ex date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["time","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":4,"name":"cash_amount","displayName":"cash amount","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: cash amount.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"currency","displayName":"currency","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"ISO-like currency code for monetary values.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"declaration_date","displayName":"declaration date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for declaration date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":7,"name":"record_date","displayName":"record date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for record date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":8,"name":"payment_date","displayName":"payment date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for payment date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":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":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"分红日历","summaryCn":"这是财务报表、估值与分析师预期中的“分红日历”数据集；一行由 instrument_id、ex_date、source 定位，主要字段包括 symbol、cash_amount、currency、declaration_date、record_date。","useCasesCn":["比较公司财务与分析师预期","构建基本面筛选和历史回测输入"],"grainCn":"每行代表“分红日历”的一条记录；逻辑粒度由 instrument_id × ex_date 共同确定。","timeSemanticsCn":"以 ex_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"ex_date","meaningCn":"ex date 对应的日历日期。"},{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":[],"coverage":{"measured":false,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{},"latestBusinessDate":null,"note":"Recent observed coverage, not a lifetime guarantee. An unmeasured dataset carries no support claim in either direction."},"identifier":{"namespace":"mixed","formatByMarket":{},"storesZeroPaddedHkCode":false,"stableJoinKey":"instrument_id","resolverPath":"/api/v1/data/instruments/resolve"},"sparseSemantics":null,"emptyResultCodes":["VALID_EMPTY","NOT_IN_RANKING","UNSUPPORTED_MARKET","STALE_SOURCE","NO_MATCH","IDENTIFIER_INVALID","COVERAGE_UNKNOWN","PARTIAL_UNIVERSE"],"publication":{"published":true,"reason":null,"projectionReviewed":true},"returnedFieldCount":22,"costGuard":{"tier":"small","identityFilters":["instrument_id","symbol"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"fundamental.earnings_calendar","namespace":"fundamental","name":"earnings_calendar","coverageTags":["fundamentals"],"description":"Forward and historical earnings calendar (estimate vs actual EPS/revenue, surprise).","relation":"fundamental.earnings_calendar","objectKind":"table","rowMagnitude":"100K-999K","grain":"instrument_id × report_date × period_type","cadence":"daily","timeColumn":"report_date","defaultOrder":["report_date","code","market"],"filters":[{"name":"code","column":"code","required":false,"multipleValues":true,"jsonType":"string","example":"TICKER","exampleSource":"identifier_format"},{"name":"instrument_id","column":"instrument_id","required":false,"multipleValues":true,"jsonType":"integer","example":1},{"name":"market","column":"market","required":false,"multipleValues":true,"jsonType":"string","example":"US","exampleSource":"observed_coverage","allowedValues":["US"]},{"name":"period_type","column":"period_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":28,"fields":[{"position":1,"name":"instrument_id","displayName":"instrument id","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"WarrenHub canonical instrument identifier; use it for cross-dataset joins.","descriptionSource":"standard_glossary","roles":["filter","warehouse_primary_key"],"filterNames":["instrument_id"],"returned":true},{"position":2,"name":"code","displayName":"code","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized security or contract code.","descriptionSource":"standard_glossary","roles":["filter","default_order"],"filterNames":["code"],"returned":true},{"position":3,"name":"market","displayName":"market","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Canonical market or country-market code.","descriptionSource":"standard_glossary","roles":["filter","default_order"],"filterNames":["market"],"returned":true},{"position":4,"name":"report_date","displayName":"report date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Reporting-period or statement date.","descriptionSource":"standard_glossary","roles":["time","default_order","warehouse_primary_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":5,"name":"fiscal_period_end","displayName":"fiscal period end","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Source-normalized field: fiscal period end.","descriptionSource":"name_derived","roles":["warehouse_primary_key"],"filterNames":[],"jsonFormat":"date","returned":true},{"position":6,"name":"period_type","displayName":"period type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Reporting-period classification such as annual or quarterly.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["period_type"],"returned":true},{"position":7,"name":"time_of_day","displayName":"time of day","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: time of day.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"estimate_eps","displayName":"estimate eps","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: estimate eps.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"actual_eps","displayName":"actual eps","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: actual eps.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"estimate_revenue","displayName":"estimate revenue","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: estimate revenue.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"actual_revenue","displayName":"actual revenue","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: actual revenue.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"surprise_pct","displayName":"surprise pct","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Percentage value for surprise pct.","descriptionSource":"name_derived","roles":[],"filterNames":[],"unit":"percent","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":["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","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":"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}],"pit":{"supported":true,"asOfRequired":true,"timeColumn":"report_date","keyColumns":["instrument_id","report_date","fiscal_period_end","source"],"maxLimit":1000,"maxWindowDays":400},"titleCn":"财报日历与业绩结果","summaryCn":"统一未来和历史财报日期、EPS 与营收预期实际值及 surprise，支持财报事件研究。","useCasesCn":["查询未来财报日期","计算业绩超预期程度","研究财报前后价格表现"],"grainCn":"每行代表“财报日历与业绩结果”的一条记录；逻辑粒度由 instrument_id × report_date × period_type 共同确定。","timeSemanticsCn":"以 report_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"report_date","meaningCn":"财务、持仓或统计报告所属日期。"},{"name":"period_type","meaningCn":"年度、季度等报告期间类型。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 cursor，结果过大时必须缩小标的、日期或其他筛选。","caveatsCn":["做历史回测时优先使用 PIT 端点并传 as_of，避免把后来披露的数据带回过去。"],"supportedMarkets":["US"],"coverage":{"measured":true,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{"US":{"latestBusinessDate":"2027-02-18","rows":8747}},"latestBusinessDate":"2027-02-18","note":"Recent observed coverage, not a lifetime guarantee. An unmeasured dataset carries no support claim in either direction."},"identifier":{"namespace":"us_ticker","formatByMarket":{"US":"TICKER"},"storesZeroPaddedHkCode":false,"stableJoinKey":"instrument_id","resolverPath":"/api/v1/data/instruments/resolve"},"sparseSemantics":null,"emptyResultCodes":["VALID_EMPTY","NOT_IN_RANKING","UNSUPPORTED_MARKET","STALE_SOURCE","NO_MATCH","IDENTIFIER_INVALID","COVERAGE_UNKNOWN","PARTIAL_UNIVERSE"],"publication":{"published":true,"reason":null,"projectionReviewed":true},"returnedFieldCount":28,"costGuard":{"tier":"medium","identityFilters":["code","instrument_id"],"maxWindowDays":400,"requirement":"identity filter or bounded window","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"fundamental.financials_global","namespace":"fundamental","name":"financials_global","coverageTags":["fundamentals"],"description":"Canonical Friends financial dataset: 全球统一财务报表.","relation":"fundamental.v_financials_global","objectKind":"view","rowMagnitude":"view","grain":"market × symbol × report_date × period × source","cadence":"producer_schedule","timeColumn":"report_date","defaultOrder":["market","symbol","report_date","period","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"},{"name":"period","column":"period","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"provider","column":"provider","required":false,"multipleValues":true,"jsonType":"string","example":"PROVIDER_VALUE"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"},{"name":"symbol","column":"symbol","required":false,"multipleValues":true,"jsonType":"string","example":"AAPL"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"relation_default","contractVersion":null,"uniqueKey":["market","symbol","report_date","period","source"],"provenanceColumns":[],"fieldCount":33,"fields":[{"position":1,"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":2,"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","contract_unique_key"],"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","default_order","contract_unique_key"],"filterNames":["market"],"returned":true},{"position":4,"name":"report_date","displayName":"report date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Reporting-period or statement date.","descriptionSource":"standard_glossary","roles":["time","default_order","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":5,"name":"period","displayName":"period","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Reporting or observation period label.","descriptionSource":"standard_glossary","roles":["filter","default_order","contract_unique_key"],"filterNames":["period"],"returned":true},{"position":6,"name":"ann_date","displayName":"ann date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Announcement date.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":7,"name":"filing_date","displayName":"filing date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Date on which the filing was submitted or published.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":8,"name":"revenue","displayName":"revenue","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: revenue.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"oper_cost","displayName":"oper cost","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: oper cost.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"gross_profit","displayName":"gross profit","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: gross profit.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"operate_profit","displayName":"operate profit","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: operate profit.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"total_profit","displayName":"total profit","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total profit.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"net_profit","displayName":"net profit","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: net profit.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"basic_eps","displayName":"basic eps","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: basic eps.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"diluted_eps","displayName":"diluted eps","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: diluted eps.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"total_assets","displayName":"total assets","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total assets.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"name":"total_liab","displayName":"total liab","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total liab.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":18,"name":"total_equity","displayName":"total equity","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total equity.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":19,"name":"money_cap","displayName":"money cap","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: money cap.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":20,"name":"accounts_receiv","displayName":"accounts receiv","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: accounts receiv.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":21,"name":"inventories","displayName":"inventories","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: inventories.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":22,"name":"fix_assets","displayName":"fix assets","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: fix assets.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":23,"name":"intan_assets","displayName":"intan assets","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: intan assets.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":24,"name":"goodwill","displayName":"goodwill","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: goodwill.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":25,"name":"net_oper_cf","displayName":"net oper cf","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: net oper cf.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":26,"name":"net_invest_cf","displayName":"net invest cf","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: net invest cf.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":27,"name":"net_fin_cf","displayName":"net fin cf","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: net fin cf.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":28,"name":"cash_end","displayName":"cash end","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: cash end.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":29,"name":"cash_begin","displayName":"cash begin","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: cash begin.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":30,"name":"capex","displayName":"capex","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: capex.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":31,"name":"free_cashflow","displayName":"free cashflow","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: free cashflow.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":32,"name":"source","displayName":"source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["filter","default_order","contract_unique_key","provenance"],"filterNames":["source"],"returned":true},{"position":33,"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}],"pit":null,"titleCn":"全球统一财务报表","summaryCn":"这是财务报表、估值与分析师预期中的“全球统一财务报表”数据集；一行由 market、symbol、report_date、period 定位，主要字段包括 instrument_id、ann_date、filing_date、revenue、oper_cost。","useCasesCn":["比较公司财务与分析师预期","构建基本面筛选和历史回测输入"],"grainCn":"每行代表“全球统一财务报表”的一条记录；逻辑粒度由 market × symbol × report_date × period × source 共同确定。","timeSemanticsCn":"以 report_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"market","meaningCn":"规范市场代码。"},{"name":"symbol","meaningCn":"证券或交易对的展示代码。"},{"name":"report_date","meaningCn":"财务、持仓或统计报告所属日期。"},{"name":"period","meaningCn":"财务或统计所属期间。"},{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":[],"coverage":{"measured":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","symbol"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"fundamental.financials_pit","namespace":"fundamental","name":"financials_pit","coverageTags":["fundamentals"],"description":"Canonical Friends financial dataset: 时点可知财务报表.","relation":"fundamental.v_financials_pit","objectKind":"view","rowMagnitude":"view","grain":"entity_id × accession_no × metric × period_end × unit × source","cadence":"producer_schedule","timeColumn":"filing_date","defaultOrder":["entity_id","accession_no","metric","period_end","unit","source"],"filters":[{"name":"accession_no","column":"accession_no","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"fiscal_year","column":"fiscal_year","required":false,"multipleValues":true,"jsonType":"integer","example":"FILTER_VALUE"},{"name":"instrument_id","column":"instrument_id","required":false,"multipleValues":true,"jsonType":"integer","example":1},{"name":"market","column":"market","required":false,"multipleValues":true,"jsonType":"string","example":"US"},{"name":"metric","column":"metric","required":false,"multipleValues":true,"jsonType":"string","example":"METRIC_VALUE"},{"name":"period_type","column":"period_type","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"provider","column":"provider","required":false,"multipleValues":true,"jsonType":"string","example":"PROVIDER_VALUE"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"},{"name":"symbol","column":"symbol","required":false,"multipleValues":true,"jsonType":"string","example":"AAPL"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"relation_default","contractVersion":null,"uniqueKey":["entity_id","accession_no","metric","period_end","unit","source"],"provenanceColumns":[],"fieldCount":23,"fields":[{"position":1,"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":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":"entity_id","displayName":"entity id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for entity.","descriptionSource":"name_derived","roles":["default_order","contract_unique_key"],"filterNames":[],"returned":true},{"position":5,"name":"accession_no","displayName":"accession no","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC accession number identifying one filing submission.","descriptionSource":"standard_glossary","roles":["filter","default_order","contract_unique_key"],"filterNames":["accession_no"],"returned":true},{"position":6,"name":"metric","displayName":"metric","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Machine-readable metric name.","descriptionSource":"standard_glossary","roles":["filter","default_order","contract_unique_key"],"filterNames":["metric"],"returned":true},{"position":7,"name":"statement_type","displayName":"statement type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: statement type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"taxonomy","displayName":"taxonomy","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: taxonomy.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"source_concept","displayName":"source concept","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: source concept.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"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":11,"name":"period_end","displayName":"period end","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Source-normalized field: period end.","descriptionSource":"name_derived","roles":["default_order","contract_unique_key"],"filterNames":[],"jsonFormat":"date","returned":true},{"position":12,"name":"filing_date","displayName":"filing date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Date on which the filing was submitted or published.","descriptionSource":"standard_glossary","roles":["time"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":13,"name":"publish_ts","displayName":"publish ts","clickhouseType":"Nullable(DateTime64(3, 'UTC'))","jsonType":"string","nullable":true,"description":"UTC point-in-time availability timestamp used by PIT reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":14,"name":"fiscal_year","displayName":"fiscal year","clickhouseType":"Nullable(Int32)","jsonType":"integer","nullable":true,"description":"Source-normalized field: fiscal year.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["fiscal_year"],"returned":true},{"position":15,"name":"fiscal_period","displayName":"fiscal period","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: fiscal period.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"period_type","displayName":"period type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Reporting-period classification such as annual or quarterly.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["period_type"],"returned":true},{"position":17,"name":"unit","displayName":"unit","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Unit attached to the numeric observation.","descriptionSource":"standard_glossary","roles":["default_order","contract_unique_key"],"filterNames":[],"returned":true},{"position":18,"name":"normalized_unit","displayName":"normalized unit","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: normalized unit.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":19,"name":"value","displayName":"value","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Numeric or source-normalized value for the metric.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":20,"name":"metric_value","displayName":"metric value","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: metric value.","descriptionSource":"name_derived","roles":[],"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":"source","displayName":"source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["filter","default_order","contract_unique_key","provenance"],"filterNames":["source"],"returned":true},{"position":23,"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}],"pit":null,"titleCn":"时点可知财务报表","summaryCn":"这是财务报表、估值与分析师预期中的“时点可知财务报表”数据集；一行由 entity_id、accession_no、metric、period_end 定位，主要字段包括 instrument_id、symbol、market、statement_type、taxonomy。","useCasesCn":["比较公司财务与分析师预期","构建基本面筛选和历史回测输入"],"grainCn":"每行代表“时点可知财务报表”的一条记录；逻辑粒度由 entity_id × accession_no × metric × period_end × unit × source 共同确定。","timeSemanticsCn":"以 filing_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"entity_id","meaningCn":"用于识别 entity 的业务标识。"},{"name":"accession_no","meaningCn":"SEC 对单次申报分配的唯一 accession number。"},{"name":"metric","meaningCn":"长表中的机器可读指标名。"},{"name":"period_end","meaningCn":"用于确定该表业务粒度或默认顺序的 period end 字段。"},{"name":"unit","meaningCn":"用于确定该表业务粒度或默认顺序的 unit 字段。"},{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":[],"coverage":{"measured":true,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{},"latestBusinessDate":null,"note":"Recent observed coverage, not a lifetime guarantee. An unmeasured dataset carries no support claim in either direction."},"identifier":{"namespace":"mixed","formatByMarket":{},"storesZeroPaddedHkCode":false,"stableJoinKey":"instrument_id","resolverPath":"/api/v1/data/instruments/resolve"},"sparseSemantics":null,"emptyResultCodes":["VALID_EMPTY","NOT_IN_RANKING","UNSUPPORTED_MARKET","STALE_SOURCE","NO_MATCH","IDENTIFIER_INVALID","COVERAGE_UNKNOWN","PARTIAL_UNIVERSE"],"publication":{"published":true,"reason":null,"projectionReviewed":true},"returnedFieldCount":23,"costGuard":{"tier":"small","identityFilters":["accession_no","instrument_id","metric","symbol"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"fundamental.financials_us_deep","namespace":"fundamental","name":"financials_us_deep","coverageTags":["fundamentals"],"description":"Canonical Friends financial dataset: 美股深度财务报表.","relation":"fundamental.v_financials_us_deep","objectKind":"view","rowMagnitude":"view","grain":"instrument_id × period_end × timeframe × fiscal_quarter × source","cadence":"producer_schedule","timeColumn":"filing_date","defaultOrder":["instrument_id","period_end","timeframe","fiscal_quarter","source"],"filters":[{"name":"cik","column":"cik","required":false,"multipleValues":true,"jsonType":"string","example":"0000320193"},{"name":"fiscal_quarter","column":"fiscal_quarter","required":false,"multipleValues":true,"jsonType":"integer","example":"FILTER_VALUE"},{"name":"fiscal_year","column":"fiscal_year","required":false,"multipleValues":true,"jsonType":"integer","example":"FILTER_VALUE"},{"name":"instrument_id","column":"instrument_id","required":false,"multipleValues":true,"jsonType":"integer","example":1},{"name":"provider","column":"provider","required":false,"multipleValues":true,"jsonType":"string","example":"PROVIDER_VALUE"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"},{"name":"symbol","column":"symbol","required":false,"multipleValues":true,"jsonType":"string","example":"AAPL"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"relation_default","contractVersion":null,"uniqueKey":["instrument_id","period_end","timeframe","fiscal_quarter","source"],"provenanceColumns":[],"fieldCount":49,"fields":[{"position":1,"name":"instrument_id","displayName":"instrument id","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"WarrenHub canonical instrument identifier; use it for cross-dataset joins.","descriptionSource":"standard_glossary","roles":["filter","default_order","contract_unique_key"],"filterNames":["instrument_id"],"returned":true},{"position":2,"name":"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":"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":4,"name":"period_end","displayName":"period end","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Source-normalized field: period end.","descriptionSource":"name_derived","roles":["default_order","contract_unique_key"],"filterNames":[],"jsonFormat":"date","returned":true},{"position":5,"name":"filing_date","displayName":"filing date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Date on which the filing was submitted or published.","descriptionSource":"standard_glossary","roles":["time"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":6,"name":"fiscal_quarter","displayName":"fiscal quarter","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: fiscal quarter.","descriptionSource":"name_derived","roles":["filter","default_order","contract_unique_key"],"filterNames":["fiscal_quarter"],"returned":true},{"position":7,"name":"fiscal_year","displayName":"fiscal year","clickhouseType":"Nullable(UInt16)","jsonType":"integer","nullable":true,"description":"Source-normalized field: fiscal year.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["fiscal_year"],"returned":true},{"position":8,"name":"timeframe","displayName":"timeframe","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: timeframe.","descriptionSource":"name_derived","roles":["default_order","contract_unique_key"],"filterNames":[],"returned":true},{"position":9,"name":"revenue","displayName":"revenue","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: revenue.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"cost_of_revenue","displayName":"cost of revenue","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: cost of revenue.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"gross_profit","displayName":"gross profit","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: gross profit.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"selling_general_administrative","displayName":"selling general administrative","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: selling general administrative.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"research_development","displayName":"research development","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: research development.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"total_operating_expenses","displayName":"total operating expenses","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total operating expenses.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"operating_income","displayName":"operating income","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: operating income.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"income_before_income_taxes","displayName":"income before income taxes","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: income before income taxes.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"name":"income_taxes","displayName":"income taxes","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: income taxes.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":18,"name":"consolidated_net_income_loss","displayName":"consolidated net income loss","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: consolidated net income loss.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":19,"name":"net_income","displayName":"net income","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: net income.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":20,"name":"basic_eps","displayName":"basic eps","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: basic eps.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":21,"name":"diluted_eps","displayName":"diluted eps","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: diluted eps.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":22,"name":"basic_shares_outstanding","displayName":"basic shares outstanding","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: basic shares outstanding.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":23,"name":"diluted_shares_outstanding","displayName":"diluted shares outstanding","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: diluted shares outstanding.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":24,"name":"ebitda","displayName":"ebitda","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: ebitda.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":25,"name":"cash_and_equivalents","displayName":"cash and equivalents","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: cash and equivalents.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":26,"name":"short_term_investments","displayName":"short term investments","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: short term investments.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":27,"name":"receivables","displayName":"receivables","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: receivables.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":28,"name":"inventories","displayName":"inventories","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: inventories.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":29,"name":"total_current_assets","displayName":"total current assets","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total current assets.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":30,"name":"property_plant_equipment_net","displayName":"property plant equipment net","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: property plant equipment net.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":31,"name":"goodwill","displayName":"goodwill","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: goodwill.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":32,"name":"intangible_assets_net","displayName":"intangible assets net","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: intangible assets net.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":33,"name":"total_assets","displayName":"total assets","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total assets.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":34,"name":"accounts_payable","displayName":"accounts payable","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: accounts payable.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":35,"name":"total_current_liabilities","displayName":"total current liabilities","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total current liabilities.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":36,"name":"long_term_debt","displayName":"long term debt","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: long term debt.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":37,"name":"total_liabilities","displayName":"total liabilities","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total liabilities.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":38,"name":"retained_earnings_deficit","displayName":"retained earnings deficit","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: retained earnings deficit.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":39,"name":"total_equity_attributable_to_parent","displayName":"total equity attributable to parent","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total equity attributable to parent.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":40,"name":"total_equity","displayName":"total equity","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total equity.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":41,"name":"net_cash_from_operating_activities","displayName":"net cash from operating activities","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: net cash from operating activities.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":42,"name":"net_cash_from_investing_activities","displayName":"net cash from investing activities","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: net cash from investing activities.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":43,"name":"net_cash_from_financing_activities","displayName":"net cash from financing activities","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: net cash from financing activities.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":44,"name":"capex","displayName":"capex","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: capex.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":45,"name":"free_cash_flow","displayName":"free cash flow","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: free cash flow.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":46,"name":"dividends","displayName":"dividends","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: dividends.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":47,"name":"change_in_cash_and_equivalents","displayName":"change in cash and equivalents","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: change in cash and equivalents.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":48,"name":"source","displayName":"source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["filter","default_order","contract_unique_key","provenance"],"filterNames":["source"],"returned":true},{"position":49,"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}],"pit":null,"titleCn":"美股深度财务报表","summaryCn":"这是财务报表、估值与分析师预期中的“美股深度财务报表”数据集；一行由 instrument_id、period_end、timeframe、fiscal_quarter 定位，主要字段包括 symbol、cik、filing_date、fiscal_year、revenue。","useCasesCn":["比较公司财务与分析师预期","构建基本面筛选和历史回测输入"],"grainCn":"每行代表“美股深度财务报表”的一条记录；逻辑粒度由 instrument_id × period_end × timeframe × fiscal_quarter × source 共同确定。","timeSemanticsCn":"以 filing_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"period_end","meaningCn":"用于确定该表业务粒度或默认顺序的 period end 字段。"},{"name":"timeframe","meaningCn":"用于确定该表业务粒度或默认顺序的 timeframe 字段。"},{"name":"fiscal_quarter","meaningCn":"用于确定该表业务粒度或默认顺序的 fiscal quarter 字段。"},{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":[],"coverage":{"measured":false,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{},"latestBusinessDate":null,"note":"Recent observed coverage, not a lifetime guarantee. An unmeasured dataset carries no support claim in either direction."},"identifier":{"namespace":"mixed","formatByMarket":{},"storesZeroPaddedHkCode":false,"stableJoinKey":"instrument_id","resolverPath":"/api/v1/data/instruments/resolve"},"sparseSemantics":null,"emptyResultCodes":["VALID_EMPTY","NOT_IN_RANKING","UNSUPPORTED_MARKET","STALE_SOURCE","NO_MATCH","IDENTIFIER_INVALID","COVERAGE_UNKNOWN","PARTIAL_UNIVERSE"],"publication":{"published":true,"reason":null,"projectionReviewed":true},"returnedFieldCount":49,"costGuard":{"tier":"small","identityFilters":["cik","instrument_id","symbol"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"fundamental.historical_market_cap","namespace":"fundamental","name":"historical_market_cap","coverageTags":["fundamentals"],"description":"Point-in-time historical market capitalization by instrument.","relation":"fundamental.historical_market_cap","objectKind":"table","rowMagnitude":"1M-9M","grain":"instrument_id × observation_date","cadence":"daily","timeColumn":"observation_date","defaultOrder":["observation_date","code","market"],"filters":[{"name":"code","column":"code","required":false,"multipleValues":true,"jsonType":"string","example":"TICKER","exampleSource":"identifier_format"},{"name":"currency","column":"currency","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"instrument_id","column":"instrument_id","required":false,"multipleValues":true,"jsonType":"integer","example":1},{"name":"market","column":"market","required":false,"multipleValues":true,"jsonType":"string","example":"US","exampleSource":"observed_coverage","allowedValues":["US"]},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":false,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":22,"fields":[{"position":1,"name":"instrument_id","displayName":"instrument id","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"WarrenHub canonical instrument identifier; use it for cross-dataset joins.","descriptionSource":"standard_glossary","roles":["filter","warehouse_primary_key"],"filterNames":["instrument_id"],"returned":true},{"position":2,"name":"code","displayName":"code","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized security or contract code.","descriptionSource":"standard_glossary","roles":["filter","default_order"],"filterNames":["code"],"returned":true},{"position":3,"name":"market","displayName":"market","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Canonical market or country-market code.","descriptionSource":"standard_glossary","roles":["filter","default_order"],"filterNames":["market"],"returned":true},{"position":4,"name":"observation_date","displayName":"observation date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for observation date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["time","default_order","warehouse_primary_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":5,"name":"market_cap_value","displayName":"market cap value","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"Source-normalized field: market cap value.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"currency","displayName":"currency","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"ISO-like currency code for monetary values.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["currency"],"returned":true},{"position":7,"name":"publish_ts","displayName":"publish ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC point-in-time availability timestamp used by PIT reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":8,"name":"source_ts","displayName":"source ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"Timestamp asserted by the upstream source.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":9,"name":"ingested_at","displayName":"ingested at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the source record entered the warehouse.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":10,"name":"source","displayName":"source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["filter","warehouse_primary_key","provenance"],"filterNames":["source"],"returned":true},{"position":11,"name":"provider","displayName":"provider","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Upstream data provider identifier.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":12,"name":"source_url","displayName":"source url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"URL of the upstream evidence or record when distributable.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":13,"name":"source_record_id","displayName":"source record id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Provider-side identifier for the source record.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":14,"name":"raw_payload_hash","displayName":"raw payload hash","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Opaque fingerprint of the normalized source payload for provenance checks.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":15,"name":"parser_version","displayName":"parser version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Version of the parser or normalizer that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":16,"name":"quality_status","displayName":"quality status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Machine-readable data-quality classification.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":17,"name":"license_scope","displayName":"license scope","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"License or redistribution scope attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":18,"name":"visibility_tier","displayName":"visibility tier","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Serving visibility tier attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":19,"name":"ingest_run_id","displayName":"ingest run id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier of the ingestion run that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":20,"name":"version","displayName":"version","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Monotonic row version used for correction-aware reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":21,"name":"version_ts","displayName":"version ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp associated with the row version.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":22,"name":"is_deleted","displayName":"is deleted","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Soft-delete marker; public serving excludes current tombstones.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true}],"pit":{"supported":true,"asOfRequired":true,"timeColumn":"observation_date","keyColumns":["instrument_id","observation_date","source"],"maxLimit":1000,"maxWindowDays":400},"titleCn":"历史时点市值","summaryCn":"按证券和观察日期保存当时可得的市值，适合历史分组、规模因子和无前视偏差筛选。","useCasesCn":["按历史市值构建股票分组","计算规模因子","将财务指标标准化为市值比例"],"grainCn":"每行代表“历史时点市值”的一条记录；逻辑粒度由 instrument_id × observation_date 共同确定。","timeSemanticsCn":"以 observation_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"observation_date","meaningCn":"observation date 对应的日历日期。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 cursor，结果过大时必须缩小标的、日期或其他筛选。","caveatsCn":["做历史回测时优先使用 PIT 端点并传 as_of，避免把后来披露的数据带回过去。"],"supportedMarkets":["US"],"coverage":{"measured":true,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{"US":{"latestBusinessDate":"2026-08-14","rows":17546}},"latestBusinessDate":"2026-08-14","note":"Recent observed coverage, not a lifetime guarantee. An unmeasured dataset carries no support claim in either direction."},"identifier":{"namespace":"us_ticker","formatByMarket":{"US":"TICKER"},"storesZeroPaddedHkCode":false,"stableJoinKey":"instrument_id","resolverPath":"/api/v1/data/instruments/resolve"},"sparseSemantics":null,"emptyResultCodes":["VALID_EMPTY","NOT_IN_RANKING","UNSUPPORTED_MARKET","STALE_SOURCE","NO_MATCH","IDENTIFIER_INVALID","COVERAGE_UNKNOWN","PARTIAL_UNIVERSE"],"publication":{"published":true,"reason":null,"projectionReviewed":true},"returnedFieldCount":22,"costGuard":{"tier":"large","identityFilters":["code","instrument_id"],"maxWindowDays":400,"requirement":"identity filter and bounded window","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"fundamental.hk_fundamental_metric","namespace":"fundamental","name":"hk_fundamental_metric","coverageTags":["fundamentals"],"description":"Canonical Friends financial dataset: 港股财务指标长表.","relation":"fundamental.hk_fundamental_metric","objectKind":"table","rowMagnitude":"1M-9M","grain":"code × statement × period_type × report_period × metric × source","cadence":"producer_schedule","timeColumn":"report_period","defaultOrder":["code","statement","period_type","report_period","metric","source"],"filters":[{"name":"code","column":"code","required":false,"multipleValues":true,"jsonType":"string","example":"NNNN.HK","exampleSource":"identifier_format"},{"name":"market","column":"market","required":false,"multipleValues":true,"jsonType":"string","example":"HK","exampleSource":"observed_coverage","allowedValues":["HK"]},{"name":"metric","column":"metric","required":false,"multipleValues":true,"jsonType":"string","example":"METRIC_VALUE"},{"name":"period_type","column":"period_type","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"provider","column":"provider","required":false,"multipleValues":true,"jsonType":"string","example":"PROVIDER_VALUE"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["code","statement","period_type","report_period","metric","source"],"provenanceColumns":[],"fieldCount":21,"fields":[{"position":1,"name":"code","displayName":"code","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized security or contract code.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["code"],"returned":true},{"position":2,"name":"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":3,"name":"statement","displayName":"statement","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: statement.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":4,"name":"period_type","displayName":"period type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Reporting-period classification such as annual or quarterly.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["period_type"],"returned":true},{"position":5,"name":"report_period","displayName":"report period","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Source-normalized field: report period.","descriptionSource":"name_derived","roles":["time","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","returned":true},{"position":6,"name":"metric","displayName":"metric","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Machine-readable metric name.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["metric"],"returned":true},{"position":7,"name":"value","displayName":"value","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Numeric or source-normalized value for the metric.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":8,"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":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":"ingest_run_id","displayName":"ingest run id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier of the ingestion run that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":11,"name":"version","displayName":"version","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Monotonic row version used for correction-aware reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":12,"name":"is_deleted","displayName":"is deleted","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Soft-delete marker; public serving excludes current tombstones.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"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":"provider","displayName":"provider","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Upstream data provider identifier.","descriptionSource":"standard_glossary","roles":["filter","provenance"],"filterNames":["provider"],"returned":true},{"position":15,"name":"source_url","displayName":"source url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"URL of the upstream evidence or record when distributable.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":16,"name":"source_record_id","displayName":"source record id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Provider-side identifier for the source record.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":17,"name":"raw_payload_hash","displayName":"raw payload hash","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Opaque fingerprint of the normalized source payload for provenance checks.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":18,"name":"parser_version","displayName":"parser version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Version of the parser or normalizer that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":19,"name":"quality_status","displayName":"quality status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Machine-readable data-quality classification.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":20,"name":"license_scope","displayName":"license scope","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"License or redistribution scope attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":21,"name":"visibility_tier","displayName":"visibility tier","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Serving visibility tier attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true}],"pit":null,"titleCn":"港股财务指标长表","summaryCn":"这是财务报表、估值与分析师预期中的“港股财务指标长表”数据集；一行由 code、statement、period_type、report_period 定位，主要字段包括 market、metric、value、currency、source。","useCasesCn":["比较公司财务与分析师预期","构建基本面筛选和历史回测输入"],"grainCn":"每行代表“港股财务指标长表”的一条记录；逻辑粒度由 code × statement × period_type × report_period × metric × source 共同确定。","timeSemanticsCn":"以 report_period 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"code","meaningCn":"来源规范化后的证券、合约或指标代码。"},{"name":"statement","meaningCn":"用于确定该表业务粒度或默认顺序的 statement 字段。"},{"name":"period_type","meaningCn":"年度、季度等报告期间类型。"},{"name":"report_period","meaningCn":"用于确定该表业务粒度或默认顺序的 report period 字段。"},{"name":"metric","meaningCn":"长表中的机器可读指标名。"},{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"}],"joins":[{"dataset":"ref.instrument","on":"code + market（先确认代码口径）","guidanceCn":"需要补证券主数据时可按代码和市场映射；不同来源代码可能不一致，优先先查 ref.code_mapping。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":["HK"],"coverage":{"measured":true,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{"HK":{"latestBusinessDate":"2026-12-31","rows":116571}},"latestBusinessDate":"2026-12-31","note":"Recent observed coverage, not a lifetime guarantee. An unmeasured dataset carries no support claim in either direction."},"identifier":{"namespace":"hk_numeric","formatByMarket":{"HK":"NNNN.HK"},"storesZeroPaddedHkCode":false,"stableJoinKey":"instrument_id","resolverPath":"/api/v1/data/instruments/resolve"},"sparseSemantics":null,"emptyResultCodes":["VALID_EMPTY","NOT_IN_RANKING","UNSUPPORTED_MARKET","STALE_SOURCE","NO_MATCH","IDENTIFIER_INVALID","COVERAGE_UNKNOWN","PARTIAL_UNIVERSE"],"publication":{"published":true,"reason":null,"projectionReviewed":true},"returnedFieldCount":21,"costGuard":{"tier":"small","identityFilters":["code","metric"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"fundamental.income_statement","namespace":"fundamental","name":"income_statement","coverageTags":["fundamentals"],"description":"Income-statement fundamentals.","relation":"fundamental.income_statement","objectKind":"table","rowMagnitude":"100K-999K","grain":"instrument_id × report_date × period","cadence":"weekly","timeColumn":"report_date","defaultOrder":["report_date","code","period"],"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":"period","column":"period","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":false,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":34,"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":"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":4,"name":"report_date","displayName":"report date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Reporting-period or statement date.","descriptionSource":"standard_glossary","roles":["time","default_order","warehouse_primary_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":5,"name":"period","displayName":"period","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Reporting or observation period label.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["period"],"returned":true},{"position":6,"name":"ann_date","displayName":"ann date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Announcement date.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","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","warehouse_primary_key","provenance"],"filterNames":["source"],"returned":true},{"position":8,"name":"publish_ts","displayName":"publish ts","clickhouseType":"Nullable(DateTime64(3, 'UTC'))","jsonType":"string","nullable":true,"description":"UTC point-in-time availability timestamp used by PIT reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":9,"name":"source_ts","displayName":"source ts","clickhouseType":"Nullable(DateTime64(3, 'UTC'))","jsonType":"string","nullable":true,"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":"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":12,"name":"revenue","displayName":"revenue","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: revenue.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"oper_cost","displayName":"oper cost","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: oper cost.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"gross_profit","displayName":"gross profit","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: gross profit.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"operate_profit","displayName":"operate profit","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: operate profit.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"total_profit","displayName":"total profit","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total profit.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"name":"net_profit","displayName":"net profit","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: net profit.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":18,"name":"basic_eps","displayName":"basic eps","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: basic eps.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":19,"name":"diluted_eps","displayName":"diluted eps","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: diluted eps.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":20,"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":21,"name":"source_url","displayName":"source url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"URL of the upstream evidence or record when distributable.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":22,"name":"source_record_id","displayName":"source record id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Provider-side identifier for the source record.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":23,"name":"raw_payload_hash","displayName":"raw payload hash","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Opaque fingerprint of the normalized source payload for provenance checks.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":24,"name":"parser_version","displayName":"parser version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Version of the parser or normalizer that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":25,"name":"quality_status","displayName":"quality status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Machine-readable data-quality classification.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":26,"name":"license_scope","displayName":"license scope","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"License or redistribution scope attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":27,"name":"visibility_tier","displayName":"visibility tier","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Serving visibility tier attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":28,"name":"ingest_run_id","displayName":"ingest run id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier of the ingestion run that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":29,"name":"version","displayName":"version","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Monotonic row version used for correction-aware reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":30,"name":"is_deleted","displayName":"is deleted","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Soft-delete marker; public serving excludes current tombstones.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":31,"name":"created_at","displayName":"created at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was first created.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":32,"name":"updated_at","displayName":"updated at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was last updated.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":33,"name":"publish_ts_source","displayName":"publish ts source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: publish ts source.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":34,"name":"filing_date","displayName":"filing date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Date on which the filing was submitted or published.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true}],"pit":{"supported":true,"asOfRequired":true,"timeColumn":"report_date","keyColumns":["instrument_id","report_date","period","source"],"maxLimit":1000,"maxWindowDays":400},"titleCn":"利润表","summaryCn":"按证券、报告期和期间保存收入、成本、利润等经营结果，是盈利能力和增长研究的主表。","useCasesCn":["计算收入利润增速","分析毛利率与营业利润率","比较季度年度盈利趋势"],"grainCn":"每行代表“利润表”的一条记录；逻辑粒度由 instrument_id × report_date × period 共同确定。","timeSemanticsCn":"以 report_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常每周随上游披露或批处理更新；不是实时数据。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"report_date","meaningCn":"财务、持仓或统计报告所属日期。"},{"name":"period","meaningCn":"财务或统计所属期间。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 cursor，结果过大时必须缩小标的、日期或其他筛选。","caveatsCn":["做历史回测时优先使用 PIT 端点并传 as_of，避免把后来披露的数据带回过去。"],"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":34,"costGuard":{"tier":"medium","identityFilters":["code"],"maxWindowDays":400,"requirement":"identity filter or bounded window","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"fundamental.income_statement_massive","namespace":"fundamental","name":"income_statement_massive","coverageTags":["fundamentals"],"description":"Canonical Friends financial dataset: Massive 利润表.","relation":"fundamental.income_statement_massive","objectKind":"table","rowMagnitude":"100K-999K","grain":"cik × period_end × timeframe","cadence":"weekly","timeColumn":"filing_date","defaultOrder":["ticker","period_end","timeframe","fiscal_quarter","source"],"filters":[{"name":"cik","column":"cik","required":false,"multipleValues":true,"jsonType":"string","example":"0000320193"},{"name":"fiscal_quarter","column":"fiscal_quarter","required":false,"multipleValues":true,"jsonType":"integer","example":"FILTER_VALUE"},{"name":"fiscal_year","column":"fiscal_year","required":false,"multipleValues":true,"jsonType":"integer","example":"FILTER_VALUE"},{"name":"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","period_end","timeframe","fiscal_quarter","source"],"provenanceColumns":[],"fieldCount":45,"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":"cik","displayName":"cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC Central Index Key identifying the filer.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["cik"],"returned":true},{"position":3,"name":"period_end","displayName":"period end","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Source-normalized field: period end.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","returned":true},{"position":4,"name":"filing_date","displayName":"filing date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Date on which the filing was submitted or published.","descriptionSource":"standard_glossary","roles":["time"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":5,"name":"fiscal_quarter","displayName":"fiscal quarter","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: fiscal quarter.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["fiscal_quarter"],"returned":true},{"position":6,"name":"fiscal_year","displayName":"fiscal year","clickhouseType":"Nullable(UInt16)","jsonType":"integer","nullable":true,"description":"Source-normalized field: fiscal year.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["fiscal_year"],"returned":true},{"position":7,"name":"timeframe","displayName":"timeframe","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: timeframe.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":8,"name":"revenue","displayName":"revenue","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: revenue.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"cost_of_revenue","displayName":"cost of revenue","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: cost of revenue.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"gross_profit","displayName":"gross profit","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: gross profit.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"selling_general_administrative","displayName":"selling general administrative","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: selling general administrative.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"research_development","displayName":"research development","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: research development.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"other_operating_expenses","displayName":"other operating expenses","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: other operating expenses.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"total_operating_expenses","displayName":"total operating expenses","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total operating expenses.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"operating_income","displayName":"operating income","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: operating income.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"other_income_expense","displayName":"other income expense","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: other income expense.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"name":"total_other_income_expense","displayName":"total other income expense","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: total other income expense.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":18,"name":"income_before_income_taxes","displayName":"income before income taxes","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: income before income taxes.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":19,"name":"income_taxes","displayName":"income taxes","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: income taxes.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":20,"name":"consolidated_net_income_loss","displayName":"consolidated net income loss","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: consolidated net income loss.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":21,"name":"net_income_loss_attributable_common_shareholders","displayName":"net income loss attributable common shareholders","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: net income loss attributable common shareholders.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":22,"name":"basic_earnings_per_share","displayName":"basic earnings per share","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: basic earnings per share.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":23,"name":"diluted_earnings_per_share","displayName":"diluted earnings per share","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: diluted earnings per share.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":24,"name":"basic_shares_outstanding","displayName":"basic shares outstanding","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: basic shares outstanding.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":25,"name":"diluted_shares_outstanding","displayName":"diluted shares outstanding","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: diluted shares outstanding.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":26,"name":"ebitda","displayName":"ebitda","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: ebitda.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":27,"name":"extra_json","displayName":"extra json","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: extra json.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":28,"name":"publish_ts","displayName":"publish ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC point-in-time availability timestamp used by PIT reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":29,"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":30,"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":31,"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":32,"name":"provider","displayName":"provider","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Upstream data provider identifier.","descriptionSource":"standard_glossary","roles":["filter","provenance"],"filterNames":["provider"],"returned":true},{"position":33,"name":"source_url","displayName":"source url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"URL of the upstream evidence or record when distributable.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":34,"name":"source_record_id","displayName":"source record id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Provider-side identifier for the source record.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":35,"name":"raw_payload_hash","displayName":"raw payload hash","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Opaque fingerprint of the normalized source payload for provenance checks.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":36,"name":"parser_version","displayName":"parser version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Version of the parser or normalizer that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":37,"name":"quality_status","displayName":"quality status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Machine-readable data-quality classification.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":38,"name":"license_scope","displayName":"license scope","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"License or redistribution scope attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":39,"name":"visibility_tier","displayName":"visibility tier","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Serving visibility tier attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":40,"name":"ingest_run_id","displayName":"ingest run id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier of the ingestion run that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":41,"name":"version","displayName":"version","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Monotonic row version used for correction-aware reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":42,"name":"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":43,"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":44,"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":45,"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、period_end、timeframe、fiscal_quarter 定位，主要字段包括 cik、filing_date、fiscal_year、revenue、cost_of_revenue。","useCasesCn":["比较公司财务与分析师预期","构建基本面筛选和历史回测输入"],"grainCn":"每行代表“Massive 利润表”的一条记录；逻辑粒度由 cik × period_end × timeframe 共同确定。","timeSemanticsCn":"以 filing_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常每周随上游披露或批处理更新；不是实时数据。","keyFields":[{"name":"cik","meaningCn":"SEC Central Index Key，用于识别申报主体。"},{"name":"period_end","meaningCn":"用于确定该表业务粒度或默认顺序的 period end 字段。"},{"name":"timeframe","meaningCn":"用于确定该表业务粒度或默认顺序的 timeframe 字段。"},{"name":"ticker","meaningCn":"来源或证券主表使用的股票代码。"},{"name":"fiscal_quarter","meaningCn":"用于确定该表业务粒度或默认顺序的 fiscal quarter 字段。"},{"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":45,"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":"fundamental.indicator","namespace":"fundamental","name":"indicator","coverageTags":["fundamentals"],"description":"Financial indicator metrics.","relation":"fundamental.indicator","objectKind":"table","rowMagnitude":"1M-9M","grain":"instrument_id × report_date × metric","cadence":"weekly","timeColumn":"report_date","defaultOrder":["report_date","code","metric"],"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":"metric","column":"metric","required":false,"multipleValues":true,"jsonType":"string","example":"METRIC_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":26,"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":"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":4,"name":"report_date","displayName":"report date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Reporting-period or statement date.","descriptionSource":"standard_glossary","roles":["time","default_order","warehouse_primary_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":5,"name":"metric","displayName":"metric","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Machine-readable metric name.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["metric"],"returned":true},{"position":6,"name":"value","displayName":"value","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Numeric or source-normalized value for the metric.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"ann_date","displayName":"ann date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Announcement date.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","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","warehouse_primary_key","provenance"],"filterNames":["source"],"returned":true},{"position":9,"name":"publish_ts","displayName":"publish ts","clickhouseType":"Nullable(DateTime64(3, 'UTC'))","jsonType":"string","nullable":true,"description":"UTC point-in-time availability timestamp used by PIT reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":10,"name":"source_ts","displayName":"source ts","clickhouseType":"Nullable(DateTime64(3, 'UTC'))","jsonType":"string","nullable":true,"description":"Timestamp asserted by the upstream source.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":11,"name":"ingested_at","displayName":"ingested at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the source record entered the warehouse.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":12,"name":"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":13,"name":"provider","displayName":"provider","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Upstream data provider identifier.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":14,"name":"source_url","displayName":"source url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"URL of the upstream evidence or record when distributable.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":15,"name":"source_record_id","displayName":"source record id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Provider-side identifier for the source record.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":16,"name":"raw_payload_hash","displayName":"raw payload hash","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Opaque fingerprint of the normalized source payload for provenance checks.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":17,"name":"parser_version","displayName":"parser version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Version of the parser or normalizer that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":18,"name":"quality_status","displayName":"quality status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Machine-readable data-quality classification.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":19,"name":"license_scope","displayName":"license scope","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"License or redistribution scope attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":20,"name":"visibility_tier","displayName":"visibility tier","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Serving visibility tier attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":21,"name":"ingest_run_id","displayName":"ingest run id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier of the ingestion run that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":22,"name":"version","displayName":"version","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Monotonic row version used for correction-aware reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":23,"name":"is_deleted","displayName":"is deleted","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Soft-delete marker; public serving excludes current tombstones.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":24,"name":"created_at","displayName":"created at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was first created.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":25,"name":"updated_at","displayName":"updated at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was last updated.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":26,"name":"publish_ts_source","displayName":"publish ts source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: publish ts source.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true}],"pit":{"supported":true,"asOfRequired":true,"timeColumn":"report_date","keyColumns":["instrument_id","report_date","metric","source"],"maxLimit":1000,"maxWindowDays":400},"titleCn":"财务指标长表","summaryCn":"将常用盈利、增长、偿债和估值指标按证券、报告期与指标名组织，便于横截面筛选。","useCasesCn":["按指标筛选公司","构建多指标因子","比较同行财务质量"],"grainCn":"每行代表“财务指标长表”的一条记录；逻辑粒度由 instrument_id × report_date × metric 共同确定。","timeSemanticsCn":"以 report_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常每周随上游披露或批处理更新；不是实时数据。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"report_date","meaningCn":"财务、持仓或统计报告所属日期。"},{"name":"metric","meaningCn":"长表中的机器可读指标名。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 cursor，结果过大时必须缩小标的、日期或其他筛选。","caveatsCn":["做历史回测时优先使用 PIT 端点并传 as_of，避免把后来披露的数据带回过去。"],"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":"large","identityFilters":["code","metric"],"maxWindowDays":400,"requirement":"identity filter and bounded window","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"fundamental.macro_indicator","namespace":"fundamental","name":"macro_indicator","coverageTags":["fundamentals"],"description":"Canonical Friends financial dataset: 宏观与公司基础指标.","relation":"fundamental.macro_indicator","objectKind":"table","rowMagnitude":"10K-99K","grain":"indicator × country_code × observation_date × period × source","cadence":"quarterly","timeColumn":"publish_ts","defaultOrder":["country_code","indicator","observation_date","period","source"],"filters":[{"name":"period","column":"period","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"provider","column":"provider","required":false,"multipleValues":true,"jsonType":"string","example":"PROVIDER_VALUE"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["country_code","indicator","observation_date","period","source"],"provenanceColumns":[],"fieldCount":26,"fields":[{"position":1,"name":"country_code","displayName":"country code","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: country code.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":2,"name":"country_name","displayName":"country name","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized field: country name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":3,"name":"indicator","displayName":"indicator","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: indicator.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":4,"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":5,"name":"period","displayName":"period","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Reporting or observation period label.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["period"],"returned":true},{"position":6,"name":"value","displayName":"value","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Numeric or source-normalized value for the metric.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"unit","displayName":"unit","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Unit attached to the numeric observation.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"payload_json","displayName":"payload json","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: payload json.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"publish_ts","displayName":"publish ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC point-in-time availability timestamp used by PIT reads.","descriptionSource":"standard_glossary","roles":["time","provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":10,"name":"source_ts","displayName":"source ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"Timestamp asserted by the upstream source.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":11,"name":"ingested_at","displayName":"ingested at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the source record entered the warehouse.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":12,"name":"source","displayName":"source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key","provenance"],"filterNames":["source"],"returned":true},{"position":13,"name":"provider","displayName":"provider","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Upstream data provider identifier.","descriptionSource":"standard_glossary","roles":["filter","provenance"],"filterNames":["provider"],"returned":true},{"position":14,"name":"source_url","displayName":"source url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"URL of the upstream evidence or record when distributable.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":15,"name":"source_record_id","displayName":"source record id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Provider-side identifier for the source record.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":16,"name":"raw_payload_hash","displayName":"raw payload hash","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Opaque fingerprint of the normalized source payload for provenance checks.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":17,"name":"parser_version","displayName":"parser version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Version of the parser or normalizer that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":18,"name":"quality_status","displayName":"quality status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Machine-readable data-quality classification.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":19,"name":"license_scope","displayName":"license scope","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"License or redistribution scope attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":20,"name":"visibility_tier","displayName":"visibility tier","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Serving visibility tier attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":21,"name":"ingest_run_id","displayName":"ingest run id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier of the ingestion run that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":22,"name":"version","displayName":"version","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Monotonic row version used for correction-aware reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":23,"name":"version_ts","displayName":"version ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp associated with the row version.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":24,"name":"is_deleted","displayName":"is deleted","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Soft-delete marker; public serving excludes current tombstones.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":25,"name":"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":26,"name":"updated_at","displayName":"updated at","clickhouseType":"DateTime","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was last updated.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"宏观与公司基础指标","summaryCn":"这是财务报表、估值与分析师预期中的“宏观与公司基础指标”数据集；一行由 country_code、indicator、observation_date、period 定位，主要字段包括 country_name、value、unit、payload_json、publish_ts。","useCasesCn":["比较公司财务与分析师预期","构建基本面筛选和历史回测输入"],"grainCn":"每行代表“宏观与公司基础指标”的一条记录；逻辑粒度由 indicator × country_code × observation_date × period × source 共同确定。","timeSemanticsCn":"以 publish_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常随季度报告或持仓披露更新。","keyFields":[{"name":"indicator","meaningCn":"用于确定该表业务粒度或默认顺序的 indicator 字段。"},{"name":"country_code","meaningCn":"用于确定该表业务粒度或默认顺序的 country code 字段。"},{"name":"observation_date","meaningCn":"observation date 对应的日历日期。"},{"name":"period","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":26,"costGuard":{"tier":"small","identityFilters":[],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"fundamental.patent_grant","namespace":"fundamental","name":"patent_grant","coverageTags":["fundamentals"],"description":"Canonical Friends financial dataset: 企业专利授权.","relation":"fundamental.patent_grant","objectKind":"table","rowMagnitude":"0","grain":"instrument_id × grant_date × patent_id × source","cadence":"producer_schedule","timeColumn":"publish_ts","defaultOrder":["instrument_id","grant_date","patent_id","source"],"filters":[{"name":"instrument_id","column":"instrument_id","required":false,"multipleValues":true,"jsonType":"integer","example":1},{"name":"provider","column":"provider","required":false,"multipleValues":true,"jsonType":"string","example":"PROVIDER_VALUE"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["instrument_id","grant_date","patent_id","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":"assignee_name","displayName":"assignee name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: assignee name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":3,"name":"patent_id","displayName":"patent id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for patent.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":4,"name":"grant_date","displayName":"grant date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for grant date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":5,"name":"application_date","displayName":"application date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for application date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":6,"name":"patent_title","displayName":"patent title","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: patent title.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"patent_type","displayName":"patent type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: patent type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"num_claims","displayName":"num claims","clickhouseType":"Nullable(UInt32)","jsonType":"integer","nullable":true,"description":"Source-normalized field: num claims.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"cited_by_count","displayName":"cited by count","clickhouseType":"Nullable(UInt32)","jsonType":"integer","nullable":true,"description":"Count of cited by count.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"cpc_class","displayName":"cpc class","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: cpc class.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"cpc_subclass","displayName":"cpc subclass","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: cpc subclass.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"cpc_group","displayName":"cpc group","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: cpc group.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"uspc_class","displayName":"uspc class","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: uspc class.","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、grant_date、patent_id、source 定位，主要字段包括 assignee_name、application_date、patent_title、patent_type、num_claims。","useCasesCn":["比较公司财务与分析师预期","构建基本面筛选和历史回测输入"],"grainCn":"每行代表“企业专利授权”的一条记录；逻辑粒度由 instrument_id × grant_date × patent_id × source 共同确定。","timeSemanticsCn":"以 publish_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"grant_date","meaningCn":"grant date 对应的日历日期。"},{"name":"patent_id","meaningCn":"用于识别 patent 的业务标识。"},{"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":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":["instrument_id"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"fundamental.ratios_massive","namespace":"fundamental","name":"ratios_massive","coverageTags":["fundamentals"],"description":"Canonical Friends financial dataset: Massive 财务比率.","relation":"fundamental.ratios_massive","objectKind":"table","rowMagnitude":"10K-99K","grain":"cik × as_of_date","cadence":"weekly","timeColumn":"publish_ts","defaultOrder":["ticker","as_of_date","source"],"filters":[{"name":"cik","column":"cik","required":false,"multipleValues":true,"jsonType":"string","example":"0000320193"},{"name":"provider","column":"provider","required":false,"multipleValues":true,"jsonType":"string","example":"PROVIDER_VALUE"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"},{"name":"ticker","column":"ticker","required":false,"multipleValues":true,"jsonType":"string","example":"AAPL"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["ticker","as_of_date","source"],"provenanceColumns":[],"fieldCount":42,"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":"cik","displayName":"cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC Central Index Key identifying the filer.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["cik"],"returned":true},{"position":3,"name":"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":4,"name":"price","displayName":"price","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: price.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":5,"name":"average_volume","displayName":"average volume","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Quantity for average volume.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"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":7,"name":"enterprise_value","displayName":"enterprise value","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: enterprise value.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"earnings_per_share","displayName":"earnings per share","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: earnings per share.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"price_to_earnings","displayName":"price to earnings","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: price to earnings.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"price_to_book","displayName":"price to book","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: price to book.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"price_to_sales","displayName":"price to sales","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: price to sales.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"price_to_cash_flow","displayName":"price to cash flow","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: price to cash flow.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":13,"name":"price_to_free_cash_flow","displayName":"price to free cash flow","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: price to free cash flow.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":14,"name":"ev_to_sales","displayName":"ev to sales","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: ev to sales.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"ev_to_ebitda","displayName":"ev to ebitda","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: ev to ebitda.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":16,"name":"dividend_yield","displayName":"dividend yield","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: dividend yield.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":17,"name":"return_on_assets","displayName":"return on assets","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: return on assets.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":18,"name":"return_on_equity","displayName":"return on equity","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: return on equity.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":19,"name":"debt_to_equity","displayName":"debt to equity","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: debt to equity.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":20,"name":"current_ratio","displayName":"current ratio","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Ratio value for current ratio.","descriptionSource":"name_derived","roles":[],"filterNames":[],"unit":"ratio","returned":true},{"position":21,"name":"quick_ratio","displayName":"quick ratio","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Ratio value for quick ratio.","descriptionSource":"name_derived","roles":[],"filterNames":[],"unit":"ratio","returned":true},{"position":22,"name":"cash_ratio","displayName":"cash ratio","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Ratio value for cash ratio.","descriptionSource":"name_derived","roles":[],"filterNames":[],"unit":"ratio","returned":true},{"position":23,"name":"free_cash_flow","displayName":"free cash flow","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: free cash flow.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":24,"name":"extra_json","displayName":"extra json","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: extra json.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":25,"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":26,"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":27,"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":28,"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":29,"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":30,"name":"source_url","displayName":"source url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"URL of the upstream evidence or record when distributable.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":31,"name":"source_record_id","displayName":"source record id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Provider-side identifier for the source record.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":32,"name":"raw_payload_hash","displayName":"raw payload hash","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Opaque fingerprint of the normalized source payload for provenance checks.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":33,"name":"parser_version","displayName":"parser version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Version of the parser or normalizer that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":34,"name":"quality_status","displayName":"quality status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Machine-readable data-quality classification.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":35,"name":"license_scope","displayName":"license scope","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"License or redistribution scope attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":36,"name":"visibility_tier","displayName":"visibility tier","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Serving visibility tier attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":37,"name":"ingest_run_id","displayName":"ingest run id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier of the ingestion run that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":38,"name":"version","displayName":"version","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Monotonic row version used for correction-aware reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":39,"name":"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":40,"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":41,"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":42,"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、as_of_date、source 定位，主要字段包括 cik、price、average_volume、market_cap、enterprise_value。","useCasesCn":["比较公司财务与分析师预期","构建基本面筛选和历史回测输入"],"grainCn":"每行代表“Massive 财务比率”的一条记录；逻辑粒度由 cik × as_of_date 共同确定。","timeSemanticsCn":"以 publish_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常每周随上游披露或批处理更新；不是实时数据。","keyFields":[{"name":"cik","meaningCn":"SEC Central Index Key，用于识别申报主体。"},{"name":"as_of_date","meaningCn":"as of date 对应的日历日期。"},{"name":"ticker","meaningCn":"来源或证券主表使用的股票代码。"},{"name":"source","meaningCn":"标准化数据来源；同一业务键可能因来源不同而有多行。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":[],"coverage":{"measured":false,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{},"latestBusinessDate":null,"note":"Recent observed coverage, not a lifetime guarantee. An unmeasured dataset carries no support claim in either direction."},"identifier":{"namespace":"mixed","formatByMarket":{},"storesZeroPaddedHkCode":false,"stableJoinKey":"instrument_id","resolverPath":"/api/v1/data/instruments/resolve"},"sparseSemantics":null,"emptyResultCodes":["VALID_EMPTY","NOT_IN_RANKING","UNSUPPORTED_MARKET","STALE_SOURCE","NO_MATCH","IDENTIFIER_INVALID","COVERAGE_UNKNOWN","PARTIAL_UNIVERSE"],"publication":{"published":true,"reason":null,"projectionReviewed":true},"returnedFieldCount":42,"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":"fundamental.risk_factor_massive","namespace":"fundamental","name":"risk_factor_massive","coverageTags":["fundamentals"],"description":"Categorized 10-K/10-Q risk-factor extractions keyed by ticker/CIK and filing date.","relation":"fundamental.risk_factor_massive","objectKind":"table","rowMagnitude":"100K-999K","grain":"cik × filing_date × primary_category","cadence":"weekly","timeColumn":"filing_date","defaultOrder":["filing_date","ticker","primary_category"],"filters":[{"name":"cik","column":"cik","required":false,"multipleValues":true,"jsonType":"string","example":"0000320193"},{"name":"primary_category","column":"primary_category","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"secondary_category","column":"secondary_category","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_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":false,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"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"],"filterNames":["ticker"],"returned":true},{"position":2,"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":3,"name":"filing_date","displayName":"filing date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Date on which the filing was submitted or published.","descriptionSource":"standard_glossary","roles":["time","default_order","warehouse_primary_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":4,"name":"primary_category","displayName":"primary category","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: primary category.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["primary_category"],"returned":true},{"position":5,"name":"secondary_category","displayName":"secondary category","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: secondary category.","descriptionSource":"name_derived","roles":["filter","warehouse_primary_key"],"filterNames":["secondary_category"],"returned":true},{"position":6,"name":"tertiary_category","displayName":"tertiary category","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: tertiary category.","descriptionSource":"name_derived","roles":["warehouse_primary_key"],"filterNames":[],"returned":true},{"position":7,"name":"supporting_text","displayName":"supporting text","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: supporting text.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":false,"withheldReason":"internal body/object-path/raw-payload surface; retrieval requires a separate entitled endpoint"},{"position":8,"name":"publish_ts","displayName":"publish ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC point-in-time availability timestamp used by PIT reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":9,"name":"source_ts","displayName":"source ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"Timestamp asserted by the upstream source.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":10,"name":"ingested_at","displayName":"ingested at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the source record entered the warehouse.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":11,"name":"source","displayName":"source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["filter","warehouse_primary_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":["provenance"],"filterNames":[],"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":["warehouse_primary_key","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":"SEC 风险因素分类","summaryCn":"从 10-K 和 10-Q 的 Risk Factors 中抽取文本并归入主要风险类别，保留公司和申报日期。","useCasesCn":["比较公司风险披露变化","检索特定风险主题","构建风险文本特征"],"grainCn":"每行代表“SEC 风险因素分类”的一条记录；逻辑粒度由 cik × filing_date × primary_category 共同确定。","timeSemanticsCn":"以 filing_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常每周随上游披露或批处理更新；不是实时数据。","keyFields":[{"name":"cik","meaningCn":"SEC Central Index Key，用于识别申报主体。"},{"name":"filing_date","meaningCn":"申报提交或公开日期。"},{"name":"primary_category","meaningCn":"用于确定该表业务粒度或默认顺序的 primary category 字段。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 cursor，结果过大时必须缩小标的、日期或其他筛选。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":[],"coverage":{"measured":false,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{},"latestBusinessDate":null,"note":"Recent observed coverage, not a lifetime guarantee. An unmeasured dataset carries no support claim in either direction."},"identifier":{"namespace":"mixed","formatByMarket":{},"storesZeroPaddedHkCode":false,"stableJoinKey":"instrument_id","resolverPath":"/api/v1/data/instruments/resolve"},"sparseSemantics":null,"emptyResultCodes":["VALID_EMPTY","NOT_IN_RANKING","UNSUPPORTED_MARKET","STALE_SOURCE","NO_MATCH","IDENTIFIER_INVALID","COVERAGE_UNKNOWN","PARTIAL_UNIVERSE"],"publication":{"published":true,"reason":null,"projectionReviewed":true},"returnedFieldCount":24,"costGuard":{"tier":"medium","identityFilters":["cik","ticker"],"maxWindowDays":400,"requirement":"identity filter or bounded window","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"DENIED","deniedSources":["massive"],"reasons":["restricted_license_scope","restricted_visibility_tier"]}},{"object":"dataset_schema","asset":"fundamental.shares_outstanding_pit","namespace":"fundamental","name":"shares_outstanding_pit","coverageTags":["fundamentals"],"description":"Canonical Friends financial dataset: 历史时点流通股本.","relation":"fundamental.shares_outstanding_pit","objectKind":"table","rowMagnitude":"10K-99K","grain":"instrument_id × observation_date × source","cadence":"producer_schedule","timeColumn":"publish_ts","defaultOrder":["instrument_id","observation_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"},{"name":"ticker","column":"ticker","required":false,"multipleValues":true,"jsonType":"string","example":"TICKER","exampleSource":"identifier_format"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["instrument_id","observation_date","source"],"provenanceColumns":[],"fieldCount":22,"fields":[{"position":1,"name":"instrument_id","displayName":"instrument id","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"WarrenHub canonical instrument identifier; use it for cross-dataset joins.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["instrument_id"],"returned":true},{"position":2,"name":"ticker","displayName":"ticker","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Ticker symbol reported by the source or mapped security master.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["ticker"],"returned":true},{"position":3,"name":"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":"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":5,"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":6,"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":7,"name":"publish_ts","displayName":"publish ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC point-in-time availability timestamp used by PIT reads.","descriptionSource":"standard_glossary","roles":["time","provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":8,"name":"source_ts","displayName":"source ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"Timestamp asserted by the upstream source.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":9,"name":"ingested_at","displayName":"ingested at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the source record entered the warehouse.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":10,"name":"source","displayName":"source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key","provenance"],"filterNames":["source"],"returned":true},{"position":11,"name":"provider","displayName":"provider","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Upstream data provider identifier.","descriptionSource":"standard_glossary","roles":["filter","provenance"],"filterNames":["provider"],"returned":true},{"position":12,"name":"source_url","displayName":"source url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"URL of the upstream evidence or record when distributable.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":13,"name":"source_record_id","displayName":"source record id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Provider-side identifier for the source record.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":14,"name":"raw_payload_hash","displayName":"raw payload hash","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Opaque fingerprint of the normalized source payload for provenance checks.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":15,"name":"parser_version","displayName":"parser version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Version of the parser or normalizer that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":16,"name":"quality_status","displayName":"quality status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Machine-readable data-quality classification.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":17,"name":"license_scope","displayName":"license scope","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"License or redistribution scope attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":18,"name":"visibility_tier","displayName":"visibility tier","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Serving visibility tier attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":19,"name":"ingest_run_id","displayName":"ingest run id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier of the ingestion run that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":20,"name":"version","displayName":"version","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Monotonic row version used for correction-aware reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":21,"name":"version_ts","displayName":"version ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp associated with the row version.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":22,"name":"is_deleted","displayName":"is deleted","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Soft-delete marker; public serving excludes current tombstones.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true}],"pit":null,"titleCn":"历史时点流通股本","summaryCn":"这是财务报表、估值与分析师预期中的“历史时点流通股本”数据集；一行由 instrument_id、observation_date、source 定位，主要字段包括 ticker、market、weighted_shares_outstanding、share_class_shares_outstanding、publish_ts。","useCasesCn":["比较公司财务与分析师预期","构建基本面筛选和历史回测输入"],"grainCn":"每行代表“历史时点流通股本”的一条记录；逻辑粒度由 instrument_id × observation_date × source 共同确定。","timeSemanticsCn":"以 publish_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"observation_date","meaningCn":"observation 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-23","rows":3884}},"latestBusinessDate":"2026-08-23","note":"Recent observed coverage, not a lifetime guarantee. An unmeasured dataset carries no support claim in either direction."},"identifier":{"namespace":"us_ticker","formatByMarket":{"US":"TICKER"},"storesZeroPaddedHkCode":false,"stableJoinKey":"instrument_id","resolverPath":"/api/v1/data/instruments/resolve"},"sparseSemantics":null,"emptyResultCodes":["VALID_EMPTY","NOT_IN_RANKING","UNSUPPORTED_MARKET","STALE_SOURCE","NO_MATCH","IDENTIFIER_INVALID","COVERAGE_UNKNOWN","PARTIAL_UNIVERSE"],"publication":{"published":true,"reason":null,"projectionReviewed":true},"returnedFieldCount":22,"costGuard":{"tier":"small","identityFilters":["instrument_id","ticker"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"fundamental.shares_outstanding_sec_pit","namespace":"fundamental","name":"shares_outstanding_sec_pit","coverageTags":["fundamentals"],"description":"Canonical Friends financial dataset: SEC 历史时点股本.","relation":"fundamental.shares_outstanding_sec_pit","objectKind":"table","rowMagnitude":"10K-99K","grain":"instrument_id × observation_date × source","cadence":"producer_schedule","timeColumn":"publish_ts","defaultOrder":["instrument_id","observation_date","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":["instrument_id","observation_date","source"],"provenanceColumns":[],"fieldCount":26,"fields":[{"position":1,"name":"instrument_id","displayName":"instrument id","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"WarrenHub canonical instrument identifier; use it for cross-dataset joins.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["instrument_id"],"returned":true},{"position":2,"name":"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":"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":"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":5,"name":"accn","displayName":"accn","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: accn.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"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":7,"name":"publish_date","displayName":"publish date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for publish date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":8,"name":"publish_is_fallback","displayName":"publish is fallback","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Source-normalized field: publish is fallback.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"shares_outstanding","displayName":"shares outstanding","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Source-normalized field: shares outstanding.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"entity_name","displayName":"entity name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: entity name.","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}],"pit":null,"titleCn":"SEC 历史时点股本","summaryCn":"这是财务报表、估值与分析师预期中的“SEC 历史时点股本”数据集；一行由 instrument_id、observation_date、source 定位，主要字段包括 ticker、market、cik、accn、publish_date。","useCasesCn":["比较公司财务与分析师预期","构建基本面筛选和历史回测输入"],"grainCn":"每行代表“SEC 历史时点股本”的一条记录；逻辑粒度由 instrument_id × observation_date × source 共同确定。","timeSemanticsCn":"以 publish_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"instrument_id","meaningCn":"WarrenHub 统一证券标识；跨证券数据集优先用它联接。"},{"name":"observation_date","meaningCn":"observation 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-05","rows":17584}},"latestBusinessDate":"2026-08-05","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":26,"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":"fundamental.xbrl_fact","namespace":"fundamental","name":"xbrl_fact","coverageTags":["fundamentals"],"description":"XBRL fact table.","relation":"fundamental.xbrl_fact","objectKind":"table","rowMagnitude":"10M-99M","grain":"entity_id × concept × period_end","cadence":"daily","timeColumn":"period_end","defaultOrder":["period_end","entity_id","concept"],"filters":[{"name":"accession_no","column":"accession_no","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"concept","column":"concept","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"entity_id","column":"entity_id","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"taxonomy","column":"taxonomy","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":false,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":26,"fields":[{"position":1,"name":"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":"accession_no","displayName":"accession no","clickhouseType":"String","jsonType":"string","nullable":false,"description":"SEC accession number identifying one filing submission.","descriptionSource":"standard_glossary","roles":["filter","warehouse_primary_key"],"filterNames":["accession_no"],"returned":true},{"position":3,"name":"taxonomy","displayName":"taxonomy","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: taxonomy.","descriptionSource":"name_derived","roles":["filter","warehouse_primary_key"],"filterNames":["taxonomy"],"returned":true},{"position":4,"name":"concept","displayName":"concept","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: concept.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["concept"],"returned":true},{"position":5,"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":6,"name":"period_end","displayName":"period end","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Source-normalized field: period end.","descriptionSource":"name_derived","roles":["time","default_order","warehouse_primary_key"],"filterNames":[],"jsonFormat":"date","returned":true},{"position":7,"name":"filing_date","displayName":"filing date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Date on which the filing was submitted or published.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":8,"name":"fiscal_year","displayName":"fiscal year","clickhouseType":"Nullable(Int32)","jsonType":"integer","nullable":true,"description":"Source-normalized field: fiscal year.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"fiscal_period","displayName":"fiscal period","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: fiscal period.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"unit","displayName":"unit","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Unit attached to the numeric observation.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":11,"name":"value","displayName":"value","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Numeric or source-normalized value for the metric.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"dimensions_hash","displayName":"dimensions hash","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: dimensions hash.","descriptionSource":"name_derived","roles":["warehouse_primary_key"],"filterNames":[],"returned":true},{"position":13,"name":"source","displayName":"source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":14,"name":"provider","displayName":"provider","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Upstream data provider identifier.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":15,"name":"source_url","displayName":"source url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"URL of the upstream evidence or record when distributable.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":16,"name":"source_record_id","displayName":"source record id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Provider-side identifier for the source record.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":17,"name":"raw_payload_hash","displayName":"raw payload hash","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Opaque fingerprint of the normalized source payload for provenance checks.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":18,"name":"parser_version","displayName":"parser version","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Version of the parser or normalizer that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":19,"name":"quality_status","displayName":"quality status","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Machine-readable data-quality classification.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":20,"name":"license_scope","displayName":"license scope","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"License or redistribution scope attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":21,"name":"visibility_tier","displayName":"visibility tier","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Serving visibility tier attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":22,"name":"ingest_run_id","displayName":"ingest run id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier of the ingestion run that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":23,"name":"version","displayName":"version","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Monotonic row version used for correction-aware reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":24,"name":"is_deleted","displayName":"is deleted","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Soft-delete marker; public serving excludes current tombstones.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":25,"name":"created_at","displayName":"created at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was first created.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":26,"name":"updated_at","displayName":"updated at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was last updated.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"XBRL 财务事实","summaryCn":"以实体、XBRL concept 和期间为粒度保存原子财务事实，适合需要精确科目与维度的研究。","useCasesCn":["查询特定 XBRL 科目","自定义财务报表映射","核对标准化财务指标来源"],"grainCn":"每行代表“XBRL 财务事实”的一条记录；逻辑粒度由 entity_id × concept × period_end 共同确定。","timeSemanticsCn":"以 period_end 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"entity_id","meaningCn":"用于识别 entity 的业务标识。"},{"name":"concept","meaningCn":"用于确定该表业务粒度或默认顺序的 concept 字段。"},{"name":"period_end","meaningCn":"用于确定该表业务粒度或默认顺序的 period end 字段。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 cursor，结果过大时必须缩小标的、日期或其他筛选。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":[],"coverage":{"measured":false,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{},"latestBusinessDate":null,"note":"Recent observed coverage, not a lifetime guarantee. An unmeasured dataset carries no support claim in either direction."},"identifier":{"namespace":"mixed","formatByMarket":{},"storesZeroPaddedHkCode":false,"stableJoinKey":"instrument_id","resolverPath":"/api/v1/data/instruments/resolve"},"sparseSemantics":null,"emptyResultCodes":["VALID_EMPTY","NOT_IN_RANKING","UNSUPPORTED_MARKET","STALE_SOURCE","NO_MATCH","IDENTIFIER_INVALID","COVERAGE_UNKNOWN","PARTIAL_UNIVERSE"],"publication":{"published":true,"reason":null,"projectionReviewed":true},"returnedFieldCount":26,"costGuard":{"tier":"large","identityFilters":["accession_no"],"maxWindowDays":400,"requirement":"identity filter and bounded window","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"fundamental.xbrl_fact_with_ticker","namespace":"fundamental","name":"xbrl_fact_with_ticker","coverageTags":["fundamentals"],"description":"Canonical Friends financial dataset: 带股票代码的 XBRL 财务事实.","relation":"fundamental.v_xbrl_fact_with_ticker","objectKind":"view","rowMagnitude":"view","grain":"entity_id × accession_no × taxonomy × concept × period_end × unit × dimensions_hash × source_record_id","cadence":"producer_schedule","timeColumn":"period_end","defaultOrder":["entity_id","accession_no","taxonomy","concept","period_end","unit","dimensions_hash","source_record_id"],"filters":[{"name":"accession_no","column":"accession_no","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"fiscal_year","column":"fiscal_year","required":false,"multipleValues":true,"jsonType":"integer","example":"FILTER_VALUE"},{"name":"provider","column":"provider","required":false,"multipleValues":true,"jsonType":"string","example":"PROVIDER_VALUE"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"relation_default","contractVersion":null,"uniqueKey":["entity_id","accession_no","taxonomy","concept","period_end","unit","dimensions_hash","source_record_id"],"provenanceColumns":[],"fieldCount":31,"fields":[{"position":1,"name":"entity_id","displayName":"entity id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for entity.","descriptionSource":"name_derived","roles":["default_order","contract_unique_key"],"filterNames":[],"returned":true},{"position":2,"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","contract_unique_key"],"filterNames":["accession_no"],"returned":true},{"position":3,"name":"taxonomy","displayName":"taxonomy","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: taxonomy.","descriptionSource":"name_derived","roles":["default_order","contract_unique_key"],"filterNames":[],"returned":true},{"position":4,"name":"concept","displayName":"concept","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: concept.","descriptionSource":"name_derived","roles":["default_order","contract_unique_key"],"filterNames":[],"returned":true},{"position":5,"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":6,"name":"period_end","displayName":"period end","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Source-normalized field: period end.","descriptionSource":"name_derived","roles":["time","default_order","contract_unique_key"],"filterNames":[],"jsonFormat":"date","returned":true},{"position":7,"name":"filing_date","displayName":"filing date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Date on which the filing was submitted or published.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":8,"name":"fiscal_year","displayName":"fiscal year","clickhouseType":"Nullable(Int32)","jsonType":"integer","nullable":true,"description":"Source-normalized field: fiscal year.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["fiscal_year"],"returned":true},{"position":9,"name":"fiscal_period","displayName":"fiscal period","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: fiscal period.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"unit","displayName":"unit","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Unit attached to the numeric observation.","descriptionSource":"standard_glossary","roles":["default_order","contract_unique_key"],"filterNames":[],"returned":true},{"position":11,"name":"value","displayName":"value","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Numeric or source-normalized value for the metric.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":12,"name":"dimensions_hash","displayName":"dimensions hash","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: dimensions hash.","descriptionSource":"name_derived","roles":["default_order","contract_unique_key"],"filterNames":[],"returned":true},{"position":13,"name":"source","displayName":"source","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["filter","provenance"],"filterNames":["source"],"returned":true},{"position":14,"name":"provider","displayName":"provider","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Upstream data provider identifier.","descriptionSource":"standard_glossary","roles":["filter","provenance"],"filterNames":["provider"],"returned":true},{"position":15,"name":"source_url","displayName":"source url","clickhouseType":"String","jsonType":"string","nullable":false,"description":"URL of the upstream evidence or record when distributable.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":16,"name":"source_record_id","displayName":"source record id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Provider-side identifier for the source record.","descriptionSource":"standard_glossary","roles":["default_order","contract_unique_key","provenance"],"filterNames":[],"returned":true},{"position":17,"name":"raw_payload_hash","displayName":"raw payload hash","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Opaque fingerprint of the normalized source payload for provenance checks.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":18,"name":"parser_version","displayName":"parser version","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Version of the parser or normalizer that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":19,"name":"quality_status","displayName":"quality status","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Machine-readable data-quality classification.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":20,"name":"license_scope","displayName":"license scope","clickhouseType":"String","jsonType":"string","nullable":false,"description":"License or redistribution scope attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":21,"name":"visibility_tier","displayName":"visibility tier","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Serving visibility tier attached to the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":22,"name":"ingest_run_id","displayName":"ingest run id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier of the ingestion run that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":23,"name":"version","displayName":"version","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Monotonic row version used for correction-aware reads.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":24,"name":"is_deleted","displayName":"is deleted","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Soft-delete marker; public serving excludes current tombstones.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":25,"name":"created_at","displayName":"created at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was first created.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":26,"name":"updated_at","displayName":"updated at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was last updated.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":27,"name":"mapped_ticker","displayName":"mapped ticker","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: mapped ticker.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":28,"name":"mapped_instrument_id","displayName":"mapped instrument id","clickhouseType":"UInt64","jsonType":"integer","nullable":false,"description":"Identifier for mapped instrument.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":29,"name":"ticker_mapping_status","displayName":"ticker mapping status","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: ticker mapping status.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":30,"name":"ticker_pit_status","displayName":"ticker pit status","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: ticker pit status.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":31,"name":"ticker_mapping_confidence","displayName":"ticker mapping confidence","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: ticker mapping confidence.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true}],"pit":null,"titleCn":"带股票代码的 XBRL 财务事实","summaryCn":"这是财务报表、估值与分析师预期中的“带股票代码的 XBRL 财务事实”数据集；一行由 entity_id、accession_no、taxonomy、concept 定位，主要字段包括 period_start、period_end、fiscal_year、fiscal_period、unit。","useCasesCn":["比较公司财务与分析师预期","构建基本面筛选和历史回测输入"],"grainCn":"每行代表“带股票代码的 XBRL 财务事实”的一条记录；逻辑粒度由 entity_id × accession_no × taxonomy × concept × period_end × unit × dimensions_hash × source_record_id 共同确定。","timeSemanticsCn":"以 period_end 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"entity_id","meaningCn":"用于识别 entity 的业务标识。"},{"name":"accession_no","meaningCn":"SEC 对单次申报分配的唯一 accession number。"},{"name":"taxonomy","meaningCn":"用于确定该表业务粒度或默认顺序的 taxonomy 字段。"},{"name":"concept","meaningCn":"用于确定该表业务粒度或默认顺序的 concept 字段。"},{"name":"period_end","meaningCn":"用于确定该表业务粒度或默认顺序的 period end 字段。"},{"name":"unit","meaningCn":"用于确定该表业务粒度或默认顺序的 unit 字段。"}],"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":31,"costGuard":{"tier":"small","identityFilters":["accession_no"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"fundamental.xbrl_metric_normalized","namespace":"fundamental","name":"xbrl_metric_normalized","coverageTags":["fundamentals"],"description":"Canonical Friends financial dataset: 标准化 XBRL 财务指标.","relation":"fundamental.xbrl_metric_normalized","objectKind":"table","rowMagnitude":"1M-9M","grain":"entity_id × metric × period_end","cadence":"weekly","timeColumn":"filing_date","defaultOrder":["entity_id","metric","period_end","fiscal_period","accession_no","source_fact_record_id"],"filters":[{"name":"accession_no","column":"accession_no","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"fiscal_year","column":"fiscal_year","required":false,"multipleValues":true,"jsonType":"integer","example":"FILTER_VALUE"},{"name":"instrument_id","column":"instrument_id","required":false,"multipleValues":true,"jsonType":"integer","example":1},{"name":"market","column":"market","required":false,"multipleValues":true,"jsonType":"string","example":"US"},{"name":"metric","column":"metric","required":false,"multipleValues":true,"jsonType":"string","example":"METRIC_VALUE"},{"name":"period_type","column":"period_type","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"provider","column":"provider","required":false,"multipleValues":true,"jsonType":"string","example":"PROVIDER_VALUE"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"},{"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":["entity_id","metric","period_end","fiscal_period","accession_no","source_fact_record_id"],"provenanceColumns":[],"fieldCount":36,"fields":[{"position":1,"name":"entity_id","displayName":"entity id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for entity.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":2,"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":3,"name":"ticker","displayName":"ticker","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Ticker symbol reported by the source or mapped security master.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["ticker"],"returned":true},{"position":4,"name":"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":"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":6,"name":"metric","displayName":"metric","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Machine-readable metric name.","descriptionSource":"standard_glossary","roles":["filter","default_order","warehouse_primary_key","contract_unique_key"],"filterNames":["metric"],"returned":true},{"position":7,"name":"statement_type","displayName":"statement type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: statement type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"taxonomy","displayName":"taxonomy","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: taxonomy.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"source_concept","displayName":"source concept","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: source concept.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"concept_priority","displayName":"concept priority","clickhouseType":"UInt16","jsonType":"integer","nullable":false,"description":"Source-normalized field: concept priority.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":11,"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":12,"name":"period_end","displayName":"period end","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Source-normalized field: period end.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","returned":true},{"position":13,"name":"filing_date","displayName":"filing date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Date on which the filing was submitted or published.","descriptionSource":"standard_glossary","roles":["time"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":14,"name":"fiscal_year","displayName":"fiscal year","clickhouseType":"Nullable(Int32)","jsonType":"integer","nullable":true,"description":"Source-normalized field: fiscal year.","descriptionSource":"name_derived","roles":["filter"],"filterNames":["fiscal_year"],"returned":true},{"position":15,"name":"fiscal_period","displayName":"fiscal period","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: fiscal period.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":16,"name":"period_type","displayName":"period type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Reporting-period classification such as annual or quarterly.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["period_type"],"returned":true},{"position":17,"name":"unit","displayName":"unit","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Unit attached to the numeric observation.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":18,"name":"normalized_unit","displayName":"normalized unit","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: normalized unit.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":19,"name":"value","displayName":"value","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Numeric or source-normalized value for the metric.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":20,"name":"metric_value","displayName":"metric value","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: metric value.","descriptionSource":"name_derived","roles":[],"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":"quality_reason","displayName":"quality reason","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: quality reason.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":23,"name":"source_fact_record_id","displayName":"source fact record id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier for source fact record.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":24,"name":"source","displayName":"source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["filter","provenance"],"filterNames":["source"],"returned":true},{"position":25,"name":"provider","displayName":"provider","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Upstream data provider identifier.","descriptionSource":"standard_glossary","roles":["filter","provenance"],"filterNames":["provider"],"returned":true},{"position":26,"name":"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":27,"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":28,"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":29,"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":30,"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":31,"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":32,"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":33,"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":34,"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":35,"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":36,"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":"标准化 XBRL 财务指标","summaryCn":"这是财务报表、估值与分析师预期中的“标准化 XBRL 财务指标”数据集；一行由 entity_id、metric、period_end、fiscal_period 定位，主要字段包括 accession_no、ticker、market、instrument_id、statement_type。","useCasesCn":["比较公司财务与分析师预期","构建基本面筛选和历史回测输入"],"grainCn":"每行代表“标准化 XBRL 财务指标”的一条记录；逻辑粒度由 entity_id × metric × period_end 共同确定。","timeSemanticsCn":"以 filing_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常每周随上游披露或批处理更新；不是实时数据。","keyFields":[{"name":"entity_id","meaningCn":"用于识别 entity 的业务标识。"},{"name":"metric","meaningCn":"长表中的机器可读指标名。"},{"name":"period_end","meaningCn":"用于确定该表业务粒度或默认顺序的 period end 字段。"},{"name":"fiscal_period","meaningCn":"用于确定该表业务粒度或默认顺序的 fiscal period 字段。"},{"name":"accession_no","meaningCn":"SEC 对单次申报分配的唯一 accession number。"},{"name":"source_fact_record_id","meaningCn":"用于识别 source fact record 的业务标识。"}],"joins":[{"dataset":"ref.instrument","on":"instrument_id","guidanceCn":"用 instrument_id 补充证券代码、名称、市场、交易所和资产类型。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":[],"coverage":{"measured":true,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{},"latestBusinessDate":null,"note":"Recent observed coverage, not a lifetime guarantee. An unmeasured dataset carries no support claim in either direction."},"identifier":{"namespace":"mixed","formatByMarket":{},"storesZeroPaddedHkCode":false,"stableJoinKey":"instrument_id","resolverPath":"/api/v1/data/instruments/resolve"},"sparseSemantics":null,"emptyResultCodes":["VALID_EMPTY","NOT_IN_RANKING","UNSUPPORTED_MARKET","STALE_SOURCE","NO_MATCH","IDENTIFIER_INVALID","COVERAGE_UNKNOWN","PARTIAL_UNIVERSE"],"publication":{"published":true,"reason":null,"projectionReviewed":true},"returnedFieldCount":36,"costGuard":{"tier":"small","identityFilters":["accession_no","instrument_id","metric","ticker"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}}]}