下次 CPI 发布日期
查明下一次美国 CPI 何时发布,按 UTC 和纽约时间显示。
阅读指南 →跟踪计划中的经济数据发布及其发布状态。为 GDP、价格、劳动力、贸易和收益率曲线构建发布日历,避免将不确定的日程当作确切时间。
curl --request GET \
--url "https://api.narwhalapi.com/v1/economics/calendar?countries=USA&start_date=2026-10-01&end_date=2026-10-31" \
--header "Authorization: Bearer $NARWHAL_API_KEY"{
"releases": [
{
"release_id": "00000000-0000-4000-8000-000000000201",
"revision": 0,
"country": "USA",
"series_id": "usa-consumer-prices",
"name": "Consumer prices",
"topic": "consumer_prices",
"family": "prices",
"period": "2026-09",
"status": "scheduled",
"at": "2026-10-14T12:30:00Z",
"timezone": "America/New_York",
"values": []
}
],
"next_cursor": null
}curl --request GET \
--url "https://api.narwhalapi.com/v1/economics/calendar?countries=USA&start_date=2026-12-09&end_date=2026-12-09" \
--header "Authorization: Bearer $NARWHAL_API_KEY"{
"releases": [
{
"release_id": "52e78613-4f51-4cc8-b8dd-a4c3cc798c50",
"revision": 1,
"country": "USA",
"series_id": "usa-monetary-policy-press-conference",
"name": "Monetary policy press conference",
"topic": "policy_communication",
"family": "policy_rate",
"status": "scheduled",
"at": "2026-12-09T19:30:00Z",
"timezone": "America/New_York",
"values": []
},
{
"release_id": "ed7bb0f9-6b9b-4e27-9b43-d891742ec3d4",
"revision": 1,
"country": "USA",
"series_id": "usa-policy-rate-decision",
"name": "Policy rate decision",
"topic": "policy_rate",
"family": "policy_rate",
"status": "scheduled",
"at": "2026-12-09T19:00:00Z",
"timezone": "America/New_York",
"values": []
}
],
"next_cursor": null
}curl --request POST \
--url "https://api.narwhalapi.com/v1/calendars/subscriptions" \
--header "Authorization: Bearer $NARWHAL_API_KEY" \
--header "Content-Type: application/json" \
--data '{"countries":["USA"],"start_date":"2026-09-01","end_date":"2026-12-31","include_releases":true,"include_holidays":true}'{
"subscription_id": "00000000-0000-4000-8000-000000000301",
"url": "https://api.narwhalapi.com/v1/calendars/subscriptions/EXAMPLE_TOKEN.ics",
"expires_at": "2027-10-22T09:00:00Z"
}/v1/economics/calendar列出日期范围内的数据发布事件
countries可选ISO alpha-3 代码,如 USA。多个国家可重复该参数,最多 50 个。
start_date可选时间窗口的第一天。默认从今天前 30 天开始。
end_date可选时间窗口的最后一天。默认到今天后 335 天结束。窗口最长 366 天。
limit可选每页的发布数量,1 到 100。默认为 100。
cursor可选使用 next_cursor 和相同的筛选条件继续。
release_id字符串要查看详情的发布。
name字符串Narwhal 的标准英文名称,如 Producer prices。不含日期。
topic字符串该序列衡量的内容,在每个国家都相同,如 consumer_prices 或 gdp。
period字符串该发布所涵盖的期间,如 2026-09 或 2026-Q3。
status字符串发布所处的状态,如 scheduled。
at / date / between / by字符串发布机构给出的时间:确切时间、某一天、一段日期范围或截止日期。日期未知时为 None。
values数组已发布的数据。发布之前数组为空。
/v1/economics/calendar/{release_id}读取一次数据发布的信息,可通过 version_id 选择版本
release_id必填该发布的 UUID。
version_id可选较早版本的 UUID。省略则返回当前版本。
version字符串不可变的版本,可作为 version_id 传回。
name字符串Narwhal 的标准英文名称,如 Producer prices。不含日期。
topic字符串该序列衡量的内容,在每个国家都相同,如 consumer_prices 或 gdp。
period字符串该发布所涵盖的期间,如 2026-09 或 2026-Q3。
status字符串发布所处的状态,如 scheduled。
at / date / between / by字符串发布机构给出的时间:确切时间、某一天、一段日期范围或截止日期。日期未知时为 None。
values数组已发布的数据。发布之前数组为空。
共114个国家。其中43个直接从发布机构读取发布日程,其余71个使用第三方日历的日期,并标为参考日期。
55个官方发布机构:统计局、部委和央行。发布机构自己的日期和数据始终优先于第三方日历。
不是。发布机构可能仅指定日期、范围或截止日期。响应通过顶层的 at、date、between 或 by 字段保留该精度。
在发布详情请求中使用 version_id 参数选择不可变版本。
有。每个 Narwhal 账户每月都有10美元免费额度,无需绑卡,也没有期限。一次日历请求算一次调用,每1,000次调用2美元,所以免费额度每月可调用5,000次。
有,前提是第三方日历有该预测。每个值会在前值旁带上市场共识,发布后再带上实际值。市场共识是预测而不是已公布的数字,没有已知预测时不会出现。没有重要性评级。
精确的发布时间(at 字段)为 UTC。timezone 字段给出发布机构自己的 IANA 时区,例如 Asia/Jakarta,便于显示当地时间。只有日期的发布没有时间。
一次请求最多覆盖366天的区间。默认从今天前30天到今天后335天。更长的范围请按区间逐段获取。内容有变化的发布会保留旧版本,用 version_id 读取。
能。创建日历订阅后,Narwhal 会返回一个私有的 .ics 链接,日历应用可订阅。它可包含发布、公共假日或两者,覆盖1至50个国家,区间最长366天。创建一次算一次调用。
能。Narwhal MCP 服务器提供 economics_list_releases 和 economics_get_release,与 REST 端点的两个操作相同。
账户只有免费额度时每分钟50次请求,持有付费额度后每分钟500次。同一网络地址每分钟限120次。429 响应带有 Retry-After,且不收费。
预定发布并不保证在准确的预定时刻公布。请保留时间精度和时区,并明确处理已取消的发布。预定发布时间与 Narwhal 观察到该次发布的时间代表不同的事件。
每月赠送 10 美元免费额度,无需绑卡。每月 10 美元免费额度,无需绑卡。