設定用戶端
請使用 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。它們的政策路徑反映的是預測市場的機率，不是官方預測。
發布日期： 。最近審閱日期： 。