设置客户端
请使用 Node 22 或更高版本，并在服务器环境中设置 NARWHAL_API_KEY。切勿在浏览器代码中放置 API 密钥。安装软件包并创建客户端。参见快速入门。
// npm install narwhalapi
import { Narwhal } from "narwhalapi";
// Reads NARWHAL_API_KEY from the server environment.
const nw = new Narwhal();通过短期收益率获取市场利率
请求短期期限的国债收益率作为市场利率。数据来源公布 3 个月期收益率时即可获取该项。可用期限因国家和日期而异；缺失的期限会被省略。十进制值以精确的字符串形式返回，十进制输入不能是数字。
const short = await nw.economics.yieldCurve("GBR", { maturity: ["3m", "2y"] }); for (const point of short.yields) { console.log(point.maturity, point.yield_percent); }读取市场隐含的政策路径
请求英格兰银行市场隐含的政策利率路径。各次会议包含 p_cut、p_hold 和 p_hike（概率字符串），以及 expected_change_bps、cumulative_change_bps 和 resolves_at。这些是预测市场的概率，不是官方预测。
const path = await nw.predictions.policyPath("bank-of-england"); for (const meeting of path.meetings) { console.log(meeting.resolves_at, meeting.p_cut, meeting.p_hold, meeting.p_hike); }常见问题
可以获取央行当前的政策利率吗？
不能。Narwhal 没有提供当前官方政策利率的接口。你可以获取短期国债收益率，以及即将召开的政策会议的市场隐含概率。
为什么缺少 3 个月期收益率？
可用期限取决于该国的数据来源和请求日期。缺失的期限会被省略，因此只有数据来源公布 3 个月期收益率时才会返回该项。
还可以查询哪些其他政策机构？
其他机构包括 bank-of-canada、bank-of-japan 和 bank-indonesia。它们的政策路径反映的是预测市场的概率，而不是官方预测。
发布于 。最近核查于 。