OverviewHistoryStatsSecurity
npx skills add ...
Documentation
SKILL.md
npx skills add gauss314/skills --skill byma
Datos de mercado de BYMA (Bolsas y Mercados Argentinos) via API publica: paneles de acciones lideres, CEDEARs, bonos soberanos, LECAPs/BONCAPs, ONs corporativas, cauciones, opciones y SENEBI. Historicos OHLCV de instrumentos e indices (MERVAL, BURCAP). Ficha tecnica de bonos con cronograma de amortizacion. Sin API key.
npx skills add gauss314/skills --skill byma
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:
DOLAR-DDMM-U-CT-USD).M), BURCAP (G).BYMA presenta un certificado SSL cuya CA intermedia no esta incluida en
el bundle certifi estandar de Python. Esto causa:
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.
| Script | Descripcion |
|---|---|
| fetch_byma.py | Script principal: todos los 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).
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 |
| 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 |
| 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.
| 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.
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. |
| 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). |
historico e indice| 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). |
bond-infoDevuelve {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. |
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 |
| 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) |
No hay rate limiting documentado. Recomendado:
all usa time.sleep(0.3) automaticamente.| 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 |
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.
# ── 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 -qhttps://open.bymadata.com.ar/vanoms-be-core/rest/api/bymadata/free{
"s": "ok",
"t": [unix_seconds, ...],
"o": [opens, ...],
"h": [highs, ...],
"l": [lows, ...],
"c": [closes, ...],
"v": [volumes, ...]
}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())skills/byma/
├── SKILL.md # Este archivo (guia rapida)
├── references/
│ └── REFERENCE.md # Documentacion completa de todos los endpoints
└── scripts/
└── fetch_byma.py # Script principal