DATASET · event

宏观经济数据发布

event.economic_release

新闻、公告与事件

记录各国经济指标的发布时间、实际值、预期值和前值，用于衡量宏观数据意外程度。

下载本类 JSON 下载完整 JSON.gz 先获取 Key

字段31

关键字段3

更新口径event

时间列release_ts

单页上限5000

分页窄筛选

PIT不支持

规模100K-999K

WHAT IT ANSWERS

这张表适合回答什么

计算实际值相对预期的 surprise
查询未来或历史宏观发布时间
对照资产价格研究宏观冲击

GRAIN & TIME

一行代表什么

业务粒度: 每行代表“宏观经济数据发布”的一条记录；逻辑粒度由 country × indicator_type × release_ts 共同确定。
时间口径: 以 release_ts 为主要查询时间轴；除下方限制特别说明外，时间戳按 UTC、日期按来源市场日历解释。
更新节奏: 由公告、新闻或业务事件触发更新，没有固定日历频率。

KEY FIELDS

先看这些字段

country: 用于确定该表业务粒度或默认顺序的 country 字段。
indicator_type: 用于确定该表业务粒度或默认顺序的 indicator type 字段。
release_ts: release ts 对应的时间戳；除表内特别说明外按 UTC 解释。

RECOMMENDED JOINS

怎样和其他表关联

该表主要按自身业务键使用，目前没有推荐的跨表主键联接。

HOW TO QUERY SAFELY

查询方法与已知限制

先用 catalog 确认当前契约；可按 catalog 中列出的 filters 进一步缩小范围；单页最多 5000 行，该表不提供稳定 cursor，结果过大时必须缩小标的、日期或其他筛选。

返回范围仍受 Friends 权限、单页上限和 catalog 中的筛选契约约束。

MACHINE CONTRACT

筛选、排序与分页

UNVERSIONED

默认排序: release_ts, country, indicator_type
唯一键: —
读取模式: canonical_final_active
最大时间窗: 未单独限制

可用 filters

country→ country · string

indicator_type→ indicator_type · string

period→ period · 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/economic_release/rows?limit=100&country=US&start=2026-08-01&end=2026-08-01"

PYTHON SDK

from friends_data_api import FriendsDataClient, Settings

async with FriendsDataClient(Settings.from_env()) as client:
    page = await client.get_dataset_rows('event', 'economic_release', limit=100, start='2026-08-01', end='2026-08-01', filters={'country': 'US'})
    print(page.data)
    if page.has_more:
        print("next cursor:", page.next_cursor)

CLI

friends-data get-dataset-rows event economic_release --limit 100 --start 2026-08-01 --end 2026-08-01 --filter country=US

MCP TOOL CALL

{
  "arguments": {
    "dataset": "economic_release",
    "end": "2026-08-01",
    "filters": {
      "country": "US"
    },
    "limit": 100,
    "namespace": "event",
    "start": "2026-08-01"
  },
  "tool": "get_dataset_rows"
}

FIELD DICTIONARY

31 个返回字段

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

筛选字段

#	字段	ClickHouse 类型	JSON	可空	角色	说明
1	`country`	`LowCardinality(String)`	`string`	no	filter, default_order, warehouse_primary_key	Source-normalized field: country.名称推导
2	`indicator_type`	`LowCardinality(String)`	`string`	no	filter, default_order, warehouse_primary_key	Source-normalized field: indicator type.名称推导
3	`release_ts`UTC_datetime	`DateTime`	`string / date-time`	no	time, default_order, warehouse_primary_key	UTC timestamp for release ts.名称推导
4	`period`	`LowCardinality(String)`	`string`	no	filter	Reporting or observation period label.标准术语表
5	`actual`	`Nullable(Float64)`	`number`	yes	value	Source-normalized field: actual.名称推导
6	`previous`	`Nullable(Float64)`	`number`	yes	value	Source-normalized field: previous.名称推导
7	`estimate`	`Nullable(Float64)`	`number`	yes	value	Source-normalized field: estimate.名称推导
8	`change`	`Nullable(Float64)`	`number`	yes	value	Source-normalized field: change.名称推导
9	`change_percentage`percent	`Nullable(Float64)`	`number`	yes	value	Percentage value for change percentage.名称推导
10	`comparison`	`Nullable(String)`	`string`	yes	value	Source-normalized field: comparison.名称推导
11	`event_name`	`Nullable(String)`	`string`	yes	value	Source-normalized field: event name.名称推导
12	`unit`	`LowCardinality(String)`	`string`	no	value	Unit attached to the numeric observation.标准术语表
13	`payload_json`	`String`	`string`	no	value	Source-normalized field: payload json.名称推导
14	`publish_ts`UTC_datetime	`DateTime64(3, 'UTC')`	`string / date-time`	no	provenance	UTC point-in-time availability timestamp used by PIT reads.标准术语表
15	`source_ts`UTC_datetime	`DateTime64(3, 'UTC')`	`string / date-time`	no	provenance	Timestamp asserted by the upstream source.标准术语表
16	`ingested_at`UTC_datetime	`DateTime64(3, 'UTC')`	`string / date-time`	no	provenance	UTC timestamp when the source record entered the warehouse.标准术语表
17	`source`	`LowCardinality(String)`	`string`	no	filter, warehouse_primary_key, provenance	Normalized upstream source identifier.标准术语表
18	`provider`	`LowCardinality(String)`	`string`	no	provenance	Upstream data provider identifier.标准术语表
19	`source_url`	`String`	`string`	no	provenance	URL of the upstream evidence or record when distributable.标准术语表
20	`source_record_id`	`String`	`string`	no	provenance	Provider-side identifier for the source record.标准术语表
21	`raw_payload_hash`	`String`	`string`	no	provenance	Opaque fingerprint of the normalized source payload for provenance checks.标准术语表
22	`parser_version`	`LowCardinality(String)`	`string`	no	provenance	Version of the parser or normalizer that produced the row.标准术语表
23	`quality_status`	`LowCardinality(String)`	`string`	no	provenance	Machine-readable data-quality classification.标准术语表
24	`license_scope`	`LowCardinality(String)`	`string`	no	provenance	License or redistribution scope attached to the row.标准术语表
25	`visibility_tier`	`LowCardinality(String)`	`string`	no	provenance	Serving visibility tier attached to the row.标准术语表
26	`ingest_run_id`	`String`	`string`	no	provenance	Identifier of the ingestion run that produced the row.标准术语表
27	`version`	`UInt64`	`integer`	no	provenance	Monotonic row version used for correction-aware reads.标准术语表
28	`version_ts`UTC_datetime	`DateTime64(3, 'UTC')`	`string / date-time`	no	provenance	UTC timestamp associated with the row version.标准术语表
29	`is_deleted`	`UInt8`	`integer`	no	value	Soft-delete marker; public serving excludes current tombstones.标准术语表
30	`created_at`UTC_datetime	`DateTime`	`string / date-time`	no	value	UTC timestamp when the warehouse row was first created.标准术语表
31	`updated_at`UTC_datetime	`DateTime`	`string / date-time`	no	value	UTC timestamp when the warehouse row was last updated.标准术语表

字典口径

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