Friends Data API独立数据服务

DATASET · event

巨潮资讯公告索引

event.filing_cninfo
A 股新闻、公告与事件

保存中国上市公司在巨潮资讯披露的公告标识、日期、标题与来源指针。

字段26
关键字段2
更新口径event
时间列ann_date
单页上限5000
分页Cursor
PIT不支持
规模100K-999K

WHAT IT ANSWERS

这张表适合回答什么

  • 查询 A 股公司公告时间线
  • 按标题筛选公司行为
  • 联接原始文档做文本研究

GRAIN & TIME

一行代表什么

业务粒度
每行代表“巨潮资讯公告索引”的一条记录;逻辑粒度由 announcement_id × ann_date 共同确定。
时间口径
以 ann_date 为主要查询时间轴;除下方限制特别说明外,时间戳按 UTC、日期按来源市场日历解释。
更新节奏
由公告、新闻或业务事件触发更新,没有固定日历频率。

KEY FIELDS

先看这些字段

announcement_id
用于识别 announcement 的业务标识。
ann_date
来源公告日期。

RECOMMENDED JOINS

怎样和其他表关联

ref.instrumenton code + market(先确认代码口径)

需要补证券主数据时可按代码和市场映射;不同来源代码可能不一致,优先先查 ref.code_mapping。

HOW TO QUERY SAFELY

查询方法与已知限制

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

MACHINE CONTRACT

筛选、排序与分页

UNVERSIONED
默认排序
ann_date, market, code, announcement_id
唯一键
—
读取模式
canonical_final_active
最大时间窗
未单独限制

可用 filters

category→ category · string
code→ code · string
market→ market · string
source→ source · 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/filing_cninfo/rows?limit=100&code=NNNNNN.SH+or+NNNNNN.SZ"

FIELD DICTIONARY

26 个返回字段

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

#字段ClickHouse 类型JSON可空角色说明
1announcement_idStringstringnodefault_order, warehouse_primary_keyIdentifier for announcement.名称推导
2codeStringstringnofilter, default_order, warehouse_primary_keySource-normalized security or contract code.标准术语表
3marketLowCardinality(String)stringnofilter, default_order, warehouse_primary_keyCanonical market or country-market code.标准术语表
4ann_datedateDatestring / datenotime, default_order, warehouse_primary_keyAnnouncement date.标准术语表
5sourceLowCardinality(String)stringnofilter, provenanceNormalized upstream source identifier.标准术语表
6titleStringstringnovalueHuman-readable title supplied or normalized from the source.标准术语表
7categoryStringstringnofilterSource-normalized field: category.名称推导
8pdf_urlStringstringnovalueSource-normalized field: pdf url.名称推导
9blob_pathStringstringnovalueSource-normalized field: blob path.名称推导
10blob_sha256StringstringnovalueSource-normalized field: blob sha256.名称推导
11page_countNullable(Int32)integeryesvalueCount of page count.名称推导
12text_extractedUInt8integernovalueSource-normalized field: text extracted.名称推导
13text_pathStringstringnovalueSource-normalized field: text path.名称推导
14providerLowCardinality(String)stringnoprovenanceUpstream data provider identifier.标准术语表
15source_urlStringstringnoprovenanceURL of the upstream evidence or record when distributable.标准术语表
16source_record_idStringstringnoprovenanceProvider-side identifier for the source record.标准术语表
17raw_payload_hashStringstringnoprovenanceOpaque fingerprint of the normalized source payload for provenance checks.标准术语表
18parser_versionLowCardinality(String)stringnoprovenanceVersion of the parser or normalizer that produced the row.标准术语表
19quality_statusLowCardinality(String)stringnoprovenanceMachine-readable data-quality classification.标准术语表
20license_scopeLowCardinality(String)stringnoprovenanceLicense or redistribution scope attached to the row.标准术语表
21visibility_tierLowCardinality(String)stringnoprovenanceServing visibility tier attached to the row.标准术语表
22ingest_run_idStringstringnoprovenanceIdentifier of the ingestion run that produced the row.标准术语表
23versionUInt64integernoprovenanceMonotonic row version used for correction-aware reads.标准术语表
24is_deletedUInt8integernovalueSoft-delete marker; public serving excludes current tombstones.标准术语表
25created_atUTC_datetimeDateTime64(3, 'UTC')string / date-timenovalueUTC timestamp when the warehouse row was first created.标准术语表
26updated_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。