文档
API 参考网站
浏览全部文档

变更日志

Narwhal API 的产品和文档更新。

跟踪公开网站、文档和 API 可用性的变更。

经济数据页面

  • 新增各国家及其指标的页面，提供历史图表、CSV下载和嵌入内容。
  • 新增各指标的跨国视图、按国家和月份查看的财经日历，以及收益率曲线。
  • 英文版国家覆盖范围页面现已重定向到各国的数据页面。

事件与Webhook

  • 新增GET /v1/events和/v1/events/stream WebSocket，支持重放游标。
  • 新增Webhook目标，支持带签名且至少一次的投递、投递历史和重放。
  • 为predictions事件类别新增prediction.event.closed和prediction.event.settled。

FX现已覆盖144种货币

  • 汇率、历史数据和货币换算新增113种货币。
  • 原有31种货币的请求保持不变。

金属与FX价格历史

  • 为黄金、白银、铂金和钯金新增GET /v1/commodities/spot/{commodity}/{currency}/bars和commodities_get_price_history。
  • 新增GET /v1/fx/rates/{base}/bars和fx_get_rate_bars，用于查询单一货币相对USD的数据。
  • 价格柱间隔为1m、5m、15m、1h、4h和1d。分钟级价格柱覆盖最近30天；小时级和日级价格柱无限期保留，可用历史范围受套餐限制。

商品月度基准与价格历史

  • 现有实物价格序列端点新增月度基准，支持发现序列、获取详情、最新价格和观测值。REST 和 MCP 使用相同的序列 ID。
  • 涵盖软商品、油脂和油籽、金属、谷物、能源、化肥、林产品以及畜牧和乳制品。所有价格均以 USD 计价，并保留发布时的单位和数量。
  • 最新可用月份为2026年9月。部分序列起始较晚或已结束。各序列会报告自己的覆盖日期。
  • 新增商品历史价格 API 页面、铜价格响应示例和完整的月度基准覆盖列表。

美国汽油和柴油零售价格

  • 在 /v1/commodities/physical/series 下新增四个 REST 和 MCP 操作，用于发现序列、获取序列详情、最新价格和观测值。
  • 新增20个普通汽油和2号公路用柴油的周度序列。每种产品均涵盖全美平均值和九个地区，价格以 USD/美制加仑计。
  • 历史包含2026年7月20日至10月5日的12周数据，每周一调查后更新。响应保留日期、以十进制字符串表示的价格、可为 null 的发布日期、修订信息和来源署名。

WTI、布伦特原油和铜的参考价格

  • GET /v1/commodities/spot/{commodity}/{currency} 和 commodities_get_spot_price 新增 WTI 和 BRENT（USD/桶）以及 XCU（USD/磅）。
  • 这些是基于期货市场的参考价格，并非实物货物的现货价格。响应字段和 stale 标记保持不变。
  • 可通过 GET /v1/commodities/spot/{commodity}/USD/bars 和 commodities_get_price_history 获取 WTI 和 BRENT 的价格历史，间隔和规则与金属相同。铜仅支持最新价格。

已添加铂金和钯金现货价格

  • 已通过 REST 和 MCP 添加以 USD 计价的 XPT 和 XPD 现货价格。
  • 黄金和白银保持不变：黄金以 31 种货币报价，白银以 USD 报价。

现货价格已移除 bid 和 ask 字段

  • 已从现货价格响应中移除 bid 和 ask。保留字段：symbol、price、currency、unit、timestamp、stale。
  • 期货端点保持不变，继续保留 bid 和 ask 字段。

经济数据发布指标支持更多值类型

  • 已为每个指标添加 annualization 字段，始终设为 annualized 或 not_annualized。
  • 已在 index、percent 和 thousands 之外添加 currency、ratio 和 balance 单位，并仅为货币金额提供 currency（ISO 4217 代码）和 scale（units、thousands、millions、hundred_millions、billions）字段。
  • 已在 level、month_over_month 和 year_over_year 之外添加 quarter_over_quarter、three_month_on_three_month 和 change 转换方式。
  • 允许 reference_period 和数值期间在现有的月份（YYYY-MM）和季度（YYYY-Qn）之外，使用周结束日期（YYYY-MM-DD）和滚动三个月窗口（YYYY-MM/YYYY-MM）。
  • 已明确这些字段今后可能出现新的枚举值，客户端应接受未知值，避免解析失败。

历史外汇观测数据现已上线

  • 新增 GET /v1/fx/rates/{base}/observations 和 fx_get_rate_history。
  • 新增包含起止日期的日期范围、设有页大小限制的按日期分页，以及与筛选条件绑定的不透明游标，用于完整历史数据回填。
  • 保留真实观测日期，不对周末、假日或缺失货币进行向前填充。

荷兰数据已在经济数据 API 中上线

  • 在全部九个公开的经济数据 REST 操作及对应的 MCP 工具中新增 NLD。
  • 已发布 Statistics Netherlands (CBS) 提供的月度 CPI、劳动力和货物贸易数据，以及季度 GDP 数据。
  • 新增荷兰覆盖范围、来源方法、API 文档和机器发现功能。

历史经济数据与荷兰覆盖范围

  • 通过 REST 和 MCP 新增九个分页的历史观测操作。
  • 新增 CBS 提供的荷兰官方通胀、劳动力、GDP 和货物贸易数据。
  • 公开的经济数据 API 已扩展至十个国家和 18 个操作。

公开经济数据测试版

  • 已通过 REST 和 MCP 开放九项国家经济数据操作。
  • 已上线 AUS、CAN、DEU、FRA、GBR、JPN、MYS、SGP 和 USA 的当前官方数据。
  • 已发布经济数据快速入门指南和机器可读的发现信息。