indec

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

INDEC 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:
apis.datos.gob.ar/series
— sin API key, sin autenticacion, con documentacion oficial y politicas de no-break ABI.
A 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提取阿根廷宏观经济与社会数据:
apis.datos.gob.ar/series
— 无需API密钥、无需认证,具备官方文档与不中断ABI政策。
与基于内部API(TradingView、Google Finance)的Skill不同,这是由阿根廷国家公共数据与信息局维护的官方公开API,是整个仓库中最稳定、最可靠的API

🎯 Que datos cubre

🎯 涵盖的数据

~4,250 series totales del catalogo oficial, agregando datos de multiples organismos publicos argentinos:
OrganismoTipo de datos
INDECIPC nacional, IPC GBA, EMAE, IPI, ISAC, EPH (empleo/desempleo), pobreza, censos, comercio exterior, PIB
BCRATipo de cambio, reservas, REM expectativas, balance cambiario, tasas
Min EconomiaPIB 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
undefined
bash
undefined

Snapshot 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
undefined

Inflacion 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
undefined

Dolar 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 12

Estructura 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 CLI

skills/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种模式)

ModoDescripcion
series IDS
Fetch por ID(s) — el modo mas potente
search QUERY
Busca series por keywords
validate IDS
Valida que un ID sea correcto
dump
Catalogo completo (pesado, ~MBs)
模式描述
series IDS
通过ID获取数据序列 — 功能最强大的模式
search QUERY
通过关键词搜索数据序列
validate IDS
验证ID是否正确
dump
获取完整目录(体积较大,约数MB)

Atajos por indicador (9 modos)

指标快捷方式(9种模式)

ModoQue devuelveIDs combinados
ipc
IPC Nacional var mensual1 ID
ipc-completo
IPC + nucleo + regulados + categorias5 IDs
emae
EMAE original + desestacionalizado2 IDs
salarios
RIPTE + SMVM + haber jubilatorio5 IDs
comercio
Exportaciones totales (M/T/A)3 IDs
construccion
ISAC nivel general2 IDs
dolar
Tipo de cambio BNA diario1 ID (BCRA)
reservas
Reservas internacionales BCRA4 IDs (BCRA)
snapshot
Snapshot macro Argentina5 IDs combinadas
模式返回内容组合ID
ipc
全国IPC月度变动1个ID
ipc-completo
IPC + 核心通胀 + 管制价格 + 分类数据5个ID
emae
原始EMAE数据+经季节调整的数据2个ID
salarios
RIPTE + SMVM + 养老金收入5个ID
comercio
总出口额(月度/季度/年度)3个ID
construccion
ISAC总指数2个ID
dolar
BRA每日汇率1个ID(BCRA)
reservas
BCRA国际外汇储备4个ID(BCRA)
snapshot
阿根廷宏观经济快照5个组合ID

Catalogos locales (5 modos)

本地目录(5种模式)

ModoQue devuelve
catalog
Catalogo curado de series IDs principales
groups
Bundles pre-armados
sources
Organismos publicadores
modes
Representation modes disponibles
aggregations
Collapse aggregations disponibles
模式返回内容
catalog
精选主要数据序列ID目录
groups
预定义数据组合
sources
数据发布机构
modes
可用的转换模式
aggregations
可用的时间聚合方式

Combinado (1 modo)

综合模式(1种)

ModoQue devuelve
all
Snapshot macro completo: IPC + EMAE + salarios + dolar + reservas + construccion + comercio

模式返回内容
all
完整宏观经济快照:IPC + EMAE + 薪资 + 汇率 + 外汇储备 + 建筑业 + 对外贸易

Flags principales

主要参数

FlagDescripcion
--start YYYY-MM-DD
Fecha desde
--end YYYY-MM-DD
Fecha hasta
--last N
Ultimos N valores (⚠️ incompatible con sort/start/limit)
--mode X
Representation mode (value / percent_change / percent_change_a_year_ago / etc.)
--collapse X
Agregacion temporal (day/week/month/quarter/semester/year)
--aggregation X
Modo de agregacion (avg/sum/end_of_period/min/max)
--limit N
Datapoints por serie (max 1000)
--offset N
Offset para paginacion
--sort asc/desc
Orden
--metadata X
Verbosidad (none/only/simple/full)
--format X
json o csv
--raw
Response sin normalizar
-o file
Guardar a archivo
-q
Silencioso

