Narwhal 文档
简体中文
API 参考网站
浏览全部文档

Economics API 参考

十个国家的最新发布和历史观测数据。

九条路由返回最近一次接受的官方发布数据。九个对应的 /observations 路由返回当前已接受的时间序列。REST 和 MCP 使用相同的架构，并消耗相同的月度额度。

基础 URL 和参数

REST 基础路径
https://api.narwhalapi.com/v1/economics/{country}
  • country 是受支持的大写 ISO alpha-3 代码。
  • period 为可选项。对于最新发布版本请省略；否则传入该操作要求的月、季度或年份格式。
  • 每个请求都必须携带文档所述的 Bearer 请求头： 身份验证.
请求一个已知期间
curl --request GET \
  --url "https://api.narwhalapi.com/v1/economics/USA/cpi?period=2026-07" \
  --header "Authorization: Bearer $NARWHAL_API_KEY"

国家

AUS, CAN, DEU, FRA, GBR, JPN, MYS, NLD, SGP，以及 USA.

每个国家都支持相同的九项最新数据操作和九项历史数据操作。

最新发布版本

打开某个操作页面，查看确切参数、接受的期间格式、响应字段、示例、错误、数据新鲜度和当前限制。

操作REST 路径期间
消费者价格指数/v1/economics/{country}/cpiYYYY-MM
通胀/v1/economics/{country}/inflationYYYY-MM
失业率/v1/economics/{country}/unemploymentYYYY, YYYY-MM, or YYYY-QN
劳动力参与率/v1/economics/{country}/labour-force-participationYYYY, YYYY-MM, or YYYY-QN
国内生产总值/v1/economics/{country}/gdpYYYY-QN
GDP 增长率/v1/economics/{country}/gdp-growthYYYY-QN
商品贸易/v1/economics/{country}/tradeYYYY or YYYY-MM
商品出口/v1/economics/{country}/trade/exportsYYYY or YYYY-MM
商品进口/v1/economics/{country}/trade/importsYYYY or YYYY-MM

历史观测数据

历史路由接受 start, end, limit，以及 cursor。结果按时间从旧到新排列，表示当前已接受的数据序列，而不是过去每次发布的版本。

操作REST 路径期间
消费者价格指数 历史/v1/economics/{country}/cpi/observationsYYYY-MM
通胀 历史/v1/economics/{country}/inflation/observationsYYYY-MM
失业率历史/v1/economics/{country}/unemployment/observationsYYYY, YYYY-MM, or YYYY-QN
劳动力参与率历史数据/v1/economics/{country}/labour-force-participation/observationsYYYY, YYYY-MM, or YYYY-QN
国内生产总值历史数据/v1/economics/{country}/gdp/observationsYYYY-QN
GDP 增长率历史数据/v1/economics/{country}/gdp-growth/observationsYYYY-QN
商品贸易历史数据/v1/economics/{country}/trade/observationsYYYY-MM
商品出口历史数据/v1/economics/{country}/trade/exports/observationsYYYY-MM
商品进口历史数据/v1/economics/{country}/trade/imports/observationsYYYY-MM

字段约定

字段或规则含义
country请求的ISO alpha-3国家代码。
period响应所代表的确切官方月份、季度或年份。
released_on官方发布日期，而不是 Narwhal 的检索时间。
十进制字符串经济数值使用字符串，以保留精确的十进制表示。
单位和基准在适用时，汇率、货币、价格基准、年化方式、覆盖范围和指数基准均保持明确。
缺失的发布版本Narwhal 在失败时关闭请求，不会编造、前向填充或将缺失值转换为零。

OpenAPI 与发现功能

当前公开测试限制

公开发现仅限于上述 18 条路由和十个国家。印度尼西亚及地区路由不属于公开 Economics 测试版。

查看 错误与配额 用于说明序列缺失和服务不可用时的行为。