BCRA

BCRA — Indicadores monetarios (catálogo completo + histórico)

Las 1.220 variables monetarias del BCRA con su histórico completo.

Monetario y cambiarioAgregados y reservas

Qué incluye

  • 9 columnas documentadas
  • Formato Parquet y CSV
  • Cobertura 1991+ (varía por variable)
  • Actualización diaria
  • Acceso por descarga, API y MCP
  • Schema versionado y trazable a la fuente
Casos de uso
  • ¿Cómo evolucionó el IPC argentino mensual desde 1943? (Variables 27 y 28: variación mensual e interanual del IPC con 83+ años de historia continua, profundidad única en el mercado.)
  • ¿Cuál es el nivel actual de reservas internacionales del BCRA y cómo evolucionó en los últimos doce meses?
  • ¿Qué tasa BADLAR (Bancos Privados) se publicó en una fecha específica?
  • ¿Cuál es el spread entre el tipo de cambio mayorista (A 3500) y el minorista promedio vendedor en la fecha más reciente?
  • ¿Cómo evolucionó la base monetaria mes a mes en el último año?
  • ¿Cuál es el valor publicado de UVA y CER para los próximos 30 días? (BCRA los publica con anticipación porque son referencia contractual.)
  • ¿Cuándo cruzó la tasa de política monetaria un umbral X y cómo reaccionaron los agregados monetarios?
Columnas9
ColumnaTipoDescripciónUnidad
id_variableInt32Identificador estable de la variable BCRA. Filtrar siempre por este, no por descripcion (que cambia).
fechaDateFecha de la observación. UVA y CER pueden tener fechas futuras (~30 días) porque son referencia contractual.ISO 8601 YYYY-MM-DD
valorFloat64Valor publicado por BCRA. Leer columna 'unidad' antes de operar matemáticamente entre variables distintas.
descripcionStringNombre humano de la variable. Sujeto a cambios editoriales del BCRA, NO usar para filtros.
categoriaStringAgrupación de alto nivel: Principales Variables / Depósitos / Préstamos / etc.
tipo_serieStringTipo metodológico (Saldos, Flujo, Tasa, Indice, Promedio diario, etc.)
periodicidadStringFrecuencia nativa de la variable (D = diaria, M = mensual, etc.).
unidadStringUnidad de medida en texto libre BCRA. Ej: 'En millones de USD', 'Pesos por dólar', 'Porcentaje nominal anual'.
monedaStringMoneda de la variable cuando aplica. ARS o USD.
Limitaciones conocidas

Pueden invalidar un análisis ingenuo. Documentadas como parte del control de calidad.

id_variable es estable; descripcion y categoria pueden cambiar

El BCRA reformula nombres y reorganiza categorías sin previo aviso. Toda consulta repetible debe filtrar por id_variable. Usar las columnas de texto solo para display humano o exploración inicial.

TC minorista (id 4) y mayorista A 3500 (id 5) NO son intercambiables

A 3500 es la referencia regulatoria oficial (la usamos nosotros para pricing dual ARS/USD, por ejemplo). Minorista promedio vendedor es indicativo del mercado físico. Diferencia histórica del 1-3%.

Variables con fechas futuras: UVA y CER

Las series UVA (Unidad de Valor Adquisitivo) y CER se publican con ~30 días de anticipación porque son referencia contractual de préstamos hipotecarios y depósitos ajustables — el valor para esas fechas futuras es contractualmente conocido, no es forecast. Por ese motivo el dataset puede tener filas con fecha > hoy sin que sea bug. Si querés filtrar solo observaciones realizadas: WHERE fecha <= CURRENT_DATE.

Ingesta diaria solo captura el último datapoint por variable

Después del backfill inicial, el scraper diario trae solo el snapshot del catálogo (último valor por variable). Si BCRA publica varios datapoints atrasados de una misma variable en un solo día (raro, pasa con backfills del propio BCRA), capturamos solo el más reciente. Para reconstruir, disparar --backfill manual.

Revisiones a datos viejos no se capturan automáticamente

Si BCRA revisa el valor de una variable para una fecha más vieja que ultFechaInformada actual, el scraper diario NO se entera. Se entera solo si la revisión cambia el último valor. Mitigación: re-disparar --backfill cada N meses (trimestral recomendado) para reconciliar.

Granularidad mixta de periodicidad

El dataset combina variables daily, monthly, quarterly. Antes de hacer promedios o sumas cross-variable, filtrar por periodicidad para evitar mezclar peras y manzanas.

Schema versioning embebido en path

Los snapshots v1 viven en silver/.../v1/snapshots/. Cuando lancemos v2 con cambios breaking de schema, los nuevos snapshots se publican bajo silver/.../v2/snapshots/ en paralelo durante 90 días para dar ventana de migración. Filtrar schema_version en la query si el cliente necesita una versión específica.

BCRA puede deprecar la versión de la API

v3.0 fue deprecada durante 2026 con mensaje 400 explícito en el primer request. Si el scraper falla con HTTPStatusError 400, leer el errorMessages de la respuesta — BCRA indica la versión activa. Bumpear CATALOG_URL y PER_VARIABLE_URL en el código y subir version del scraper.