BYMA — Bolsas y Mercados Argentinos

Skill para extraer datos de mercado de BYMA via su API publica de market data (open.bymadata.com.ar) — sin API key, sin autenticacion.

BYMA es la bolsa principal de Argentina (sucesora del Merval) donde se negocian:

Acciones lideres (panel de 20 simbolos del MERVAL).
CEDEARs (~1143 unicos x 2 settlements).
Bonos publicos soberanos + LECAPs + BONCAPs (~104 unicos x 6 variantes).
Obligaciones Negociables (ON) corporativas (~2117 items).
SENEBI ON (segmento bilateral, ~3160 items).
Cauciones (133 items, formato DOLAR-DDMM-U-CT-USD).
Opciones (~429 items con strike, OI, vencimiento).
Indices: S&P MERVAL (M), BURCAP (G).
Historicos OHLCV diarios/semanales/mensuales para todos los instrumentos.
Ficha tecnica de bonos (forma de amortizacion, intereses step-up, ISIN, ley aplicable, emisor).

⚠️ Aviso Legal

API publica de BYMA, sin documentacion oficial. Los endpoints pueden cambiar sin aviso.
Respetar terminos de uso de BYMA. No hacer mas de 1 req/segundo.
Los datos son delayed (~15 min tipico de mercado argentino).
Para uso comercial intensivo, contactar BYMA para licencias oficiales.

🔒 Nota sobre certificado SSL

BYMA presenta un certificado SSL cuya CA intermedia no esta incluida en el bundle certifi estandar de Python. Esto causa:

SSLError: CERTIFICATE_VERIFY_FAILED

El script usa verify=False — la conexion sigue siendo TLS-encriptada pero se omite la validacion de cadena. Es el patron estandar de las librerias publicas de BYMA (pyhomebroker, bymadata, etc.).

Si preferis no usar verify=False, podes instalar el cert intermedio de BYMA en tu trust store del sistema.

Scripts

Script	Descripcion
[fetchbyma.py](./scripts/fetchbyma.py)	Script principal: todos los endpoints disponibles

Uso rapido

# ── PANELES (POST) ────────────────────────────────────────────────────

# Panel lideres: 20 acciones MERVAL x 2 settlements (40 items)
py scripts/fetch_byma.py panel leading-equity
py scripts/fetch_byma.py panel leading-equity --t0    # solo CI (T+0)
py scripts/fetch_byma.py panel leading-equity --t1    # solo 24hs (T+1)

# Panel CEDEARs (~2000 items, lista directa)
py scripts/fetch_byma.py panel cedears

# Panel bonos publicos (1018 items, paginado a 189 por defecto)
py scripts/fetch_byma.py panel public-bonds
py scripts/fetch_byma.py panel public-bonds --all     # trae los 1018 en una llamada

# Panel ON corporativas (~2117 items, lista directa)
py scripts/fetch_byma.py panel on

# Panel cauciones (~133 items)
py scripts/fetch_byma.py panel cauciones

# Panel SENEBI ON (3160 items, paginado)
py scripts/fetch_byma.py panel senebi-on
py scripts/fetch_byma.py panel senebi-on --all        # trae los 3160 en una llamada

# Panel opciones (~429 items, con strike, OI, vencimiento)
py scripts/fetch_byma.py panel options

# ── HISTORICOS OHLCV (GET) ────────────────────────────────────────────

# Historico de un instrumento — formato simbolo: "TICKER 24HS"
py scripts/fetch_byma.py historico "GGAL 24HS"
py scripts/fetch_byma.py historico "ALUA 24HS"
py scripts/fetch_byma.py historico "AAPL 24HS"        # CEDEAR ARS
py scripts/fetch_byma.py historico "AAPLD 24HS"       # CEDEAR USD
py scripts/fetch_byma.py historico "AL30 24HS"        # Bono ARS
py scripts/fetch_byma.py historico "AL30D 24HS"       # Bono USD
py scripts/fetch_byma.py historico "AL30C 24HS"       # Bono CCL
py scripts/fetch_byma.py historico "GD30 24HS"
py scripts/fetch_byma.py historico "TZX26 24HS"       # BONCAP
py scripts/fetch_byma.py historico "TY30P 24HS"       # BONCAP

# Con rango de fechas (default: ultimos 30 dias)
py scripts/fetch_byma.py historico "GGAL 24HS" --desde 2024-05-15 --hasta 2026-06-05

# Resolutions: D (diario), W (semanal), M (mensual)
py scripts/fetch_byma.py historico "GGAL 24HS" --resolution W
py scripts/fetch_byma.py historico "GGAL 24HS" --resolution M

# ── INDICES ────────────────────────────────────────────────────────────

