Byma

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 | OHLCV diario/semanal/mensual de un instrumento | GET /chart/historical-series/history?symbol={...} | | indice | OHLCV de un indice (M=MERVAL, G=BURCAP) | GET /chart/index-historical-series/history?symbol={...} | | bond-info | 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: {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

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.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: gauss314
• Source: gauss314/skills
• License: MIT

Install and usage instructions live in the source repository linked above.