Columna

Tipo

Descripción

Unidad

id_variable

Int32

Identificador estable de la variable BCRA. Filtrar siempre por este, no por descripcion (que cambia).

—

fecha

Date

Fecha de la observación. UVA y CER pueden tener fechas futuras (~30 días) porque son referencia contractual.

ISO 8601 YYYY-MM-DD

valor

Float64

Valor publicado por BCRA. Leer columna 'unidad' antes de operar matemáticamente entre variables distintas.

—

descripcion

String

Nombre humano de la variable. Sujeto a cambios editoriales del BCRA, NO usar para filtros.

—

categoria

String

Agrupación de alto nivel: Principales Variables / Depósitos / Préstamos / etc.

—

tipo_serie

String

Tipo metodológico (Saldos, Flujo, Tasa, Indice, Promedio diario, etc.)

—

periodicidad

String

Frecuencia nativa de la variable. Valores presentes en el dataset: D (diaria) y M (mensual). No existen códigos de otra periodicidad en la carga actual.

—

unidad

String

Unidad de medida en texto libre BCRA. Ej: 'En millones de USD', 'Pesos por dólar', 'Porcentaje nominal anual'.

—

moneda

String

Código de moneda BCRA. Valores reales: ML (moneda local / pesos), ME (moneda extranjera), MEyML (ambas), USD. La mayoría de las filas (~66%) son ML. No confundir con los códigos ISO 4217: ML y ME son códigos internos del BCRA.

—

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 TC mayorista de referencia (id 5) NO son intercambiables

id 5 (descripcion: 'Tipo de cambio mayorista de referencia', conocido informalmente como 'A 3500') es la referencia regulatoria oficial. id 4 (descripcion: 'Tipo de cambio minorista (promedio vendedor)') es indicativo del mercado físico. Diferencia histórica del 1-3%. Nota: id 5 tiene historia desde 2002-03-04; id 4 solo desde 2010-06-01.

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.

Códigos de moneda son internos del BCRA, no ISO 4217

La columna moneda usa los códigos del BCRA: ML (moneda local = pesos argentinos), ME (moneda extranjera), MEyML (ambas), USD. No son códigos ISO 4217 (ARS/USD). La mayoría de las variables son ML (~66% de las filas). El valor ARS no existe en esta columna; para pesos, filtrá por el código ML.

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.

BCRA — Indicadores monetarios

Qué incluye