# Historico del S&P MERVAL
py scripts/fetch_byma.py indice M
py scripts/fetch_byma.py indice M --desde 2025-01-01 --hasta 2026-06-05

# Historico del BURCAP
py scripts/fetch_byma.py indice G

# ── FICHA TECNICA DE BONOS ─────────────────────────────────────────────

# Ficha tecnica completa: forma de amortizacion, intereses, ISIN, ley, emisor
py scripts/fetch_byma.py bond-info AE38            # Bono soberano USD 2038 step-up
py scripts/fetch_byma.py bond-info AL30            # Bono soberano USD 2030 ley local
py scripts/fetch_byma.py bond-info GD30            # Bono soberano USD 2030 ley NY
py scripts/fetch_byma.py bond-info AE38C           # Variante CCL (misma ficha)
py scripts/fetch_byma.py bond-info AE38D           # Variante USD MEP (misma ficha)
py scripts/fetch_byma.py bond-info BPOA7           # BOPREAL Serie 1 A
py scripts/fetch_byma.py bond-info TY30P           # BONCAP
py scripts/fetch_byma.py bond-info TZX26           # BONCAP CER
py scripts/fetch_byma.py bond-info S237Q           # LECAP
py scripts/fetch_byma.py bond-info SBC1C           # ON corporativa

# ── COMBINADO ──────────────────────────────────────────────────────────

# Snapshot de todos los paneles + MERVAL + BURCAP
py scripts/fetch_byma.py all

# ── OUTPUT ─────────────────────────────────────────────────────────────

# Guardar a archivo JSON
py scripts/fetch_byma.py panel leading-equity -o leading.json
py scripts/fetch_byma.py all -o snapshot_byma.json

# Modo silencioso (solo JSON, sin logs)
py scripts/fetch_byma.py panel cauciones -q

Endpoints disponibles

Modo	Data	Endpoint
`panel leading-equity`	Top 20 acciones MERVAL x 2 settlements (40 items)	`POST /leading-equity`
`panel cedears`	CEDEARs (~2000 items)	`POST /cedears`
`panel public-bonds`	Bonos soberanos + LECAPs/BONCAPs (~1018 items)	`POST /public-bonds`
`panel on`	ONs corporativas (~2117 items)	`POST /negociable-obligations`
`panel cauciones`	Cauciones (~133 items)	`POST /cauciones`
`panel senebi-on`	SENEBI ONs (~3160 items, paginado)	`POST /senebi-obligaciones-negociables`
`panel options`	Opciones (~429 items)	`POST /options`
`historico <SYM>`	OHLCV diario/semanal/mensual de un instrumento	`GET /chart/historical-series/history?symbol={...}`
`indice <COD>`	OHLCV de un indice (M=MERVAL, G=BURCAP)	`GET /chart/index-historical-series/history?symbol={...}`
`bond-info <TICKER>`	Ficha tecnica de bono/LECAP/BONCAP/ON (amortizacion, intereses, ISIN, emisor)	`POST /bnown/fichatecnica/especies/general`
`all`	Snapshot de todos los paneles + indices	(combinado)

Total: 10 endpoints publicos verificados ✅ (8 POST + 2 historicos GET).

Base URL

https://open.bymadata.com.ar/vanoms-be-core/rest/api/bymadata/free

Convenciones de simbolos

Historicos: formato `TICKER 24HS`

⚠️ TODOS los historicos requieren el sufijo 24HS (con espacio). Sin sufijo retorna HTTP 400. El sufijo CI tambien retorna 400 (no soportado). 48HS retorna 200 con 0 puntos.

Tipo	Ejemplo
Accion	`GGAL 24HS`, `ALUA 24HS`, `YPFD 24HS`
CEDEAR ARS	`AAPL 24HS`, `MSFT 24HS`
CEDEAR USD	`AAPLD 24HS`, `MSFTD 24HS`
Bono soberano ARS	`AL30 24HS`, `GD30 24HS`, `AE38 24HS`
Bono soberano USD MEP	`AL30D 24HS`, `GD30D 24HS`
Bono soberano CCL	`AL30C 24HS`, `GD30C 24HS`
LECAP/BONCAP	`TY30P 24HS`, `TZX26 24HS`

Bonos: convencion de sufijos por moneda

Sufijo	Variante	Ejemplo
(sin)	ARS — paridad en pesos	`AL30`
`C`	CCL (Contado con Liquidacion / EXT)	`AL30C`
`D`	USD MEP	`AL30D`
`X`, `Y`, `Z`	otras variantes (intra-day, settlement alt.)	`AL30X`

Indices conocidos

Codigo	Indice
`M`	S&P MERVAL
`G`	BURCAP

Otros codigos (A, B, V, etc.) son aceptados pero retornan series con todos ceros — probablemente indices deprecated.

