gauss314 INDEC Argentina — API Oficial de Series de Tiempo
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.
🎯 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 |
🚀 Quick start
# 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
⚡ Lo unico que hace este skill
Tres killer features de esta API (no disponibles en otros skills del repo):
1. Transformaciones builtin server-side
Pedir inflacion interanual o acumulada YTD directamente desde el indice IPC, sin calcular cliente-side:
# 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.
2. Agregacion temporal builtin
Convertir serie diaria a mensual/anual directamente en el server:
# 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.
3. Multi-serie en una sola request
Combinar IPC + RIPTE + dolar en 1 request:
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
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 modos CLI disponibles
Consulta directa (4 modos)
| Modo | Descripcion |
|---|---|
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) |
Atajos por indicador (9 modos)
| Modo | Que devuelve | IDs combinados |
|---|---|---|
ipc |
IPC Nacional var mensual | 1 ID |
ipc-completo |
IPC + nucleo + regulados + categorias | 5 IDs |
emae |
EMAE original + desestacionalizado | 2 IDs |
salarios |
RIPTE + SMVM + haber jubilatorio | 5 IDs |
comercio |
Exportaciones totales (M/T/A) | 3 IDs |
construccion |
ISAC nivel general | 2 IDs |
dolar |
Tipo de cambio BNA diario | 1 ID (BCRA) |
reservas |
Reservas internacionales BCRA | 4 IDs (BCRA) |
snapshot |
Snapshot macro Argentina | 5 IDs combinadas |
Catalogos locales (5 modos)
| Modo | Que devuelve |
|---|---|
catalog |
Catalogo curado de series IDs principales |
groups |
Bundles pre-armados |
sources |
Organismos publicadores |
modes |
Representation modes disponibles |
aggregations |
Collapse aggregations disponibles |
Combinado (1 modo)
| Modo | Que devuelve |
|---|---|
all |
Snapshot macro completo: IPC + EMAE + salarios + dolar + reservas + construccion + comercio |
Flags principales
| Flag | Descripcion |
|---|---|
--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 |
Diferencial vs bcra-macro y otros skills
| 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 builtin | ✅ UNICO | ❌ | ⚠️ |
| Multi-serie en 1 request | ✅ UNICO | ❌ | ❌ |
| 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
Casos de uso comunes
30+ recetas completas en
references/COOKBOOK.md.
# 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
Documentacion completa
| Documento | Contenido |
|---|---|
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 |
⚠️ Limitaciones conocidas
Documentacion completa de limitaciones en
references/LIMITATIONS_TROUBLESHOOTING.md.
Las mas importantes
- Maximo 1,000 datapoints por serie por request — para series muy largas, paginar con
--offset. --lastincompatible con--sort,--limit,--offset— el script lo maneja automaticamente.- Multi-serie con frecuencias mezcladas — usar
--collapseexplicito para evitar surprises. - Series DISCONTINUADAS marcadas como
SERIE DISCONTINUADAendataset.title— filtrarlas cliente-side. - IDs criptos — no intentar adivinar, usar
searcho el catalogo curado. - Lag del INDEC: IPC mensual aparece ~15 dias despues, PIB trimestral ~3 meses.
Por que esta API es MAS confiable que las demas
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.
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