用途:该指南介绍如何通过国际货币基金组织(IMF)的免费 JSON REST API 获取宏观经济与金融数据,覆盖全球多数国家和地区的 GDP、通胀、贸易差额、汇率、政府财政统计与国际收支等指标,适合宏观经济学、发展经济学、国际金融与政策研究使用。可访问世界经济学展望(WEO)、国际金融统计(IFS)、国际收支统计(BOP)、贸易方向统计(DOTS)等数据集。
主要能力:API 无需认证,返回 JSON,采用数据集、指标、国家与时间维度的层级结构。DataMapper 接口较简单,SDMX JSON 服务更细粒度,支持月度/季度频率,可获取如 IFS 汇率时间序列等数据。
用法:列出数据集用 GET https://www.imf.org/external/datamapper/api/v1;列出指标用 GET https://www.imf.org/external/datamapper/api/v1/indicators;取指标数据用 GET https://www.imf.org/external/datamapper/api/v1/{indicator}?periods={year}。常用指标包括 NGDP_RPCH(实际 GDP 增长)、PCPIPCH(通胀)、BCA_NGDPD(经常账户余额占 GDP 比)、GGXWDG_NGDP(政府总债务占 GDP 比)、LUR(失业率)。更细粒度数据使用 SDMX 接口:GET http://dataservices.imf.org/REST/SDMX_JSON.svc/CompactData/{database}/{dimensions}?startPeriod={start}&endPeriod={end},例如月度 CPI:curl -s "http://dataservices.imf.org/REST/SDMX_JSON.svc/CompactData/IFS/M.US+CN.PCPI_IX?startPeriod=2020&endPeriod=2025" | python3 -m json.tool。示例:curl "https://www.imf.org/external/datamapper/api/v1/NGDP_RPCH?periods=2024"。
适用场景:跨国面板分析、政策影响评估、预测基准(可用 WEO 预测值)、发展经济学研究等。
限制:未公布正式速率限制,但建议持续使用时控制在每秒 1 次请求;数据更新频率低(季度/年度),应积极缓存;DataMapper 使用 ISO 三位国家代码,SDMX 使用两位代码;一次性获取多国数据优于逐国请求;不可用的国家-指标组合可能返回空对象而非报错。