宏观经济指标清单
公开接口宏观经济 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
指标代码单位频率
中国 制造业 PMI
CN_PMI_MFG点月度中国 非制造业 PMI
CN_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_(全球)系列。
Esc