indec
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseINDEC Argentina — API Oficial de Series de Tiempo
阿根廷INDEC — 官方时间序列API
Skill premium para extraer datos macroeconomicos y sociales de
Argentina via la API oficial del Estado Argentino:
— sin API key, sin autenticacion, con
documentacion oficial y politicas de no-break ABI.
apis.datos.gob.ar/seriesA diferencia de skills basados en APIs internas (TradingView, Google
Finance), esta es una API PUBLICA OFICIAL mantenida por la Direccion
Nacional de Datos e Informacion Publica. Es la API mas estable y
confiable de todo el repositorio.
高级Skill,用于通过阿根廷官方API提取阿根廷宏观经济与社会数据:
— 无需API密钥、无需认证,具备官方文档与不中断ABI政策。
apis.datos.gob.ar/series与基于内部API(TradingView、Google Finance)的Skill不同,这是由阿根廷国家公共数据与信息局维护的官方公开API,是整个仓库中最稳定、最可靠的API。
🎯 Que datos cubre
🎯 涵盖的数据
~4,250 series totales del catalogo oficial, agregando datos de
multiples organismos publicos argentinos:
| Organismo | Tipo de datos |
|---|---|
| INDEC | IPC nacional, IPC GBA, EMAE, IPI, ISAC, EPH (empleo/desempleo), pobreza, censos, comercio exterior, PIB |
| BCRA | Tipo de cambio, reservas, REM expectativas, balance cambiario, tasas |
| Min Economia | PIB cuentas nacionales, deuda publica, fiscal |
| Sec Trabajo (MTEySS) | RIPTE, SMVM, haber jubilatorio |
| DGEYC (CABA) | IPC Ciudad de Buenos Aires |
官方目录共包含约4250个数据序列,整合了阿根廷多个公共机构的数据:
| 机构 | 数据类型 |
|---|---|
| INDEC | 全国IPC、GBA地区IPC、EMAE、IPI、ISAC、EPH(就业/失业)、贫困、人口普查、对外贸易、GDP |
| BCRA | 汇率、外汇储备、REM预期、国际收支平衡、利率 |
| 经济部 | GDP国民账户、公共债务、财政数据 |
| 劳工部(MTEySS) | RIPTE、SMVM、养老金收入 |
| DGEYC(布宜诺斯艾利斯市) | 布宜诺斯艾利斯市IPC |
🚀 Quick start
🚀 快速开始
bash
undefinedbash
undefinedSnapshot rapido de la economia argentina
阿根廷经济快速快照
py scripts/fetch_indec.py snapshot --last 3
py scripts/fetch_indec.py snapshot --last 3
IPC ultimos 12 meses
过去12个月的IPC数据
py scripts/fetch_indec.py ipc --last 12
py scripts/fetch_indec.py ipc --last 12
EMAE original + desestacionalizado
原始EMAE数据+经季节调整的数据
py scripts/fetch_indec.py emae --last 12
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
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
py scripts/fetch_indec.py search "pobreza" --limit 10
Serie por ID con transformacion (var YoY)
通过ID获取数据序列并应用转换(同比变动)
py scripts/fetch_indec.py series "145.3_INGNACUAL_DICI_M_38" --mode percent_change_a_year_ago --last 12
---py scripts/fetch_indec.py series "145.3_INGNACUAL_DICI_M_38" --mode percent_change_a_year_ago --last 12
---⚡ Lo unico que hace este skill
⚡ 本Skill的核心功能
Tres killer features de esta API (no disponibles en otros skills del repo):
该API具备仓库中其他Skill没有的三大核心特性:
1. Transformaciones builtin server-side
1. 服务端内置数据转换
Pedir inflacion interanual o acumulada YTD directamente desde el
indice IPC, sin calcular cliente-side:
bash
undefined直接从IPC指数获取年度通胀率或年初至今累计通胀率,无需在客户端计算:
bash
undefinedInflacion interanual ya calculada
已计算好的年度通胀率
py scripts/fetch_indec.py series "<ID_IPC_INDICE>" --mode percent_change_a_year_ago
Modos disponibles: `value`, `change`, `percent_change`,
`percent_change_a_year_ago` (**inflacion YoY**),
`percent_change_since_beginning_of_year` (**inflacion YTD**),
`change_a_year_ago`, `change_since_beginning_of_year`.
Ver [`references/REPRESENTATION_MODES.md`](./references/REPRESENTATION_MODES.md).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`](./references/REPRESENTATION_MODES.md)。2. Agregacion temporal builtin
2. 服务端内置时间聚合
Convertir serie diaria a mensual/anual directamente en el server:
bash
undefined直接在服务端将日度数据转换为月度/年度数据:
bash
undefinedDolar diario → cierre mensual
每日汇率 → 月度平均值
py scripts/fetch_indec.py dolar --collapse month --aggregation end_of_period
Collapses: `day`, `week`, `month`, `quarter`, `semester`, `year`.
Aggregations: `avg`, `sum`, `end_of_period`, `min`, `max`.
Ver [`references/COLLAPSE_AGGREGATIONS.md`](./references/COLLAPSE_AGGREGATIONS.md).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`](./references/COLLAPSE_AGGREGATIONS.md)。3. Multi-serie en una sola request
3. 单次请求获取多序列数据
Combinar IPC + RIPTE + dolar en 1 request:
bash
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在一个请求中整合IPC + RIPTE + 汇率数据:
bash
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 12Estructura del skill
Skill结构
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 CLIskills/indec/
├── SKILL.md # 本文档
├── references/ # 10份详尽文档
│ ├── REFERENCE.md # 总览
│ ├── ENDPOINTS.md # 4个端点深度解析
│ ├── PARAMS.md # 各参数说明
│ ├── REPRESENTATION_MODES.md # 7种转换方式
│ ├── COLLAPSE_AGGREGATIONS.md # 时间聚合说明
│ ├── SERIES_CATALOG.md # 按主题分类的标准ID
│ ├── RESPONSE_FORMAT.md # 完整JSON/CSV格式
│ ├── DATA_SOURCES.md # 数据发布机构
│ ├── COOKBOOK.md # 30+使用示例
│ └── LIMITATIONS_TROUBLESHOOTING.md # 限制与常见问题
├── assets/ # 5个JSON文件
│ ├── known_series_ids.json # 精选数据序列ID目录
│ ├── series_groups.json # 预定义数据组合
│ ├── representation_modes.json # 转换模式示例
│ ├── collapse_aggregations.json # 聚合方式示例
│ └── data_sources.json # 结构化发布机构信息
└── scripts/
└── fetch_indec.py # 包含19种CLI模式的脚本19 modos CLI disponibles
19种可用CLI模式
Consulta directa (4 modos)
直接查询(4种模式)
| Modo | Descripcion |
|---|---|
| Fetch por ID(s) — el modo mas potente |
| Busca series por keywords |
| Valida que un ID sea correcto |
| Catalogo completo (pesado, ~MBs) |
| 模式 | 描述 |
|---|---|
| 通过ID获取数据序列 — 功能最强大的模式 |
| 通过关键词搜索数据序列 |
| 验证ID是否正确 |
| 获取完整目录(体积较大,约数MB) |
Atajos por indicador (9 modos)
指标快捷方式(9种模式)
| Modo | Que devuelve | IDs combinados |
|---|---|---|
| IPC Nacional var mensual | 1 ID |
| IPC + nucleo + regulados + categorias | 5 IDs |
| EMAE original + desestacionalizado | 2 IDs |
| RIPTE + SMVM + haber jubilatorio | 5 IDs |
| Exportaciones totales (M/T/A) | 3 IDs |
| ISAC nivel general | 2 IDs |
| Tipo de cambio BNA diario | 1 ID (BCRA) |
| Reservas internacionales BCRA | 4 IDs (BCRA) |
| Snapshot macro Argentina | 5 IDs combinadas |
| 模式 | 返回内容 | 组合ID |
|---|---|---|
| 全国IPC月度变动 | 1个ID |
| IPC + 核心通胀 + 管制价格 + 分类数据 | 5个ID |
| 原始EMAE数据+经季节调整的数据 | 2个ID |
| RIPTE + SMVM + 养老金收入 | 5个ID |
| 总出口额(月度/季度/年度) | 3个ID |
| ISAC总指数 | 2个ID |
| BRA每日汇率 | 1个ID(BCRA) |
| BCRA国际外汇储备 | 4个ID(BCRA) |
| 阿根廷宏观经济快照 | 5个组合ID |
Catalogos locales (5 modos)
本地目录(5种模式)
| Modo | Que devuelve |
|---|---|
| Catalogo curado de series IDs principales |
| Bundles pre-armados |
| Organismos publicadores |
| Representation modes disponibles |
| Collapse aggregations disponibles |
| 模式 | 返回内容 |
|---|---|
| 精选主要数据序列ID目录 |
| 预定义数据组合 |
| 数据发布机构 |
| 可用的转换模式 |
| 可用的时间聚合方式 |
Combinado (1 modo)
综合模式(1种)
| Modo | Que devuelve |
|---|---|
| Snapshot macro completo: IPC + EMAE + salarios + dolar + reservas + construccion + comercio |
| 模式 | 返回内容 |
|---|---|
| 完整宏观经济快照:IPC + EMAE + 薪资 + 汇率 + 外汇储备 + 建筑业 + 对外贸易 |
Flags principales
主要参数
| Flag | Descripcion |
|---|---|
| Fecha desde |
| Fecha hasta |
| Ultimos N valores (⚠️ incompatible con sort/start/limit) |
| Representation mode (value / percent_change / percent_change_a_year_ago / etc.) |
| Agregacion temporal (day/week/month/quarter/semester/year) |
| Modo de agregacion (avg/sum/end_of_period/min/max) |
| Datapoints por serie (max 1000) |
| Offset para paginacion |
| Orden |
| Verbosidad (none/only/simple/full) |
| json o csv |
| Response sin normalizar |
| Guardar a archivo |
| Silencioso |
| 参数 | 描述 |
|---|---|
| 起始日期 |
| 结束日期 |
| 最近N个数据值(⚠️ 与sort/start/limit不兼容) |
| 转换模式(value / percent_change / percent_change_a_year_ago 等) |
| 时间聚合周期(day/week/month/quarter/semester/year) |
| 聚合方式(avg/sum/end_of_period/min/max) |
| 每个序列的数据点数量(最多1000) |
| 分页偏移量 |
| 排序方式 |
| 元数据详细程度(none/only/simple/full) |
| 输出格式:json或csv |
| 返回未标准化的响应 |
| 保存到文件 |
| 静默模式 |
Diferencial vs bcra-macro
y otros skills
bcra-macro与bcra-macro
及其他Skill的差异
bcra-macro| Feature | | | FRED |
|---|---|---|---|
| Sin auth | ✅ | ✅ | ❌ requiere key |
| Cobertura INDEC completa | ✅ | ❌ | ❌ |
| Cobertura BCRA | ⚠️ subset | ✅ 638 series | ❌ |
| Multi-organismo | ✅ INDEC + BCRA + Min Econ | ❌ solo BCRA | ✅ global |
| Transformaciones builtin (% YoY, YTD) | ✅ UNICO | ❌ | ⚠️ requiere FRED transform |
| Agregacion temporal builtin | ✅ UNICO | ❌ | ⚠️ |
| Multi-serie en 1 request | ✅ UNICO | ❌ | ❌ |
| Documentacion oficial publica | ✅ | ✅ | ✅ |
Cuando usar vs :
indecbcra-macro- INDEC (IPC, EMAE, EPH, PIB) →
indec - Solo BCRA con cobertura completa →
bcra-macro - Cruzar INDEC + BCRA en un dataset →
indec
| 特性 | | | FRED |
|---|---|---|---|
| 无需认证 | ✅ | ✅ | ❌ 需要密钥 |
| 完整覆盖INDEC数据 | ✅ | ❌ | ❌ |
| 覆盖BCRA数据 | ⚠️ 子集 | ✅ 638个序列 | ❌ |
| 多机构数据整合 | ✅ INDEC + BCRA + 经济部 | ❌ 仅BCRA | ✅ 全球数据 |
| 内置转换功能(同比%、年初至今%) | ✅ 独有 | ❌ | ⚠️ 需要FRED转换 |
| 内置时间聚合功能 | ✅ 独有 | ❌ | ⚠️ 有限支持 |
| 单次请求获取多序列数据 | ✅ 独有 | ❌ | ❌ |
| 官方公开文档 | ✅ | ✅ | ✅ |
何时使用 vs :
indecbcra-macro- 需要INDEC数据(IPC、EMAE、EPH、GDP)→ 使用
indec - 仅需完整BCRA数据 → 使用
bcra-macro - 需要整合INDEC + BCRA数据到一个数据集 → 使用
indec
Casos de uso comunes
常见使用场景
30+ recetas completas en.references/COOKBOOK.md
bash
undefined30+完整使用示例见references/COOKBOOK.md
bash
undefinedInflacion mensual ultimos 12 meses
过去12个月的月度通胀率
py scripts/fetch_indec.py ipc --last 12
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
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
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
py scripts/fetch_indec.py series "75.3_IETG_0_M_31" --collapse year --aggregation sum --last 10
Comparar IPC + RIPTE + Dolar (poder adquisitivo)
对比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
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
---py scripts/fetch_indec.py snapshot --last 3
---Documentacion completa
完整文档
| Documento | Contenido |
|---|---|
| Overview general + arquitectura |
| Deep dive de |
| Cada parametro con valores validos, defaults, ejemplos |
| Las 7 transformaciones con ejemplos calculados |
| Agregacion temporal con casos de uso |
| IDs canonicos organizados por topico |
| Schema JSON / CSV completo |
| Organismos publicadores con datasets |
| 30+ recetas listas para copy-paste |
| Limites + errores comunes + debugging |
| Catalogo curado de IDs |
| Bundles pre-armados por caso |
| Modes con descripcion |
| Aggregations con casos |
| Publicadores estructurados |
| 文档 | 内容 |
|---|---|
| 总览 + 架构说明 |
| |
| 各参数的有效值、默认值及示例 |
| 7种转换方式及计算示例 |
| 时间聚合及使用场景 |
| 按主题分类的标准ID |
| 完整JSON/CSV格式 |
| 数据发布机构及数据集 |
| 30+可直接复制使用的示例 |
| 限制 + 常见问题 + 调试指南 |
| 精选数据序列ID目录 |
| 按场景预定义的数据组合 |
| 转换模式及说明 |
| 聚合方式及场景 |
| 结构化发布机构信息 |
⚠️ Limitaciones conocidas
⚠️ 已知限制
Documentacion completa de limitaciones en.references/LIMITATIONS_TROUBLESHOOTING.md
完整限制说明见references/LIMITATIONS_TROUBLESHOOTING.md
Las mas importantes
主要限制
- Maximo 1,000 datapoints por serie por request — para series muy largas, paginar con .
--offset - incompatible con
--last,--sort,--limit— el script lo maneja automaticamente.--offset - Multi-serie con frecuencias mezcladas — usar explicito para evitar surprises.
--collapse - Series DISCONTINUADAS marcadas como en
SERIE DISCONTINUADA— filtrarlas cliente-side.dataset.title - IDs criptos — no intentar adivinar, usar o el catalogo curado.
search - Lag del INDEC: IPC mensual aparece ~15 dias despues, PIB trimestral ~3 meses.
- 单次请求每个序列最多1000个数据点 — 对于超长序列,使用进行分页。
--offset - 与
--last、--sort、--limit不兼容 — 脚本会自动处理该冲突。--offset - 混合频率的多序列请求 — 显式使用避免意外结果。
--collapse - 已停用序列会在中标记为
dataset.title— 需要在客户端过滤。SERIE DISCONTINUADA - ID无规律 — 不要尝试猜测ID,使用或精选目录。
search - INDEC数据延迟:月度IPC数据约15天后发布,季度GDP数据约3个月后发布。
Por que esta API es MAS confiable que las demas
为何该API比其他API更可靠
A diferencia de TradingView/Google Finance/BYMA (todas APIs internas):
- ✅ API oficial publica del Estado Argentino.
- ✅ Documentacion oficial: datosgobar.github.io/series-tiempo-ar-api
- ✅ Codigo abierto en GitHub: datosgobar/series-tiempo-ar-api
- ✅ Politicas de no-break ABI — estable desde 2017+.
- ✅ Issue tracker publico.
Podes construir productos sobre esta API con muchisima mas confianza
que sobre las APIs internas.
与TradingView/Google Finance/BYMA(均为内部API)不同:
- ✅ 阿根廷官方公开API
- ✅ 官方文档:datosgobar.github.io/series-tiempo-ar-api
- ✅ GitHub开源代码:datosgobar/series-tiempo-ar-api
- ✅ 不中断ABI政策 — 自2017年起保持稳定
- ✅ 公开问题追踪
相比内部API,您可以更放心地基于该API构建产品。
Referencias externas
外部参考
- Documentacion oficial: https://datosgobar.github.io/series-tiempo-ar-api/
- Codigo abierto (GitHub): https://github.com/datosgobar/series-tiempo-ar-api
- Portal datos.gob.ar: https://datos.gob.ar
- INDEC oficial: https://www.indec.gob.ar
- BCRA oficial: https://www.bcra.gob.ar
- 官方文档: 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