indec

INDEC Argentina — 时间序列官方 API

用于提取阿根廷宏观经济和社会数据的高级技能，数据来自 阿根廷国家官方 API： apis.datos.gob.ar/series——无需 API key，无需身份验证，提供 官方文档和不间断 ABI 政策。

与基于内部 API（TradingView、Google Finance）的技能不同，这是一个官方公共 API，由国家数据与公共信息司维护。 它是整个仓库中最稳定、最可靠的 API。

---

🎯 覆盖哪些数据

官方目录中共有约 4,250 个时间序列，汇总了 阿根廷多个公共机构的数据：

机构	数据类型
INDEC	全国 IPC、GBA IPC、EMAE、IPI、ISAC、EPH（就业/失业）、贫困、人口普查、对外贸易、GDP
BCRA	汇率、储备、REM 预期、外汇收支、利率
经济部	国民账户 GDP、公共债务、财政
劳动司（MTEySS）	RIPTE、SMVM、退休金金额
DGEYC（CABA）	布宜诺斯艾利斯市 IPC

---

🚀 快速开始

# Snapshot rapido de la economia argentina
py scripts/fetch_indec.py snapshot --last 3

# IPC ultimos 12 meses
py scripts/fetch_indec.py ipc --last 12

# EMAE original + desestacionalizado
py scripts/fetch_indec.py emae --last 12

# Tipo de cambio diario → cierre mensual
py scripts/fetch_indec.py dolar --collapse month --aggregation end_of_period --last 12

# Buscar serie por keyword
py scripts/fetch_indec.py search "pobreza" --limit 10

# Serie por ID con transformacion (var YoY)
py scripts/fetch_indec.py series "145.3_INGNACUAL_DICI_M_38" --mode percent_change_a_year_ago --last 12

---

⚡ 此技能的独特功能

此 API 的三项杀手级功能（仓库中的其他技能不具备）：

1. 内置服务端转换

直接根据 IPC 指数获取同比通胀或年初至今累计值，无需在客户端计算：

# Inflacion interanual ya calculada
py scripts/fetch_indec.py series "<ID_IPC_INDICE>" --mode percent_change_a_year_ago

可用模式：value、change、percent_change、 percent_change_a_year_ago（同比通胀）、 percent_change_since_beginning_of_year（年初至今通胀）、 change_a_year_ago、change_since_beginning_of_year。

参见 references/REPRESENTATION_MODES.md。

2. 内置时间聚合

直接在服务端将日度序列转换为月度/年度序列：

# Dolar diario → cierre mensual
py scripts/fetch_indec.py dolar --collapse month --aggregation end_of_period

折叠周期：day、week、month、quarter、semester、year。 聚合方式：avg、sum、end_of_period、min、max。

参见 references/COLLAPSE_AGGREGATIONS.md。

3. 单次请求获取多个序列

在 1 次请求中组合 IPC + RIPTE + 美元：

py scripts/fetch_indec.py series "145.3_INGNACUAL_DICI_M_38,158.1_REPTE_0_0_5,168.1_T_CAMBIOR_D_0_0_26" --last 12

---

技能结构

skills/indec/
├── SKILL.md                                # Este archivo
├── references/                             # 10 documentos exhaustivos
│   ├── REFERENCE.md                        # Overview general
│   ├── ENDPOINTS.md                        # Deep dive de los 4 endpoints
│   ├── PARAMS.md                           # Cada parametro explicado
│   ├── REPRESENTATION_MODES.md             # Las 7 transformaciones
│   ├── COLLAPSE_AGGREGATIONS.md            # Agregacion temporal
│   ├── SERIES_CATALOG.md                   # IDs canonicos por topico
│   ├── RESPONSE_FORMAT.md                  # Schema JSON / CSV completo
│   ├── DATA_SOURCES.md                     # Organismos publicadores
│   ├── COOKBOOK.md                         # 30+ recetas
│   └── LIMITATIONS_TROUBLESHOOTING.md      # Limites + errores comunes
├── assets/                                 # 5 archivos JSON
│   ├── known_series_ids.json               # Catalogo curado de IDs
│   ├── series_groups.json                  # Bundles pre-armados
│   ├── representation_modes.json           # Modes con ejemplos
│   ├── collapse_aggregations.json          # Aggregations con ejemplos
│   └── data_sources.json                   # Publicadores estructurados
└── scripts/
    └── fetch_indec.py                      # Script con 19 modos CLI

---

提供 19 种 CLI 模式

直接查询（4 种模式）

模式	描述
series IDS	按 ID 获取数据——功能最强大的模式
search QUERY	按关键词搜索时间序列
validate IDS	验证 ID 是否有效
dump	完整目录（体积较大，约数 MB）

指标快捷方式（9 种模式）

模式	返回内容	组合的 ID
ipc	全国 IPC 月度变化	1 个 ID
ipc-completo	IPC + 核心项 + 管制项目 + 类别	5 个 ID
emae	EMAE 原始值 + 季节性调整值	2 个 ID
salarios	RIPTE + SMVM + 退休金金额	5 个 ID
comercio	出口总额（M/T/A）	3 个 ID
construccion	ISAC 总体水平	2 个 ID
dolar	BNA 日度汇率	1 个 ID（BCRA）
reservas	BCRA 国际储备	4 个 ID（BCRA）
snapshot	阿根廷宏观经济快照	组合 5 个 ID

本地目录（5 种模式）