Filtros comunes en POST paneles

Filtro	Descripcion
`T0=true`	Solo `settlementType=1` (CI / Contado Inmediato)
`T1=true`	Solo `settlementType=2` (24hs)
`T2=true`	Solo `settlementType=3` (48hs — practicamente vacio)
`page_size=5000`	Trae todo el dataset en una sola llamada (recomendado para `public-bonds` y `senebi-on`)

⚠️ El parametro page (numero de pagina) es ignorado por la API — siempre devuelve pagina 1. Workaround: usar page_size grande o flag --all.

Consideraciones tecnicas

Datos devueltos por `panel` (todos)

Cada item incluye:

Campo	Tipo	Descripcion
`symbol`	string	Ticker BYMA.
`settlementType`	string	`"1"` (CI) o `"2"` (24hs).
`securityType`	string	`CS` (Common Stock), `CD` (CEDEAR), `GO` (Government Obligation), `CORP` (ON), `QS` (Caucion), `OPT` (Option).
`denominationCcy`	string	`ARS`, `USD`, `EXT`.
`market`	string	`BYMA` o `SENEBI`.
`trade`	float	Ultimo precio operado.
`closingPrice`	float	Cierre del dia.
`settlementPrice`	float	Precio de settlement.
`openingPrice`, `tradingHighPrice`, `tradingLowPrice`	float	OHL del dia.
`previousClosingPrice`, `previousSettlementPrice`	float	Cierre / settlement anterior.
`imbalance`	float	Variacion % vs anterior (decimal: -0.0098 = -0.98%).
`volume`, `tradeVolume`	float	Volumen nominal.
`volumeAmount`	float	Monto efectivo en moneda.
`vwap`	float	Volume-Weighted Average Price.
`bidPrice`, `offerPrice`	float	Mejor bid/offer (0 fuera de horario).
`quantityBid`, `quantityOffer`	float	Cantidades de bid/offer.
`numberOfOrders`	int	Numero total de ordenes del dia.
`openInterest`	float	Interes abierto (real en opciones/cauciones; 0 en acciones).
`tickDirection`	int	-1 / 0 / +1 (downtick / unchanged / uptick).
`tradeHour`	string	Hora del ultimo trade.

Campos extra en bonos / ONs / cauciones / opciones

Campo	Descripcion
`maturityDate`	Fecha de vencimiento (ISO `YYYY-MM-DD`).
`daysToMaturity`	Dias hasta vencimiento.
`underlyingSymbol`	Underlying (solo cauciones y opciones).
`optionType`	`CALL` o `PUT` (solo opciones).

Datos devueltos por `historico` e `indice`

{
  "s": "ok",
  "t": [unix_seconds, ...],
  "o": [opens, ...],
  "h": [highs, ...],
  "l": [lows, ...],
  "c": [closes, ...],
  "v": [volumes, ...]
}

Campo	Descripcion
`s`	Status: `"ok"`, `"no_data"`, `"error"`.
`t[]`	Timestamps unix UTC SECONDS (no millis).
`o[]`, `h[]`, `l[]`, `c[]`	OHLC alineados por indice.
`v[]`	Volumen (suele ser 0 en indices).

Datos devueltos por `bond-info`

Devuelve {content, data, empty, upgrade} donde data[0] (cuando existe) contiene la ficha tecnica del bono. Para acciones, opciones y tickers inexistentes: data: [] y empty: true.

Campos del data[0]:

Campo	Tipo	Descripcion
`ley`	string	Jurisdiccion aplicable: `Nacional`, `Extranjera`, `Nueva York`, `Inglaterra`. Critico para distinguir AL30 (ley local) de GD30 (ley NY).
`formaAmortizacion`	string	TEXTO PLANO con el cronograma de amortizacion (numero de cuotas, periodicidad, fechas, %). Para bullet: `"Al vencimiento"`.
`interes`	string	TEXTO PLANO con esquema de devengo de intereses. Para step-up describe cada tramo de tasa. Para CER describe el ajuste por inflacion.
`denominacionMinima`	int	Denominacion minima de emision.
`fechaEmision`	string	`YYYY-MM-DD HH:MM:SS.f`.
`fechaVencimiento`	string	`YYYY-MM-DD HH:MM:SS.f`.
`fechaDevenganIntereses`	string	Fecha inicio devengo (suele estar vacia).
`codigoIsin`	string	ISIN del instrumento.
`tipoEspecie`	string	`Titulos Publicos`, `Obligaciones Negociables`, `Letras del Tesoro`.
`tipoObligacion`	string	Clasificacion regulatoria: `Valores Publicos Nacionales`, `Provinciales`, `Corporativos`.
`tipoGarantia`	string	`Comun`, etc.
`default`	string	Estado de default (vacio si esta al dia).
`montoNominal`	int	Monto nominal total emitido.
`montoResidual`	int	Monto residual actual (post-amortizaciones).
`denominacion`	string	Nombre oficial completo del bono.
`insType`	string	`BOND`.
`paisLey`	string	Pais de ley aplicable.
`moneda`	string	`Dolares`, `Pesos`, `Pesos Ajustables por CER`, `Dolar Linked`.
`emisor`	string	`Gobierno Nacional`, `Provincia de Buenos Aires`, `YPF S.A.`, etc.

