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

不要将密钥放在 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 替换为覆盖范围矩阵中该操作支持的国家代码，再将 cpi 替换为文档中列出的其他操作路径，以请求通胀、失业率、劳动力参与率、GDP、GDP 增长率、贸易、出口或进口数据。这些操作的覆盖范围可能不同。

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

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

错误正文使用 application/problem+json，并包含请求 ID。对 500 和 503 响应采用设有上限的退避策略重试。遇到 400 和 401 响应时，先修正请求再重试；遇到 429 时，等待文档规定的配额重置时间后再重试。

REST 和 MCP 使用相同的数据

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

请求限定范围的历史数据页

需要最新发布版本之外的数据时，请使用对应的历史路由。分页时保持 country、start、end 和 limit 参数不变，并将返回的 next_cursor 作为下一次请求的 cursor。如果游标过期或发布版本被撤回，请去掉游标重新开始。有效范围内没有数据与序列不可用是两种不同情况，应用应保留空结果。

历史请求

curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/cpi/observations?start=2025-01&end=2026-07&limit=100" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

来源与参考

发布于 2026年8月27日。最近核查于 2026年9月29日。