模式	返回内容
catalog	主要时间序列 ID 的精选目录
groups	预先组合的套件
sources	数据发布机构
modes	可用的表示模式
aggregations	可用的折叠聚合方式

组合模式（1 种）

模式	返回内容
all	完整宏观经济快照：IPC + EMAE + 工资 + 美元 + 储备 + 建筑 + 贸易

---

主要标志

标志	描述
--start YYYY-MM-DD	起始日期
--end YYYY-MM-DD	截止日期
--last N	最近 N 个值（⚠️ 与 sort/start/limit 不兼容）
--mode X	表示模式（value / percent_change / percent_change_a_year_ago / 等）
--collapse X	时间聚合（day/week/month/quarter/semester/year）
--aggregation X	聚合模式（avg/sum/end_of_period/min/max）
--limit N	每个序列的数据点数（最多 1000）
--offset N	分页偏移量
--sort asc/desc	排序
--metadata X	详细程度（none/only/simple/full）
--format X	json 或 csv
--raw	未规范化的响应
-o file	保存到文件
-q	静默模式

---

与 bcra-macro 和其他技能的差异

特性	indec	bcra-macro	FRED
无需身份验证	✅	✅	❌ 需要 key
完整覆盖 INDEC	✅	❌	❌
覆盖 BCRA	⚠️ 子集	✅ 638 个序列	❌
多机构	✅ INDEC + BCRA + Min Econ	❌ 仅 BCRA	✅ 全球
内置转换（% YoY、YTD）	✅ 唯一	❌	⚠️ 需要 FRED transform
内置时间聚合	✅ 唯一	❌	⚠️
单个请求支持多序列	✅ 唯一	❌	❌
公开官方文档	✅	✅	✅

何时使用 indec，何时使用 bcra-macro：

• INDEC（IPC、EMAE、EPH、PIB）→ indec
• 仅需完整覆盖 BCRA → bcra-macro
• 在一个数据集中交叉使用 INDEC + BCRA → indec

---

常见用例

references/COOKBOOK.md 中提供了 30+ 个完整配方。

# Inflacion mensual ultimos 12 meses
py scripts/fetch_indec.py ipc --last 12

# Inflacion interanual desde el indice
py scripts/fetch_indec.py series "<ID_IPC_INDICE>" --mode percent_change_a_year_ago

# Dolar diario → promedio mensual
py scripts/fetch_indec.py dolar --collapse month --aggregation avg

# Exportaciones totales por año
py scripts/fetch_indec.py series "75.3_IETG_0_M_31" --collapse year --aggregation sum --last 10

# Comparar IPC + RIPTE + Dolar (poder adquisitivo)
py scripts/fetch_indec.py series "145.3_INGNACUAL_DICI_M_38,158.1_REPTE_0_0_5,168.1_T_CAMBIOR_D_0_0_26" --last 12

# Snapshot macro
py scripts/fetch_indec.py snapshot --last 3

---

完整文档

文档	内容
references/REFERENCE.md	总览 + 架构
references/ENDPOINTS.md	深入介绍 /series、/search、/dump、/validate
references/PARAMS.md	每个参数的有效值、默认值和示例
references/REPRESENTATION_MODES.md	7 种转换及计算示例
references/COLLAPSE_AGGREGATIONS.md	时间聚合及用例
references/SERIES_CATALOG.md	按主题整理的规范 ID
references/RESPONSE_FORMAT.md	完整的 JSON / CSV 架构
references/DATA_SOURCES.md	发布数据集的机构
references/COOKBOOK.md	30+ 个可直接复制粘贴的配方
references/LIMITATIONS_TROUBLESHOOTING.md	限制 + 常见错误 + 调试
assets/known_series_ids.json	精选 ID 目录
assets/series_groups.json	按用例预先整理的组合
assets/representation_modes.json	模式及其描述
assets/collapse_aggregations.json	聚合方式及用例
assets/data_sources.json	结构化发布机构信息

---

⚠️ 已知限制

限制的完整文档见 references/LIMITATIONS_TROUBLESHOOTING.md。

最重要事项

1. 每个请求中每个序列最多 1,000 个数据点——对于很长的序列，使用 --offset 分页。
2. --last 与 --sort、--limit、--offset 不兼容——脚本会自动处理。
3. 频率混杂的多序列——显式使用 --collapse，以避免意外情况。
4. 已停用的序列会在 dataset.title 中标记为 SERIE DISCONTINUADA——请在客户端过滤。
5. 加密货币 ID——不要猜测，请使用 search 或精选目录。
6. INDEC 数据延迟：月度 IPC 约 15 天后发布，季度 GDP 约 3 个月后发布。

为什么此 API 比其他 API 更可靠

与 TradingView／Google Finance／BYMA（均为内部 API）不同：

• ✅ 阿根廷政府的官方公共 API。
• ✅ 官方文档：datosgobar.github.io/series-tiempo-ar-api
• ✅ GitHub 上的开源代码：datosgobar/series-tiempo-ar-api
• ✅ ABI 不间断政策——自 2017 年以来一直稳定。
• ✅ 公开的问题跟踪器。

基于此 API 构建产品，比基于内部 API 更有信心。

---

外部参考

• 官方文档： https://datosgobar.github.io/series-tiempo-ar-api/
• 开源代码（GitHub）： https://github.com/datosgobar/series-tiempo-ar-api
• datos.gob.ar 门户： https://datos.gob.ar
• INDEC 官方网站： https://www.indec.gob.ar
• BCRA 官方网站： https://www.bcra.gob.ar