{"$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":"ownership","description":"机构与内部人持仓、申报和交易。","datasetCount":4,"fieldCount":105,"datasets":[{"object":"dataset_schema","asset":"ownership.13f","namespace":"ownership","name":"13f","coverageTags":["ownership"],"description":"Institutional 13F holdings.","relation":"ownership.13f","objectKind":"table","rowMagnitude":"1M-9M","grain":"manager_cik × cusip × report_date","cadence":"quarterly","timeColumn":"report_date","defaultOrder":["report_date","manager_cik","cusip"],"filters":[{"name":"code","column":"code","required":false,"multipleValues":true,"jsonType":"string","example":"AAPL"},{"name":"cusip","column":"cusip","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"manager_cik","column":"manager_cik","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":24,"fields":[{"position":1,"name":"report_date","displayName":"report date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Reporting-period or statement date.","descriptionSource":"standard_glossary","roles":["time","default_order","warehouse_primary_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":2,"name":"manager_cik","displayName":"manager cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: manager cik.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["manager_cik"],"returned":true},{"position":3,"name":"cusip","displayName":"cusip","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: cusip.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["cusip"],"returned":true},{"position":4,"name":"code","displayName":"code","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized security or contract code.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["code"],"returned":true},{"position":5,"name":"issuer_name","displayName":"issuer name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: issuer name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"class_title","displayName":"class title","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: class title.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"value_usd","displayName":"value usd","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"US-dollar value for value usd.","descriptionSource":"name_derived","roles":[],"filterNames":[],"unit":"USD","returned":true},{"position":8,"name":"shares","displayName":"shares","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: shares.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"share_type","displayName":"share type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: share type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"put_call","displayName":"put call","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: put call.","descriptionSource":"name_derived","roles":[],"filterNames":[],"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":["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":"is_deleted","displayName":"is deleted","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Soft-delete marker; public serving excludes current tombstones.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":23,"name":"created_at","displayName":"created at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was first created.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":24,"name":"updated_at","displayName":"updated at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was last updated.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"机构 13F 持仓","summaryCn":"按机构 CIK、CUSIP 和报告期保存 13F 持仓数量与市值，用于追踪美国机构季度配置。","useCasesCn":["查看基金重仓股","比较机构季度增减持","聚合某证券的机构所有权"],"grainCn":"每行代表“机构 13F 持仓”的一条记录；逻辑粒度由 manager_cik × cusip × report_date 共同确定。","timeSemanticsCn":"以 report_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常随季度报告或持仓披露更新。","keyFields":[{"name":"manager_cik","meaningCn":"用于确定该表业务粒度或默认顺序的 manager cik 字段。"},{"name":"cusip","meaningCn":"用于确定该表业务粒度或默认顺序的 cusip 字段。"},{"name":"report_date","meaningCn":"财务、持仓或统计报告所属日期。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 cursor，结果过大时必须缩小标的、日期或其他筛选。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":[],"coverage":{"measured":false,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{},"latestBusinessDate":null,"note":"Recent observed coverage, not a lifetime guarantee. An unmeasured dataset carries no support claim in either direction."},"identifier":{"namespace":"mixed","formatByMarket":{},"storesZeroPaddedHkCode":false,"stableJoinKey":"instrument_id","resolverPath":"/api/v1/data/instruments/resolve"},"sparseSemantics":null,"emptyResultCodes":["VALID_EMPTY","NOT_IN_RANKING","UNSUPPORTED_MARKET","STALE_SOURCE","NO_MATCH","IDENTIFIER_INVALID","COVERAGE_UNKNOWN","PARTIAL_UNIVERSE"],"publication":{"published":true,"reason":null,"projectionReviewed":true},"returnedFieldCount":24,"costGuard":{"tier":"small","identityFilters":["code","manager_cik"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"ownership.13f_fmp","namespace":"ownership","name":"13f_fmp","coverageTags":["ownership"],"description":"Canonical Friends financial dataset: FMP 机构 13F 持仓.","relation":"ownership.13f_fmp","objectKind":"table","rowMagnitude":"10M-99M","grain":"manager_cik × period_of_report × security_cusip × put_call_share × shares_type × symbol","cadence":"producer_schedule","timeColumn":"filing_date","defaultOrder":["manager_cik","period_of_report","security_cusip","put_call_share","shares_type"],"filters":[{"name":"provider","column":"provider","required":false,"multipleValues":true,"jsonType":"string","example":"PROVIDER_VALUE"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"},{"name":"symbol","column":"symbol","required":true,"multipleValues":true,"jsonType":"string","example":"AAPL"}],"maxLimit":5000,"maxWindowDays":400,"supportsCursor":true,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":["manager_cik","period_of_report","security_cusip","put_call_share","shares_type"],"provenanceColumns":[],"fieldCount":21,"fields":[{"position":1,"name":"manager_cik","displayName":"manager cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: manager cik.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":2,"name":"period_of_report","displayName":"period of report","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Source-normalized field: period of report.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"jsonFormat":"date","returned":true},{"position":3,"name":"filing_date","displayName":"filing date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Date on which the filing was submitted or published.","descriptionSource":"standard_glossary","roles":["time"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":4,"name":"accepted_date","displayName":"accepted date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Calendar date for accepted date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":5,"name":"security_cusip","displayName":"security cusip","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: security cusip.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":6,"name":"symbol","displayName":"symbol","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Display or trading symbol for the instrument.","descriptionSource":"standard_glossary","roles":["filter","required_filter"],"filterNames":["symbol"],"returned":true},{"position":7,"name":"name_of_issuer","displayName":"name of issuer","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: name of issuer.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"title_of_class","displayName":"title of class","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: title of class.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"shares","displayName":"shares","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"Source-normalized field: shares.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"shares_type","displayName":"shares type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: shares type.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":11,"name":"put_call_share","displayName":"put call share","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: put call share.","descriptionSource":"name_derived","roles":["default_order","warehouse_primary_key","contract_unique_key"],"filterNames":[],"returned":true},{"position":12,"name":"value_usd","displayName":"value usd","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"US-dollar value for value usd.","descriptionSource":"name_derived","roles":[],"filterNames":[],"unit":"USD","returned":true},{"position":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":"final_link","displayName":"final link","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: final link.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":15,"name":"source","displayName":"source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["filter","provenance"],"filterNames":["source"],"returned":true},{"position":16,"name":"provider","displayName":"provider","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Upstream data provider identifier.","descriptionSource":"standard_glossary","roles":["filter","provenance"],"filterNames":["provider"],"returned":true},{"position":17,"name":"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":"ingest_run_id","displayName":"ingest run id","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Identifier of the ingestion run that produced the row.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"returned":true},{"position":19,"name":"version_ts","displayName":"version ts","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp associated with the row version.","descriptionSource":"standard_glossary","roles":["provenance"],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":20,"name":"is_deleted","displayName":"is deleted","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Soft-delete marker; public serving excludes current tombstones.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":21,"name":"created_at","displayName":"created at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was first created.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"FMP 机构 13F 持仓","summaryCn":"这是机构及内部人持仓中的“FMP 机构 13F 持仓”数据集；一行由 manager_cik、period_of_report、security_cusip、put_call_share 定位，主要字段包括 filing_date、accepted_date、symbol、name_of_issuer、title_of_class。","useCasesCn":["分析机构和内部人持仓","跟踪报告期之间的持仓变化"],"grainCn":"每行代表“FMP 机构 13F 持仓”的一条记录；逻辑粒度由 manager_cik × period_of_report × security_cusip × put_call_share × shares_type × symbol 共同确定。","timeSemanticsCn":"以 filing_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"manager_cik","meaningCn":"用于确定该表业务粒度或默认顺序的 manager cik 字段。"},{"name":"period_of_report","meaningCn":"用于确定该表业务粒度或默认顺序的 period of report 字段。"},{"name":"security_cusip","meaningCn":"用于确定该表业务粒度或默认顺序的 security cusip 字段。"},{"name":"put_call_share","meaningCn":"用于确定该表业务粒度或默认顺序的 put call share 字段。"},{"name":"shares_type","meaningCn":"用于确定该表业务粒度或默认顺序的 shares type 字段。"},{"name":"symbol","meaningCn":"证券或交易对的展示代码。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；必须提供 symbol；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["该关系数据量较大，必须提供 symbol；这只限制单次扫描，不减少可访问历史。","单次请求的 start/end 最长 400 天；全历史请按时间窗连续分页。"],"supportedMarkets":[],"coverage":{"measured":false,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{},"latestBusinessDate":null,"note":"Recent observed coverage, not a lifetime guarantee. An unmeasured dataset carries no support claim in either direction."},"identifier":{"namespace":"mixed","formatByMarket":{},"storesZeroPaddedHkCode":false,"stableJoinKey":"instrument_id","resolverPath":"/api/v1/data/instruments/resolve"},"sparseSemantics":null,"emptyResultCodes":["VALID_EMPTY","NOT_IN_RANKING","UNSUPPORTED_MARKET","STALE_SOURCE","NO_MATCH","IDENTIFIER_INVALID","COVERAGE_UNKNOWN","PARTIAL_UNIVERSE"],"publication":{"published":true,"reason":null,"projectionReviewed":true},"returnedFieldCount":21,"costGuard":{"tier":"small","identityFilters":["symbol"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"ownership.13f_mapped","namespace":"ownership","name":"13f_mapped","coverageTags":["ownership"],"description":"Canonical Friends financial dataset: 映射证券后的 13F 持仓.","relation":"ownership.v_13f_mapped","objectKind":"view","rowMagnitude":"view","grain":"report_date × manager_cik × cusip × put_call × source_record_id","cadence":"producer_schedule","timeColumn":"report_date","defaultOrder":["report_date","manager_cik","cusip","put_call","source_record_id"],"filters":[{"name":"code","column":"code","required":false,"multipleValues":true,"jsonType":"string","example":"AAPL"},{"name":"provider","column":"provider","required":false,"multipleValues":true,"jsonType":"string","example":"PROVIDER_VALUE"},{"name":"source","column":"source","required":false,"multipleValues":true,"jsonType":"string","example":"SOURCE_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":true,"readMode":"relation_default","contractVersion":null,"uniqueKey":["report_date","manager_cik","cusip","put_call","source_record_id"],"provenanceColumns":[],"fieldCount":37,"fields":[{"position":1,"name":"report_date","displayName":"report date","clickhouseType":"Date","jsonType":"string","nullable":false,"description":"Reporting-period or statement date.","descriptionSource":"standard_glossary","roles":["time","default_order","contract_unique_key"],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":2,"name":"manager_cik","displayName":"manager cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: manager cik.","descriptionSource":"name_derived","roles":["default_order","contract_unique_key"],"filterNames":[],"returned":true},{"position":3,"name":"cusip","displayName":"cusip","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: cusip.","descriptionSource":"name_derived","roles":["default_order","contract_unique_key"],"filterNames":[],"returned":true},{"position":4,"name":"code","displayName":"code","clickhouseType":"Nullable(String)","jsonType":"string","nullable":true,"description":"Source-normalized security or contract code.","descriptionSource":"standard_glossary","roles":["filter"],"filterNames":["code"],"returned":true},{"position":5,"name":"issuer_name","displayName":"issuer name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: issuer name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":6,"name":"class_title","displayName":"class title","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: class title.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":7,"name":"value_usd","displayName":"value usd","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"US-dollar value for value usd.","descriptionSource":"name_derived","roles":[],"filterNames":[],"unit":"USD","returned":true},{"position":8,"name":"shares","displayName":"shares","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: shares.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"share_type","displayName":"share type","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: share type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"put_call","displayName":"put call","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: put call.","descriptionSource":"name_derived","roles":["default_order","contract_unique_key"],"filterNames":[],"returned":true},{"position":11,"name":"source","displayName":"source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["filter","provenance"],"filterNames":["source"],"returned":true},{"position":12,"name":"provider","displayName":"provider","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Upstream data provider identifier.","descriptionSource":"standard_glossary","roles":["filter","provenance"],"filterNames":["provider"],"returned":true},{"position":13,"name":"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":["default_order","contract_unique_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":"is_deleted","displayName":"is deleted","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Soft-delete marker; public serving excludes current tombstones.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":23,"name":"created_at","displayName":"created at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was first created.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":24,"name":"updated_at","displayName":"updated at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was last updated.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":25,"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":26,"name":"mapped_market","displayName":"mapped market","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: mapped market.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":27,"name":"mapped_exchange","displayName":"mapped exchange","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: mapped exchange.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":28,"name":"mapped_instrument_id","displayName":"mapped instrument id","clickhouseType":"Nullable(UInt64)","jsonType":"integer","nullable":true,"description":"Identifier for mapped instrument.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":29,"name":"mapped_figi","displayName":"mapped figi","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: mapped figi.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":30,"name":"mapped_composite_figi","displayName":"mapped composite figi","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: mapped composite figi.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":31,"name":"mapped_share_class_figi","displayName":"mapped share class figi","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: mapped share class figi.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":32,"name":"mapped_security_name","displayName":"mapped security name","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: mapped security name.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":33,"name":"mapped_security_type","displayName":"mapped security type","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: mapped security type.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":34,"name":"mapped_market_sector","displayName":"mapped market sector","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: mapped market sector.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":35,"name":"cusip_mapping_status","displayName":"cusip mapping status","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: cusip mapping status.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":36,"name":"cusip_mapping_confidence","displayName":"cusip mapping confidence","clickhouseType":"Float64","jsonType":"number","nullable":false,"description":"Source-normalized field: cusip mapping confidence.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":37,"name":"cusip_mapping_observed_at","displayName":"cusip mapping observed at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp for cusip mapping observed at.","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"映射证券后的 13F 持仓","summaryCn":"这是机构及内部人持仓中的“映射证券后的 13F 持仓”数据集；一行由 report_date、manager_cik、cusip、put_call 定位，主要字段包括 code、issuer_name、class_title、value_usd、shares。","useCasesCn":["分析机构和内部人持仓","跟踪报告期之间的持仓变化"],"grainCn":"每行代表“映射证券后的 13F 持仓”的一条记录；逻辑粒度由 report_date × manager_cik × cusip × put_call × source_record_id 共同确定。","timeSemanticsCn":"以 report_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"由对应生产任务或事件触发更新，不承诺固定日历频率；查询前先检查最新时间。","keyFields":[{"name":"report_date","meaningCn":"财务、持仓或统计报告所属日期。"},{"name":"manager_cik","meaningCn":"用于确定该表业务粒度或默认顺序的 manager cik 字段。"},{"name":"cusip","meaningCn":"用于确定该表业务粒度或默认顺序的 cusip 字段。"},{"name":"put_call","meaningCn":"用于确定该表业务粒度或默认顺序的 put call 字段。"},{"name":"source_record_id","meaningCn":"用于识别 source record 的业务标识。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，响应有 has_more 时原样传回 next_cursor 继续分页。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":[],"coverage":{"measured":false,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{},"latestBusinessDate":null,"note":"Recent observed coverage, not a lifetime guarantee. An unmeasured dataset carries no support claim in either direction."},"identifier":{"namespace":"mixed","formatByMarket":{},"storesZeroPaddedHkCode":false,"stableJoinKey":"instrument_id","resolverPath":"/api/v1/data/instruments/resolve"},"sparseSemantics":null,"emptyResultCodes":["VALID_EMPTY","NOT_IN_RANKING","UNSUPPORTED_MARKET","STALE_SOURCE","NO_MATCH","IDENTIFIER_INVALID","COVERAGE_UNKNOWN","PARTIAL_UNIVERSE"],"publication":{"published":true,"reason":null,"projectionReviewed":true},"returnedFieldCount":37,"costGuard":{"tier":"small","identityFilters":["code"],"maxWindowDays":400,"requirement":"none","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}},{"object":"dataset_schema","asset":"ownership.insider","namespace":"ownership","name":"insider","coverageTags":["ownership"],"description":"Insider ownership transactions.","relation":"ownership.insider","objectKind":"table","rowMagnitude":"100K-999K","grain":"accession_no × owner_cik × filing_date","cadence":"daily","timeColumn":"filing_date","defaultOrder":["filing_date","accession_no","owner_cik"],"filters":[{"name":"accession_no","column":"accession_no","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"code","column":"code","required":false,"multipleValues":true,"jsonType":"string","example":"AAPL"},{"name":"issuer_cik","column":"issuer_cik","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"},{"name":"owner_cik","column":"owner_cik","required":false,"multipleValues":true,"jsonType":"string","example":"FILTER_VALUE"}],"maxLimit":5000,"maxWindowDays":null,"supportsCursor":false,"readMode":"canonical_final_active","contractVersion":null,"uniqueKey":[],"provenanceColumns":[],"fieldCount":23,"fields":[{"position":1,"name":"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":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"],"filterNames":["accession_no"],"returned":true},{"position":3,"name":"owner_cik","displayName":"owner cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: owner cik.","descriptionSource":"name_derived","roles":["filter","default_order","warehouse_primary_key"],"filterNames":["owner_cik"],"returned":true},{"position":4,"name":"issuer_cik","displayName":"issuer cik","clickhouseType":"String","jsonType":"string","nullable":false,"description":"Source-normalized field: issuer cik.","descriptionSource":"name_derived","roles":["filter","warehouse_primary_key"],"filterNames":["issuer_cik"],"returned":true},{"position":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":"transaction_date","displayName":"transaction date","clickhouseType":"Nullable(Date)","jsonType":"string","nullable":true,"description":"Calendar date for transaction date (YYYY-MM-DD).","descriptionSource":"name_derived","roles":[],"filterNames":[],"jsonFormat":"date","unit":"date","returned":true},{"position":7,"name":"transaction_code","displayName":"transaction code","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Source-normalized field: transaction code.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":8,"name":"shares","displayName":"shares","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: shares.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":9,"name":"price","displayName":"price","clickhouseType":"Nullable(Float64)","jsonType":"number","nullable":true,"description":"Source-normalized field: price.","descriptionSource":"name_derived","roles":[],"filterNames":[],"returned":true},{"position":10,"name":"source","displayName":"source","clickhouseType":"LowCardinality(String)","jsonType":"string","nullable":false,"description":"Normalized upstream source identifier.","descriptionSource":"standard_glossary","roles":["warehouse_primary_key","provenance"],"filterNames":[],"returned":true},{"position":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":"is_deleted","displayName":"is deleted","clickhouseType":"UInt8","jsonType":"integer","nullable":false,"description":"Soft-delete marker; public serving excludes current tombstones.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"returned":true},{"position":22,"name":"created_at","displayName":"created at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was first created.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true},{"position":23,"name":"updated_at","displayName":"updated at","clickhouseType":"DateTime64(3, 'UTC')","jsonType":"string","nullable":false,"description":"UTC timestamp when the warehouse row was last updated.","descriptionSource":"standard_glossary","roles":[],"filterNames":[],"jsonFormat":"date-time","unit":"UTC_datetime","returned":true}],"pit":null,"titleCn":"内部人持股交易","summaryCn":"按申报、内部人和日期保存所有权交易与持股变化，用于研究管理层和董事的交易行为。","useCasesCn":["筛选内部人买卖","汇总公司内部人净交易","联接 SEC Form 4 核验"],"grainCn":"每行代表“内部人持股交易”的一条记录；逻辑粒度由 accession_no × owner_cik × filing_date 共同确定。","timeSemanticsCn":"以 filing_date 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。","cadenceCn":"通常按交易日或自然日更新；具体最新日期请以返回数据为准。","keyFields":[{"name":"accession_no","meaningCn":"SEC 对单次申报分配的唯一 accession number。"},{"name":"owner_cik","meaningCn":"用于确定该表业务粒度或默认顺序的 owner cik 字段。"},{"name":"filing_date","meaningCn":"申报提交或公开日期。"}],"joins":[{"dataset":"","on":"","guidanceCn":"该表主要按自身业务键使用，目前没有推荐的跨表主键联接。"}],"queryGuidanceCn":"先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 cursor，结果过大时必须缩小标的、日期或其他筛选。","caveatsCn":["返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。"],"supportedMarkets":[],"coverage":{"measured":false,"windowDays":30,"windowStart":"2026-07-29","observedMarkets":{},"latestBusinessDate":null,"note":"Recent observed coverage, not a lifetime guarantee. An unmeasured dataset carries no support claim in either direction."},"identifier":{"namespace":"mixed","formatByMarket":{},"storesZeroPaddedHkCode":false,"stableJoinKey":"instrument_id","resolverPath":"/api/v1/data/instruments/resolve"},"sparseSemantics":null,"emptyResultCodes":["VALID_EMPTY","NOT_IN_RANKING","UNSUPPORTED_MARKET","STALE_SOURCE","NO_MATCH","IDENTIFIER_INVALID","COVERAGE_UNKNOWN","PARTIAL_UNIVERSE"],"publication":{"published":true,"reason":null,"projectionReviewed":true},"returnedFieldCount":23,"costGuard":{"tier":"medium","identityFilters":["accession_no","code"],"maxWindowDays":400,"requirement":"identity filter or bounded window","enforcedBeforeSql":true},"sourceEntitlement":{"mode":"vendor_denylist","decision":"ALLOWED","deniedSources":[],"reasons":[]}}]}