Diferencia entre paneles `dict` y `list`

Panel	Tipo response	Estructura
`leading-equity`, `public-bonds`, `senebi-on`	dict	`{content: {pagenumber, pagecount, pagesize, totalelements_count}, data: [...], empty, upgrade}`
`cedears`, `on`, `cauciones`, `options`	list	`[item, item, ...]` directo

Flags adicionales

Flag	Descripcion
`--all`	Forza `page_size=5000` para traer todo en una sola llamada
`--t0`	Solo settlementType=1 (CI)
`--t1`	Solo settlementType=2 (24hs)
`--page N`	Numero de pagina (ignorado por la API — usar `--all`)
`--page-size N`	Items por pagina (default: 200)
`--desde YYYY-MM-DD`	Fecha desde (historicos)
`--hasta YYYY-MM-DD`	Fecha hasta (historicos)
`--resolution X`	`D`, `W`, `M` (default: `D`)
`-o archivo.json`	Guardar output a archivo
`-q` / `--quiet`	Modo silencioso (solo JSON)

Rate limiting

No hay rate limiting documentado. Recomendado:

Minimo 0.3 segundos entre requests.
El modo all usa time.sleep(0.3) automaticamente.

Manejo de errores

Status	Causas tipicas
400	Simbolo invalido (sin `24HS`, ticker desconocido)
401	Endpoint inexistente (BYMA usa 401 generico, no 404)
415	Content-Type erroneo (POST debe ser `application/json`)
500	Error interno de BYMA

Conversion de fechas

from datetime import datetime, timezone
# Unix seconds -> datetime
dt = datetime.fromtimestamp(ts, tz=timezone.utc)
# datetime -> Unix seconds
ts = int(datetime(2026, 6, 5, tzinfo=timezone.utc).timestamp())

Estructura del skill

skills/byma/
├── SKILL.md                          # Este archivo (guia rapida)
├── references/
│   └── REFERENCE.md                  # Documentacion completa de todos los endpoints
└── scripts/
    └── fetch_byma.py                 # Script principal

Documentacion detallada: Consultar [references/REFERENCE.md](./references/REFERENCE.md)
para documentacion exhaustiva de cada endpoint, schemas JSON, codigos
de settlementType/securityType, manejo del cert SSL, paginacion y
consideraciones tecnicas.

byma

Installation

Summary

Also in this package

Agent compatibility

Repository health

Skill metadata

Package contents

History

SKILL.md

BYMA — Bolsas y Mercados Argentinos

⚠️ Aviso Legal

🔒 Nota sobre certificado SSL

Scripts

Uso rapido

Endpoints disponibles

Base URL

Convenciones de simbolos

Historicos: formato `TICKER 24HS`

Bonos: convencion de sufijos por moneda

Indices conocidos

Filtros comunes en POST paneles

Consideraciones tecnicas

Datos devueltos por `panel` (todos)

Campos extra en bonos / ONs / cauciones / opciones

Datos devueltos por `historico` e `indice`

Datos devueltos por `bond-info`

Diferencia entre paneles `dict` y `list`

Flags adicionales

Rate limiting

Manejo de errores

Conversion de fechas

Estructura del skill

byma

Installation

Summary

Also in this package

Agent compatibility

Repository health

Skill metadata

Package contents

History

SKILL.md

BYMA — Bolsas y Mercados Argentinos

⚠️ Aviso Legal

🔒 Nota sobre certificado SSL

Scripts

Uso rapido

Endpoints disponibles

Base URL

Convenciones de simbolos

Historicos: formato TICKER 24HS

Bonos: convencion de sufijos por moneda

Indices conocidos

Filtros comunes en POST paneles

Consideraciones tecnicas

Datos devueltos por panel (todos)

Campos extra en bonos / ONs / cauciones / opciones

Datos devueltos por historico e indice

Datos devueltos por bond-info

Diferencia entre paneles dict y list

Flags adicionales

Rate limiting

Manejo de errores

Conversion de fechas

Estructura del skill

Historicos: formato `TICKER 24HS`

Datos devueltos por `panel` (todos)

Datos devueltos por `historico` e `indice`

Datos devueltos por `bond-info`

Diferencia entre paneles `dict` y `list`