DataBull

宏观经济指标序列

公开接口

宏观经济 Macro · 宏观经济指标序列

按指标代码查询宏观经济时间序列，按数据日期升序返回。支持中国 CPI 同比/环比/累计、PPI 同比/累计、制造业/非制造业 PMI、GDP 及同比、货币供应（M0/M1/M2 及 M2 同比）、外汇储备，以及波罗的海干散货指数（GLOBAL_BDI，日频，历史可回溯至 1985 年）等核心指标。日期留空表示不限制该端（即该指标的全量历史）。可查的代码与中文名见下方「指标目录」。

接口地址

GET /macro/indicator
完整地址：https://api.databull.cn/macro/indicator

接口说明

按指标代码查询宏观经济时间序列，按数据日期升序返回。
indicator_code 为指标代码（如 CN_CPI_YOY 中国 CPI 同比、CN_PPI_YOY 中国 PPI 同比、CN_M2_YOY 货币供应 M2 同比、CN_GDP_YOY GDP 同比、CN_PMI_MFG 制造业 PMI、CN_FX_RESERVES 外汇储备、GLOBAL_BDI 波罗的海干散货指数）。日期留空表示不限制该端。
日频指标（如 GLOBAL_BDI）可用 start_date/end_date 截取区间，两端均留空会返回全部历史。
响应为 {"code": 0, "data": [...]}，无数据时响应头 X-Empty-Reason: no_data_in_range。

指标目录

以下指标均通过同一接口 GET /macro/indicator 按 indicator_code 查询；下表为当前已接入的代码一览（国家/地区以代码前缀区分，如 CN_ 中国）。

居民消费价格 CPI

指标代码单位频率
中国 CPI 同比CN_CPI_YOY%月度
中国 CPI 环比CN_CPI_MOM%月度
中国 CPI 累计CN_CPI_ACCUM%月度

工业生产者价格 PPI

指标代码单位频率
中国 PPI 同比CN_PPI_YOY%月度
中国 PPI 累计CN_PPI_ACCUM%月度

制造业与服务业景气 PMI

指标代码单位频率
中国 制造业 PMICN_PMI_MFG点月度
中国 非制造业 PMICN_PMI_SERVICES点月度

国内生产总值 GDP

指标代码单位频率
中国 GDP 绝对值CN_GDP亿元季度
中国 GDP 同比CN_GDP_YOY%季度

货币供应

指标代码单位频率
中国 M2 供应量CN_M2亿元月度
中国 M2 同比CN_M2_YOY%月度
中国 M1 供应量CN_M1亿元月度
中国 M0 供应量CN_M0亿元月度

外汇储备

指标代码单位频率
中国 外汇储备CN_FX_RESERVES亿美元月度

航运与大宗运输

指标代码单位频率
波罗的海干散货指数GLOBAL_BDI点日度

请求参数

参数位置类型必填默认说明
indicator_code查询string否CN_CPI_YOY指标代码，如 CN_CPI_YOY / CN_PPI_YOY / CN_M2_YOY / CN_GDP_YOY / CN_PMI_MFG / CN_FX_RESERVES / GLOBAL_BDI
start_date查询string否起始日期（含），YYYY-MM-DD；留空表示不限起始
end_date查询string否结束日期（含），YYYY-MM-DD；留空表示不限结束

返回字段

字段类型说明
codenumber业务状态码，0 表示成功
dataarray按数据日期升序的记录数组
data[].indicator_codestring指标代码，如 CN_CPI_YOY
data[].countrystring国家/地区代码，如 CN（中国）、GLOBAL（全球性指标）
data[].freqstring频率：monthly / quarterly / daily
data[].trade_datestring数据日期（报告期：月末/季末/交易日），YYYY-MM-DD
data[].valuenumber指标观测值
data[].unitstring单位，如 % / 亿元 / 亿美元 / 点
empty_reasonstring仅当 data 为空时出现：no_data_in_range（该代码在此时段无记录）

接口示例

cURL
curl "https://api.databull.cn/macro/indicator?indicator_code=CN_CPI_YOY&start_date=20260101" \
  -H "Authorization: Bearer $DATABULL_API_KEY"
Python
from databull import DataBull

client = DataBull(api_key="YOUR_API_KEY")
result = client.get_macro_indicator(indicator_code="CN_CPI_YOY")
print(result)

响应示例

JSON
{
  "code": 0,
  "data": [
    {
      "indicator_code": "CN_CPI_YOY",
      "country": "CN",
      "freq": "monthly",
      "trade_date": "2026-06-30",
      "value": 0.9,
      "unit": "%"
    },
    {
      "indicator_code": "CN_CPI_YOY",
      "country": "CN",
      "freq": "monthly",
      "trade_date": "2026-07-31",
      "value": 0.7,
      "unit": "%"
    },
    {
      "indicator_code": "CN_CPI_YOY",
      "country": "CN",
      "freq": "monthly",
      "trade_date": "2026-08-31",
      "value": 0.8,
      "unit": "%"
    }
  ]
}

错误码

状态码触发条件
401缺少或无效 API 凭证

说明

  • 响应为 {"code": 0, "data": [...]} 信封结构。
  • 所有指标都通过本接口查询，区别在于 indicator_code：例如「中国 CPI 同比」填 CN_CPI_YOY、「中国 GDP 同比」填 CN_GDP_YOY、「中国 M2 供应量」填 CN_M2。完整清单见上方「指标目录」。
  • 日期参数格式为 YYYY-MM-DD，留空表示不限制该端。
  • 日频指标请带日期区间。如 GLOBAL_BDI 两端都留空会返回自 1985 年起的全部历史（约 1 万条、1 MB 以上）；只要近期数据时用 start_date 截取即可。
  • 区间内无数据时 data 为空数组，响应头 X-Empty-Reason: no_data_in_range 标明是「该指标在此时段没有记录」，而不是接口异常。
  • 指标数据自动同步：月度/季度指标每月同步，日频指标（GLOBAL_BDI）每个交易日同步；若列表里查不到某代码，多半是指标尚未接入。