发起你的第一个经济数据请求

不要将密钥放在 URL 中

将 Narwhal 密钥存储为密钥或环境变量。在 Authorization 标头中以 Bearer 令牌发送。不要将其放进查询字符串、提交到代码库或暴露在浏览器代码中。

调用 CPI 端点

省略 period 以获取最新已接受的完整发布版本。

curl --request GET \
  --url https://api.narwhalapi.com/v1/economics/USA/cpi \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

阅读响应

响应是带类型的JSON，不含通用data包装器。十进制数值使用字符串，避免客户端无提示地丢失精度。缺失值保持缺失，不会变为零。

{
  "country": "USA",
  "period": "2026-07",
  "value": "333.918",
  "base_period": "1982-84",
  "base_value": "100",
  "released_on": "2026-08-12"
}

更改国家或操作

将 USA 替换为 AUS、CAN、DEU、FRA、GBR、JPN、MYS、NLD 或 SGP，即可为另一个已上线国家请求相同指标。将 cpi 替换为其他文档化操作路径，即可请求通胀、失业、劳动力参与率、GDP、GDP 增长、贸易、出口或进口数据。

按状态和错误代码处理错误

400 响应表示请求无效；401 表示 API 密钥缺失或无效；404 表示所请求的路由或序列不可用；429 表示额度已耗尽；503 表示当前无法安全提供所请求的数据或服务。

错误正文使用 application/problem+json，并包含请求 ID。对 500 和 503 响应使用有界退避重试。再次尝试前修正 400 和 401 响应；重试 429 前等待文档说明的重置时间。

REST 和 MCP 使用 该 相同 数据

MCP 工具使用与 REST 相同的密钥、已存储发布版本、响应架构和数据额度。选择适合应用的接口；底层经济数据相同。