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
fetch_byma.py	Script principal: todos los endpoints disponibles

Uso rapido

bash

# ── 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

indice

json

{
  "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: []

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

list

Panel	Tipo response	Estructura
`leading-equity` , `public-bonds` , `senebi-on`	dict	`{content: {page_number, page_count, page_size, total_elements_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

python

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 para documentacion exhaustiva de cada endpoint, schemas JSON, codigos de settlementType/securityType, manejo del cert SSL, paginacion y consideraciones tecnicas.

byma

NPX Install

Tags

SKILL.md Content

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

NPX Install

Tags

SKILL.md Content

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`