参数描述
--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
静默模式

Diferencial vs
bcra-macro
y otros skills

bcra-macro
及其他Skill的差异

Feature
indec
bcra-macro
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 builtinUNICO⚠️
Multi-serie en 1 requestUNICO
Documentacion oficial publica
Cuando usar
indec
vs
bcra-macro
:
  • INDEC (IPC, EMAE, EPH, PIB) →
    indec
  • Solo BCRA con cobertura completa →
    bcra-macro
  • Cruzar INDEC + BCRA en un dataset →
    indec

特性
indec
bcra-macro
FRED
无需认证❌ 需要密钥
完整覆盖INDEC数据
覆盖BCRA数据⚠️ 子集✅ 638个序列
多机构数据整合✅ INDEC + BCRA + 经济部❌ 仅BCRA✅ 全球数据
内置转换功能(同比%、年初至今%)独有⚠️ 需要FRED转换
内置时间聚合功能独有⚠️ 有限支持
单次请求获取多序列数据独有
官方公开文档
何时使用
indec
vs
bcra-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
undefined
30+完整使用示例见
references/COOKBOOK.md
bash
undefined

Inflacion 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

完整文档

DocumentoContenido
references/REFERENCE.md
Overview general + arquitectura
references/ENDPOINTS.md
Deep dive de
/series
,
/search
,
/dump
,
/validate
references/PARAMS.md
Cada parametro con valores validos, defaults, ejemplos
references/REPRESENTATION_MODES.md
Las 7 transformaciones con ejemplos calculados
references/COLLAPSE_AGGREGATIONS.md
Agregacion temporal con casos de uso
references/SERIES_CATALOG.md
IDs canonicos organizados por topico
references/RESPONSE_FORMAT.md
Schema JSON / CSV completo
references/DATA_SOURCES.md
Organismos publicadores con datasets
references/COOKBOOK.md
30+ recetas listas para copy-paste
references/LIMITATIONS_TROUBLESHOOTING.md
Limites + errores comunes + debugging
assets/known_series_ids.json
Catalogo curado de IDs
assets/series_groups.json
Bundles pre-armados por caso
assets/representation_modes.json
Modes con descripcion
assets/collapse_aggregations.json
Aggregations con casos
assets/data_sources.json
Publicadores estructurados

文档内容
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
结构化发布机构信息

⚠️ Limitaciones conocidas

⚠️ 已知限制

Documentacion completa de limitaciones en
references/LIMITATIONS_TROUBLESHOOTING.md
.
完整限制说明见
references/LIMITATIONS_TROUBLESHOOTING.md

Las mas importantes

主要限制

  1. Maximo 1,000 datapoints por serie por request — para series muy largas, paginar con
    --offset
    .
  2. --last
    incompatible con
    --sort
    ,
    --limit
    ,
    --offset
    — el script lo maneja automaticamente.
  3. Multi-serie con frecuencias mezcladas — usar
    --collapse
    explicito para evitar surprises.
  4. Series DISCONTINUADAS marcadas como
    SERIE DISCONTINUADA
    en
    dataset.title
    — filtrarlas cliente-side.
  5. IDs criptos — no intentar adivinar, usar
    search
    o el catalogo curado.
  6. Lag del INDEC: IPC mensual aparece ~15 dias despues, PIB trimestral ~3 meses.
  1. 单次请求每个序列最多1000个数据点 — 对于超长序列,使用
    --offset
    进行分页。
  2. --last
    --sort
    --limit
    --offset
    不兼容
    — 脚本会自动处理该冲突。
  3. 混合频率的多序列请求 — 显式使用
    --collapse
    避免意外结果。
  4. 已停用序列会在
    dataset.title
    中标记为
    SERIE DISCONTINUADA
    — 需要在客户端过滤。
  5. ID无规律 — 不要尝试猜测ID,使用
    search
    或精选目录。
  6. 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):
Podes construir productos sobre esta API con muchisima mas confianza que sobre las APIs internas.

与TradingView/Google Finance/BYMA(均为内部API)不同:
相比内部API,您可以更放心地基于该API构建产品。

Referencias externas

外部参考