使用场景

每个页面只处理一项任务，例如确定正确的工作日，或按通胀调整租金，并展示完成该任务的 Narwhal 请求及真实响应。

日历与发布

掌握数据和决议的公布时间。

日历与发布
应用场景涵盖内容
在你自己的应用中显示经济日历在产品中发布经济日历：按用户筛选国家、按查看者时区显示发布时间、按国家缓存，并处理被调整的发布，让应用内的经济日历与官方公布的时间保持一致，用户看到的时间准确无误。
在发布之前查看数据的发布时间、所属期间和前值通过日历 API 查找某个国家接下来的高关注度经济数据发布，包括 UTC 与当地发布时间、所属期间和前值，好让你在数据发布之前就能查看，提前做好准备、心中有数。
向交易台或值班团队发送数据发布前提醒为交易台或值班团队构建数据发布前提醒:每条消息都包含 UTC 时间、交易台的当地时间、所属周期和前值，让交易台和值班团队在数据公布前就能掌握关键信息，不必再临时去查。
为报道查找下周发布的数据和最新数值获取本周将发布的经济数据，以及通胀、失业率和 GDP 的最新数值，并同时拿到报道所需的参考期和发布日期，写稿时就能写对统计月份。适合新闻编辑部用 Narwhal API 查询经济数据。
追踪央行政策利率与市场隐含利率路径先读取多个国家央行的当前政策利率和利率历史，再加入未来会议的市场隐含降息、维持、加息概率，把央行政策利率与市场隐含的利率路径放在同一份数据里一起追踪，一目了然。

假日与工作日

围绕休市日做好安排。

假日与工作日
应用场景涵盖内容
结算日工作日怎么算：两国假日不同的跨境交易两国节假日不同时，计算跨境交易的结算日：把交易清单对照两国的节假日列表跑一遍，并标出日期因节假日而改变的交易，直接得到可复核的工作日结果，也方便逐笔核对每个日期。
为薪资核算列出各国各年的法定节假日为薪资核算按年获取各国的法定节假日，并通过每个条目的 scope 和行政区划代码，区分全国性假日与地区性假日。指定国家和年份调用一次，就能拿到薪资核算所需的节假日清单。
送达日期估算：在结账时承诺跨两国的送达日期在购物车里显示送达日期，并考虑下单截止时间、承运天数，以及发货国和送达国的公共假日，让跨两国订单在购物车和结账时就能向客户承诺一个可靠的送达日期，并避开节假日。
避开多国节假日安排会议和发布用节假日日历 API 找出多个国家都不是公共假日的日子，用来安排会议、发布或维护窗口，让多国团队的排期避开所有休息日，不再撞上任何一个国家的假期，也不必逐国去查日历。
为服务级别协议（SLA）运行按工作日计时的违约计时器为服务台建立按工作日计时的违约计时器：说明合同必须定义哪些内容，以及 Narwhal 的节假日数据如何为合同所在国家的计时提供日历，让违约时间的计算有据可依、便于复核。
围绕节假日和伊斯兰历（回历）规划旅行用 Narwhal API 按各国的节假日、长假和回历日期来规划行程与预订。API 不包含预订或价格数据，只提供日期，让你把旅行日程排在合适的时间，避开各国的假期。

预测市场

在产品或研究中使用市场赔率。

预测市场
应用场景涵盖内容
向客户和交易员展示降息、维持与加息的概率在客户界面或交易台展示降息、维持、加息的市场概率：如何措辞、取整、标注时间，以及如何从 Narwhal 刷新数据，让客户和交易员看到的概率措辞一致、带有明确的日期。
搭建宏观事件的市场赔率仪表盘利用 Narwhal 预测的主题和事件端点，搭建展示 CPI、非农就业、失业率、衰退和利率决议市场赔率的宏观事件赔率仪表盘，并给出各形态的读取方法和 Python 示例。
Polymarket Kalshi 套利：筛查两个预测市场之间的价差在 Narwhal 的一次调用中，筛查 Kalshi 与 Polymarket 的交易台可以同时拿到两边的报价、规则文本和结算来源，从而对照各自的赔付条件来解读价差。适用于寻找预测市场套利的候选。
预测市场 研究:获取赔率历史和已结算结果做预测市场 研究时，可以通过 Narwhal API 获取预测市场的赔率历史和已结算事件的结果，并从响应中读取 as_of、stale 和 final,直接用于研究。
把市场概率用作输入信号，并衡量预期变动的变化轮询 Narwhal 的政策利率路径，读取市场对央行决策的概率，并计算两次读数之间预期变动的变化量（单位为基点）。这是把预测市场用作交易信号的做法，附完整脚本示例。

通胀、利率与宏观

用官方统计进行调整、对标和监控。

通胀、利率与宏观
应用场景涵盖内容
把过去的预算和合同金额折算成当前价格为报告把过去的预算和合同金额折算成当前货币价值，完成通胀调整：选定基期月份和指数，再用 API 提供的 CPI 为数字加上标注，并给出 Python 折算示例与标注写法。
计算带下限和上限的 CPI 租金调整用 Narwhal API 中的两个 CPI 观测值，计算带下限和上限的租约年度 CPI 租金调整，并附带一个可以直接运行的 Python 脚本，方便你直接套用到自己的租约。
对照两个国家的通胀，检查加薪是否跑赢通胀用 Narwhal 的通胀端点，把加薪幅度与两个国家的 CPI 同比通胀率对比，检查加薪是否跑赢通胀，并算出实际购买力的变化，看看薪水是否仍能买到一年前的东西。
收益率曲线监控：每日记录利差并按阈值标记为风险团队做每日收益率曲线检查：从历史路由存储利差，按阈值标记，并连同来源日期记录每一次运行，让你直接得到可追溯的利差序列和警示，供风险团队每天都能查看和复核。
获取国家股权风险溢价和资本成本输入值获取任一覆盖国家的股权风险溢价，拆分为成熟市场溢价和国家风险溢价，并用它计算权益成本和 WACC，得到估算资本成本所需的各项输入值，方便直接用于估值模型，估值时更省事。
对比新兴市场的通胀、政策利率和增长用一个 API 对比印度尼西亚、巴西、墨西哥、印度等新兴市场的通胀、央行政策利率和 GDP 增长。先测试各国数据覆盖情况，缺少月度数据时回退到 World Bank 年度序列，并附 Python 示例。
用实时官方数据制作经济学教学练习围绕实际利率和 GDP 中的价格增长设计课堂经济学教学数据练习。使用来自官方来源的实时通胀、政策利率和 GDP 数据，并附带请求示例、响应和 Python 计算过程，帮助老师和学生完成两个练习。

关于这些应用场景

每个应用场景会说明任务，展示真实的请求和响应，并链接到相关的使用教程和 API 页面以了解详情。

所有示例都使用同一个免费 API 密钥，前 12 个月每月附带 $10 的免费额度。

通过 API 获取这些数据

试一试请求。

curl -H "Authorization: Bearer $NARWHAL_API_KEY" \
  "https://api.narwhalapi.com/v1/calendars/holidays/IDN/on/2026-08-17"
获取免费 API 密钥阅读快速入门指南