Columna

Tipo

Descripción

Unidad

emisor_cedear

String

Emisor del CEDEAR: 'comafi' o 'caja_valores'. Atribución cross-source.

—

simbolo_byma

String

Ticker BYMA del CEDEAR. Acepta espacios y '/' (Bloomberg-format).

—

nombre_programa

String

Nombre legal del programa CEDEAR (puede diferir entre emisores para el mismo subyacente).

—

ticker_origen

String

Ticker en el mercado de origen (derivado cross-source). Null cuando no se puede inferir.

—

codigo_caja

Int64

Código interno del emisor (Comafi o Caja Valores).

—

isin_cedear

String

ISIN del CEDEAR argentino (12 chars, prefijo AR).

—

isin_subyacente

String

ISIN del subyacente extranjero (12 chars).

—

cusip_subyacente

String

CUSIP del subyacente USA (9 chars).

—

ratio

String

Ratio crudo como texto preservado del source ('20:1', 'Variable').

—

ratio_cedear

Float64

Numerador parseado del ratio (CEDEARs).

—

ratio_subyacente

Float64

Denominador parseado del ratio (subyacentes).

—

monto_maximo

Int64

Monto máximo emitido del programa.

—

mercado_origen

String

Bolsa de origen del subyacente.

—

pais_origen

String

País del subyacente (texto humano).

—

industria

String

Industria del subyacente (cuando disponible — Comafi sí, Caja Valores no).

—

industria_descripcion

String

Descripción extendida de la industria.

—

frecuencia_pago

String

Frecuencia de pago de dividendos (cuando disponible).

—

valor_subyacente

String

Valor del subyacente reportado (texto crudo).

—

mercado_elegible

String

Mercados argentinos donde el CEDEAR es elegible.

—

alcance_inversor

String

Restricción regulatoria CNV (calificado / no calificado / ambos).

—

categoria

String

Categoría del instrumento: 'accion' o 'etf'. Derivado cross-source.

—

is_active

Boolean

TRUE si el CEDEAR estaba vigente en el snapshot_date. FALSE para CEDEARs vistos antes pero no en el snapshot actual.

—

first_seen

Date

Fecha del primer snapshot donde apareció el CEDEAR (tracking SCD2 cross-emisor).

ISO 8601 YYYY-MM-DD

last_seen

Date

Fecha del último snapshot donde apareció el CEDEAR.

ISO 8601 YYYY-MM-DD

has_sec_filings

Boolean

TRUE si el subyacente tiene balance SEC consultable (cross-product con sec.empresas.registro).

—

sec_cik

String

CIK 10-digit zero-padded del subyacente. NULL si has_sec_filings=FALSE.

—

snapshot_date

Date

Fecha del snapshot del gold (operacional cross-dataset).

ISO 8601 YYYY-MM-DD

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

0% overlap entre Comafi y Caja de Valores — invariante crítico

Por construcción regulatoria, un CEDEAR sólo puede tener un emisor activo a la vez. El scraper valida la intersección de simbolo_byma y de isin_cedear entre las dos listas y falla con error si encuentra overlap, antes de publicar snapshot. Cualquier futuro break de este invariante señaliza cambio regulatorio o bug en la fuente — no enmascararlo.

Tickers Bloomberg-style con espacios o slash son legítimos

Tickers como BAS GR (BASF, XETRA), BRK/B (Berkshire Hathaway Class B) usan espacio o "/" como parte del símbolo. El regex de simbolo_byma acepta ^[A-Z0-9._\- /]{1,12}$ explícitamente para preservar el formato Bloomberg/NYSE original. NO trimear ni normalizar estos caracteres en queries downstream — se rompe el match con la fuente.

isin_subyacente puede ser NULL; el CUSIP va a cusip_subyacente

Comafi publica CUSIP (9 caracteres alfanuméricos) para subyacentes USA en lugar de ISIN. El scraper preserva esa distinción: si la fuente da CUSIP, va a cusip_subyacente y isin_subyacente queda NULL. Para reconstruir el ISIN desde CUSIP USA, prependar US + agregar check digit ISO 6166 — no es trivial, no lo hacemos automáticamente. Cualquier código que joinee por ISIN del subyacente debe contemplar el NULL.

Brasil B3 stocks (VALE3, PETR3, ITUB3) están en Caja de Valores, no en Comafi

Contra-intuitivamente, los CEDEARs de stocks brasileros listados en B3 (VALE3, PETR3, ITUB3, BBDC3, MGLU3, etc.) viven en Caja de Valores, no en Comafi. Comafi tiene 20 CEDEARs brasileros, pero son los ADRs cotizando en NYSE (VALE, PBR, ITUB, etc.). Filtrar por pais_origen = 'Brasil' en Comafi devuelve los ADRs; los B3 directos requieren emisor_cedear = 'caja_valores'. Documentar el caso en cualquier cliente que pida "todos los CEDEARs brasileros".

ETFs típicamente sólo tienen isin_cedear; no isin_subyacente

Los ETFs (categoria='etf') frecuentemente no exponen el ISIN del activo subyacente porque el subyacente es una canasta, no un único instrumento. Aparecen 24 ETFs en Caja de Valores (SPY, QQQ, IWM, EEM, DIA, etc.) y ~30 ETFs adicionales en Comafi (industria='ETF'). Filtros por isin_subyacente IS NOT NULL excluyen ETFs silenciosamente — hacer explícito el filtro categoria = 'accion' si esa es la intención.

Caja de Valores no expone industria ni país de origen

industria, industria_descripcion, pais_origen, frecuencia_pago, cusip_subyacente están NULL para todas las filas de emisor_cedear='caja_valores'. Agregaciones por industria/país solo reflejan el universo Comafi (342 instrumentos), no el total (401). Para análisis cross-fuente completos, enriquecer manualmente desde otros catálogos (ej. Refinitiv RIC, Bloomberg BBG) o aceptar la cobertura parcial.

ratio_cedear / ratio_subyacente pueden ser NULL si el parseo falla

El campo ratio (String) preserva el formato crudo "X:Y" de la fuente. ratio_cedear/ratio_subyacente son el parseo numérico — cuando la fuente publica ratios atípicos ("Variable", "—", o formatos no estándar), el parseo deja NULL y se preserva el string original en ratio. Cualquier cálculo de pricing dual debe contemplar NULL.

Snapshot weekly, no daily — no usar para precio intradiario

Este dataset describe el universo de CEDEARs vigentes; NO contiene precios ni volúmenes. Para datos de mercado secundario (precios, volúmenes, spreads BYMA) hace falta otro dataset distinto. El refresh semanal es porque el padrón cambia raramente — altas/bajas de programas suceden trimestralmente como mucho.

first_seen / last_seen tracking requiere histórico de snapshots

Las columnas first_seen y last_seen se calculan diff-eando el snapshot actual contra snapshots previos almacenados. En el primer scrape (fresh start) ambas son iguales a snapshot_date. Para reconstruir altas/bajas históricas hace falta scan de todos los snapshots — un dataset gold derivado puede hacerlo más eficiente en el futuro.

Padrón unificado de CEDEARs vigentes

Qué incluye