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
bash# 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:
bash# 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:
bash# 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:
bashpy 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.
bash# 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
