DataBull

宏观经济指标清单

公开接口

宏观经济 Macro · 宏观经济指标清单

返回已接入的宏观经济指标元信息：指标代码、国家/地区、频率、单位、最新数据日期与最新值。可用作查询时间序列前确认可查的代码（如 CN_CPI_YOY、CN_M2_YOY、GLOBAL_BDI）。宏观月度/季度指标每月自动同步，日频指标（如 GLOBAL_BDI）每个交易日自动同步。

接口地址

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

接口说明

返回已接入的宏观经济指标元信息：指标代码、国家/地区、频率、单位、最新数据日期与最新值。用于确认可查询的指标代码（如 CN_CPI_YOY、CN_M2_YOY）。
尚未同步入库时返回 {"code": 0, "data": [], "empty_reason": "not_synced"}。

指标目录

以下指标均通过同一接口 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点日度

返回字段

字段类型说明
codenumber业务状态码，0 表示成功
dataarray指标元信息数组
data[].indicator_codestring指标代码，如 CN_CPI_YOY（中国 CPI 同比）、CN_M2_YOY（M2 同比）
data[].countrystring国家/地区代码，如 CN（中国）、GLOBAL（全球性指标）
data[].freqstring数据频率：monthly 月度 / quarterly 季度 / daily 日度
data[].unitstring单位，如 % / 亿元 / 亿美元 / 点
data[].latest_datestring该指标最新一条数据的报告期（YYYY-MM-DD）
data[].latest_valuenumber该指标最新一条数据的观测值
empty_reasonstring仅当 data 为空时出现，固定为 not_synced（尚未同步入库）

接口示例

cURL
curl "https://api.databull.cn/macro/indicators" \
  -H "Authorization: Bearer $DATABULL_API_KEY"
Python
from databull import DataBull

client = DataBull(api_key="YOUR_API_KEY")
result = client.list_macro_indicators()
print(result)

响应示例

JSON
{
  "code": 0,
  "data": [
    {
      "indicator_code": "CN_CPI_YOY",
      "country": "CN",
      "freq": "monthly",
      "unit": "%",
      "latest_date": "2026-08-31",
      "latest_value": 0.8
    },
    {
      "indicator_code": "CN_PPI_YOY",
      "country": "CN",
      "freq": "monthly",
      "unit": "%",
      "latest_date": "2026-08-31",
      "latest_value": -2.5
    },
    {
      "indicator_code": "CN_PMI_MFG",
      "country": "CN",
      "freq": "monthly",
      "unit": "点",
      "latest_date": "2026-08-31",
      "latest_value": 49.4
    },
    {
      "indicator_code": "CN_GDP_YOY",
      "country": "CN",
      "freq": "quarterly",
      "unit": "%",
      "latest_date": "2026-06-30",
      "latest_value": 5.2
    },
    {
      "indicator_code": "CN_M2_YOY",
      "country": "CN",
      "freq": "monthly",
      "unit": "%",
      "latest_date": "2026-08-31",
      "latest_value": 8.8
    },
    {
      "indicator_code": "CN_FX_RESERVES",
      "country": "CN",
      "freq": "monthly",
      "unit": "亿美元",
      "latest_date": "2026-08-31",
      "latest_value": 33100.0
    }
  ]
}

错误码

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

说明

  • 响应为 {"code": 0, "data": [...]} 信封结构。
  • 指标清单自动同步：CPI、PPI、PMI、GDP、货币供应（M0/M1/M2）、外汇储备等核心指标每月同步；波罗的海干散货指数（GLOBAL_BDI）每个交易日同步。
  • 尚未同步入库时返回 {"code": 0, "data": [], "empty_reason": "not_synced"}，此时请稍后重试或直接用「宏观经济指标序列」接口指定代码查询。
  • 指标代码以 CN_ 前缀标识中国系列；后续会扩展 US_（美国）、GLOBAL_（全球）系列。