Friends Data API独立数据服务

DATASET · event

事件质量与去重增强

event.stream_quality_enrichment
新闻、公告与事件

这是公告、新闻与可交易事件中的“事件质量与去重增强”数据集;一行由 event_source、event_ts、event_id、dedup_group_id 定位,主要字段包括 event_code、title、url、source_url、source_record_id。

字段35
关键字段4
更新口径intraday
时间列event_ts
单页上限5000
分页Cursor
PIT不支持
规模100K-999K

WHAT IT ANSWERS

这张表适合回答什么

  • 按标的和时间检索事件或原文
  • 与行情联接研究事件前后反应

GRAIN & TIME

一行代表什么

业务粒度
每行代表“事件质量与去重增强”的一条记录;逻辑粒度由 event_id × event_source × event_ts × dedup_group_id 共同确定。
时间口径
以 event_ts 为主要查询时间轴;除下方限制特别说明外,时间戳按 UTC、日期按来源市场日历解释。
更新节奏
交易时段内可多次更新;请检查时间列判断新鲜度。

KEY FIELDS

先看这些字段

event_id
统一事件标识;可联接 event.stream。
event_source
用于确定该表业务粒度或默认顺序的 event source 字段。
event_ts
标准化事件发生或发布时间,默认按 UTC 解释。
dedup_group_id
用于识别 dedup group 的业务标识。

RECOMMENDED JOINS

怎样和其他表关联

event.streamon event_id

用 event_id 回到统一事件流和事件分类。

HOW TO QUERY SAFELY

查询方法与已知限制

先用 catalog 确认当前契约;可按 catalog 中列出的 filters 进一步缩小范围;单页最多 5000 行,响应有 has_more 时原样传回 next_cursor 继续分页。

MACHINE CONTRACT

筛选、排序与分页

UNVERSIONED
默认排序
event_source, event_ts, event_id, dedup_group_id
唯一键
event_source, event_ts, event_id, dedup_group_id
读取模式
canonical_final_active
最大时间窗
未单独限制

可用 filters

event_code→ event_code · string
event_id→ event_id · string
provider→ provider · string

POINT IN TIME

可复现读取

NOT AVAILABLE

该资产没有 PIT 契约。普通 rows 端点仍按当前公开读模式返回数据;不要把它表述成历史时点快照。

COPY-READY CALLS

怎么调用

同一数据集可用 HTTP、Python SDK、CLI 或 MCP;Key 始终只通过环境变量/Bearer Header 传递。

READ ONLY
HTTP
curl --fail-with-body -H "Authorization: Bearer $FRIENDS_DATA_API_KEY" "https://api.alphahubs.uk/api/v1/data/datasets/event/stream_quality_enrichment/rows?limit=100&event_code=EVENT_CODE"

FIELD DICTIONARY

35 个返回字段

descriptionSource 可在 JSON 中区分仓库注释、标准术语表和名称推导说明。

#字段ClickHouse 类型JSON可空角色说明
1event_idStringstringnofilter, default_order, warehouse_primary_key, contract_unique_keyStable identifier of the normalized event.标准术语表
2event_tsUTC_datetimeDateTime64(3, 'UTC')string / date-timenotime, default_order, warehouse_primary_key, contract_unique_keyUTC timestamp of the normalized event.标准术语表
3event_sourceLowCardinality(String)stringnodefault_order, warehouse_primary_key, contract_unique_keySource-normalized field: event source.名称推导
4event_codeLowCardinality(String)stringnofilterSource-normalized field: event code.名称推导
5titleStringstringnovalueHuman-readable title supplied or normalized from the source.标准术语表
6urlStringstringnovalueCanonical URL attached to the record.标准术语表
7source_urlStringstringnoprovenanceURL of the upstream evidence or record when distributable.标准术语表
8source_record_idStringstringnoprovenanceProvider-side identifier for the source record.标准术语表
9dedup_keyStringstringnovalueSource-normalized field: dedup key.名称推导
10dedup_group_idStringstringnodefault_order, warehouse_primary_key, contract_unique_keyIdentifier for dedup group.名称推导
11dedup_rankUInt32integernovalueSource-normalized field: dedup rank.名称推导
12duplicate_countUInt32integernovalueCount of duplicate count.名称推导
13is_canonicalUInt8integernovalueWhether canonical applies to the row.名称推导
14effective_severityNullable(Int16)integeryesvalueSource-normalized field: effective severity.名称推导
15severity_sourceLowCardinality(String)stringnovalueSource-normalized field: severity source.名称推导
16severity_reason_effectiveStringstringnovalueSource-normalized field: severity reason effective.名称推导
17linked_tickers_jsonStringstringnovalueSource-normalized field: linked tickers json.名称推导
18linked_instrument_ids_jsonStringstringnovalueSource-normalized field: linked instrument ids json.名称推导
19linked_ticker_countUInt16integernovalueCount of linked ticker count.名称推导
20entity_link_statusLowCardinality(String)stringnovalueSource-normalized field: entity link status.名称推导
21quality_bucketLowCardinality(String)stringnovalueSource-normalized field: quality bucket.名称推导
22quality_reasonStringstringnovalueSource-normalized field: quality reason.名称推导
23observed_atUTC_datetimeDateTime64(3, 'UTC')string / date-timenovalueUTC timestamp for observed at.名称推导
24enrichment_sourceLowCardinality(String)stringnovalueSource-normalized field: enrichment source.名称推导
25providerLowCardinality(String)stringnofilter, provenanceUpstream data provider identifier.标准术语表
26raw_payload_hashStringstringnoprovenanceOpaque fingerprint of the normalized source payload for provenance checks.标准术语表
27parser_versionLowCardinality(String)stringnoprovenanceVersion of the parser or normalizer that produced the row.标准术语表
28quality_statusLowCardinality(String)stringnoprovenanceMachine-readable data-quality classification.标准术语表
29license_scopeLowCardinality(String)stringnoprovenanceLicense or redistribution scope attached to the row.标准术语表
30visibility_tierLowCardinality(String)stringnoprovenanceServing visibility tier attached to the row.标准术语表
31ingest_run_idStringstringnoprovenanceIdentifier of the ingestion run that produced the row.标准术语表
32versionUInt64integernoprovenanceMonotonic row version used for correction-aware reads.标准术语表
33is_deletedUInt8integernovalueSoft-delete marker; public serving excludes current tombstones.标准术语表
34created_atUTC_datetimeDateTime64(3, 'UTC')string / date-timenovalueUTC timestamp when the warehouse row was first created.标准术语表
35updated_atUTC_datetimeDateTime64(3, 'UTC')string / date-timenovalueUTC timestamp when the warehouse row was last updated.标准术语表
字典口径

结构来自 Friends 只读身份可见的真实 serving relation;权限、过滤、排序、PIT 与分页来自可执行 DatasetSpec。Schema observed at 2026-10-06T18:08:52Z。