Imported from gauss314/skills (
skills/byma/SKILL.md). Install upstream withnpx skills add gauss314/skills --skill byma. Copyright stays with the author (MIT).
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
# ── 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 -qEndpoints 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: {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
allusatime.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 para documentacion exhaustiva de cada endpoint, schemas JSON, codigos de settlementType/securityType, manejo del cert SSL, paginacion y consideraciones tecnicas.