印度宏观经济指标每日刷新数据集与静态 API
数据集简介
项目定位与访问入口
India Macro War Room 面向需要把印度宏观数字直接接入应用、表格或笔记本的使用者:同一组数字既可在单屏仪表盘中浏览,也可通过静态 API 以文件形式读取。仓库提供 Dashboard、API base、API mirror 与 Reference 四类入口,API 镜像可绕开单一托管点的可用性波动。
- Dashboard:单屏呈现 26 张图表。
- API base / API mirror:分别指向 GitHub Pages 与 jsDelivr 等静态托管位置。
- Reference:指向数据字典与定义文档。
数据集内容与覆盖范围
数据集以结构化表格形式组织,JSON 与 CSV 两种时间序列并存。全部内容包含 38 项指标、26 张图表、33 条有出处的定义,约 7,700 条存储观测,底层来自 12 张 RBI 报表,并保持每日刷新。仓库自身累计 25 次提交。
八组指标及其关注点如下:
| 组别 | 关注内容 |
|---|---|
| 物价 | 通胀相关价格指标 |
| 政策利率 | 央行政策利率设定 |
| 货币与通货 | 货币供应与通货数据 |
| 流动性 | 银行体系流动性状况 |
| 信贷与银行 | 信贷投放与银行部门指标 |
| 市场 | 金融市场相关指标 |
| 对外部门 | 对外经济账户指标 |
| 财政与政府票据 | 财政状况与政府票据 |
每项指标均携带单位、发布频率、来源报表、有出处的定义、基于规则生成的状态以及自身对应的期间,便于使用者判断数值所处的时间口径。
快速上手:读取 API
API 以纯文件形式提供,无需密钥与注册,所有响应带 access-control-allow-origin: *,可直接在浏览器、脚本或前端页面中跨域读取。常用端点包括:
api/v1/index.json:指标目录,含 id、label、unit、group、kind、frequency、status、latest 与 links。api/v1/latest.json:按指标 id 键控的全部当前值。api/v1/series/<id>.json:单指标完整历史,points 为 [ISO日期, 数值] 形式。api/v1/series/<id>.csv:同样的历史以 date,value 两列呈现。api/v1/settings.json:政策设定值及 effective_from。api/v1/status.json、verification.json与 manifest:用于核对数据状态与完整性。
数据流水线的工作方式
整个流程由 GitHub Actions 驱动,分为抓取、构建、发布三个阶段,零服务器、零成本运行。
- Fetch:每日从 RBI 的 DBIE 公共数据库抓取 12 张报表,并取得门户关键利率快照,原始结果落在
raw/*.json。 - Build:由脚本重建数据集、仪表盘与静态 API,生成目录、当前值、历史序列、政策设定与校验文件。
- Publish:把带版本号的静态文件发布到 GitHub Pages 与镜像,供外部直接读取。
方法论要点
流水线在抓取之外还处理派生计算、发布日历与新鲜度策略:部分指标由原始报表经派生运算得到;每项指标按各自的发布频率与发布日历更新;新鲜度策略用于标记数据状态,配合基于规则生成的状态字段,帮助使用者识别指标是否处于最新期。定义文档 definitions.json、docs/DATA_DICTIONARY.md 与 docs/DEFINITIONS.md 记录了字段含义与 33 条有出处的定义。
许可、署名与来源声明
代码采用 MIT 许可;数据汇编自 RBI 公开出版物,使用时需署名,并声明“非 RBI 官方产品”。仓库结构包含 .github、api/v1、assets、dashboard、docs、raw、scripts 与 tools 等目录,便于按需查阅原始数据、脚本与文档。