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

---

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

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.

Bonos: convencion de sufijos por moneda

Indices conocidos

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

---

Filtros comunes en POST paneles

⚠️ 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:

Campos extra en bonos / ONs / cauciones / opciones

Datos devueltos por historico e indice

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

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]:

Diferencia entre paneles dict y list

Flags adicionales

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

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.

BYMA — Referencia Completa de la API

BYMA = Bolsas y Mercados Argentinos. Bolsa principal de Argentina —

sucesor del Merval. Negocia acciones, CEDEARs, bonos soberanos y

corporativos (ON), opciones, cauciones y operaciones SENEBI (Sistema

Electronico de Negociacion Bilateral).

>

Esta documentacion cubre la API publica de market data expuesta en

open.bymadata.com.ar (sin API key, sin autenticacion).

---

Indice

1. Resumen de endpoints 2. Convenciones de la API 3. Manejo del certificado SSL 4. Panel — Leading Equity 5. Panel — CEDEARs 6. Panel — Public Bonds (Soberanos + LECAPs) 7. Panel — Obligaciones Negociables (ON) 8. Panel — Cauciones 9. Panel — SENEBI Obligaciones Negociables 10. Panel — Opciones 11. Historico — Instrumentos 12. Historico — Indices 13. Bond Info — Ficha tecnica de bonos / ONs 14. Codigos: settlementType, securityType, securitySubType, market 15. Paginacion: limitaciones y workaround 16. Manejo de errores 17. Consideraciones tecnicas

---

1. Resumen de endpoints

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

Base URL

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

---

2. Convenciones de la API

Headers

HEADERS = {
    "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36",
    "Accept": "application/json",
    "Content-Type": "application/json",
}

POST body

Todos los endpoints POST aceptan body JSON. Payload minimo: {}.

Campos opcionales comunes en TODOS los paneles:

T0 || T1 activan filtros; cuando ambos estan en true o en false, no se filtra.

GET params

Los GET (historicos) usan query string:

Formato de fechas

• En GET params: from y to son unix timestamp en segundos UTC (no milisegundos).
• En responses: timestamps unix UTC seconds en t[]. Fechas ISO en maturityDate (YYYY-MM-DD).

Conversion

from datetime import datetime, timezone
ts = int(datetime(2026, 6, 5, tzinfo=timezone.utc).timestamp())
# Inverso:
dt = datetime.fromtimestamp(ts, tz=timezone.utc)

---

3. Manejo del certificado SSL

BYMA presenta un certificado SSL cuya CA intermedia no esta incluida en los bundles estandar de Python (certifi). Esto causa:

SSLError: CERTIFICATE_VERIFY_FAILED: unable to get local issuer certificate

Workaround usado: verify=False en requests.get/post.

import requests
import urllib3
urllib3.disable_warnings(urllib3.exceptions.InsecureRequestWarning)

r = requests.post(url, json=payload, verify=False)

Por que es razonable aqui:

1. La data es publica — no se envian credenciales. 2. La conexion sigue siendo TLS-encrypted (solo se omite la validacion de cadena). 3. Es el patron estandar usado por todas las librerias publicas de BYMA (pyhomebroker, bymadata, etc.). 4. El usuario autorizo explicitamente esta excepcion.

Alternativa mas segura (no usada): instalar el cert intermedio de BYMA en el trust store del sistema. Mas frecuente que falle si BYMA rota el cert.

---

4. Panel — Leading Equity

Endpoint: POST /leading-equity

Panel de 20 acciones lideres del MERVAL × 2 settlements (CI + 24hs) = 40 items.

Body

{}                       // todos los settlements
{"T0": true}             // solo CI (20 items)
{"T1": true}             // solo 24hs (20 items)
{"page": 1, "page_size": 100}

Response

{
  "content": {
    "page_number": 1,
    "page_count": 1,
    "page_size": 189,
    "total_elements_count": 40
  },
  "data": [
    {
      "tradeVolume": 39310,
      "symbol": "ALUA",
      "imbalance": -0.0098,
      "previousSettlementPrice": 1012,
      "offerPrice": 0,
      "openInterest": 0,
      "vwap": 1018.5664716,
      "description": "",
      "numberOfOrders": 210,
      "openingPrice": 1025,
      "tickDirection": 0,
      "securityDesc": "",
      "securitySubType": "M",
      "previousClosingPrice": 1012,
      "settlementType": "1",
      "quantityOffer": 0,
      "tradingHighPrice": 1026,
      "denominationCcy": "ARS",
      "bidPrice": 0,
      "tradingLowPrice": 998,
      "market": "BYMA",
      "volumeAmount": 40039848,
      "volume": 39310,
      "trade": 1002,
      "tradeHour": "16:35:24",
      "securityType": "CS",
      "closingPrice": 1002,
      "settlementPrice": 1002,
      "quantityBid": 0
    }
  ],
  "empty": false,
  "upgrade": false
}

Simbolos del panel (20)

ALUA, BBAR, BMA, BYMA, CEPU, COME, CRES, ECOG, EDN, GGAL, LOMA, METR, PAMP, SUPV, TGNO4, TGSU2, TRAN, TXAR, VALO, YPFD.

Campos

---

5. Panel — CEDEARs

Endpoint: POST /cedears

CEDEARs (Certificados de Deposito Argentinos) listados en BYMA. ~1143 tickers unicos × 2 settlements = 2000 items.

Body

{}                                  // todos
{"T0": true}                        // solo CI
{"T1": true}                        // solo 24hs
{"page_size": 5000}                 // garantia de traer todo

Response

list directa (no envuelve en {content, data} como leading-equity).

Schema

Mismo schema que leading-equity, excepto:

Convencion de tickers

Los CEDEARs tienen variantes por moneda:

Esto suma 3 tickers x 2 settlements = 6 items por underlying en muchos casos.

---

6. Panel — Public Bonds (Soberanos + LECAPs)

Endpoint: POST /public-bonds

Bonos soberanos nacionales + LECAPs + BONCAPs. ~104 unicos × 6 variantes = 1018 items.

Body

{"page_size": 2000}              // recomendado para traer todo
{"T0": true}                     // solo CI (506 items)
{"T1": true}                     // solo 24hs (512 items)

Response

{
  "content": {...},
  "data": [
    {
      "tradeVolume": 5033350,
      "symbol": "AE38",
      "imbalance": -0.0022,
      "previousSettlementPrice": 119400,
      "offerPrice": 0,
      "openInterest": 0,
      "vwap": 119789.7606008,
      "description": "",
      "numberOfOrders": 1551,
      "openingPrice": 119320,
      "tickDirection": -1,
      "securityDesc": "",
      "securitySubType": "B",
      "maturityDate": "2038-01-09",
      "previousClosingPrice": 119400,
      "settlementType": "1",
      "quantityOffer": 0,
      "tradingHighPrice": 120070,
      "denominationCcy": "ARS",
      "bidPrice": 0,
      "tradingLowPrice": 118850,
      "market": "BYMA",
      "volumeAmount": 6029437915.2,
      "volume": 5033350,
      "trade": 119130,
      "daysToMaturity": 4237,
      "tradeHour": "16:50:01",
      "securityType": "GO",
      "closingPrice": 119130,
      "settlementPrice": 119130,
      "quantityBid": 0
    }
  ]
}

Campos adicionales vs acciones

Convencion de tickers — bonos hard dollar

LECAPs y BONCAPs

Identificables por prefijo:

• S* (5 chars): LECAPs — ej S237Q, SA24D, SBC1C
• T* (5 chars): BONCAPs — ej T30A7, T15E7, T2X7

No todos los simbolos LECAP/BONCAP tienen historico disponible. Algunos

antiguos (S31E6) retornan 0 puntos.

---

7. Panel — Obligaciones Negociables (ON)

Endpoint: POST /negociable-obligations

Obligaciones Negociables corporativas (bonos corporativos). ~2117 items.

Body

{}
{"page_size": 5000}

Response

list directa (no envuelve).

Campos especificos

• securityType = CORP
• securitySubType = (vacio o B)
• Misma estructura que public-bonds (incluye maturityDate, daysToMaturity).

Convencion de tickers

• Acortados a ~5 chars con letras de variante (D, C, O, X, etc.)
• Ejemplos: SBC1C, T641D, T661O

---

8. Panel — Cauciones

Endpoint: POST /cauciones

Cauciones (prestamos colateralizados de muy corto plazo) y operaciones a plazo. ~133 items.

Body

{}

Response

list directa.

Schema

{
  "tradeVolume": 0.0,
  "symbol": "DOLAR-0107-U-CT-USD",
  "imbalance": 0.0,
  "previousSettlementPrice": 0.03,
  "offerPrice": 0.0,
  "openInterest": 0.0,
  "vwap": 0.0,
  "description": "",
  "numberOfOrders": 0,
  "openingPrice": 0.0,
  "tickDirection": -1,
  "underlyingSymbol": "DOLAR",
  "securityDesc": "",
  "securitySubType": "",
  "maturityDate": "2026-07-01",
  "previousClosingPrice": 0.03,
  "settlementType": "1",
  "quantityOffer": 0.0,
  "tradingHighPrice": 0.0,
  "denominationCcy": "USD",
  "bidPrice": 0.0,
  "tradingLowPrice": 0.0,
  "market": "BYMA",
  "volumeAmount": 0.0,
  "volume": 0.0,
  "trade": 0.0,
  "daysToMaturity": 27,
  "securityType": "QS",
  "closingPrice": 0.03,
  "settlementPrice": 0,
  "quantityBid": 0.0
}

Convencion de tickers

{UNDERLYING}-{DDMM}-U-CT-{CCY} — ej DOLAR-0107-U-CT-USD:

• DOLAR = activo subyacente.
• 0107 = vencimiento (1 de Julio).
• U-CT = identificador del tipo.
• USD = moneda.

Campos especificos

• underlyingSymbol = activo subyacente (DOLAR).
• securityType = QS (Caucion).
• maturityDate + daysToMaturity = vencimiento.
• La cotizacion (trade, closingPrice, etc.) esta en formato de tasa o

precio segun el instrumento (cauciones suelen cotizar en tasa o factor).

---

9. Panel — SENEBI Obligaciones Negociables

Endpoint: POST /senebi-obligaciones-negociables

ONs negociadas en el segmento SENEBI (Sistema Electronico de Negociacion Bilateral) — operaciones bilaterales reportadas a BYMA. ~3160 items.

Body

{"page_size": 5000}              // recomendado
{"T0": true}                     // solo CI (1505 items)
{"T1": true}                     // solo 24hs (1655 items)

Response

Envuelve en {content, data} igual que leading-equity.

Schema

{
  "symbol": "A11LD.SB",
  "tradeVolume": 0,
  "imbalance": 0,
  "previousSettlementPrice": 0,
  "offerPrice": 0,
  "vwap": 0,
  "description": "",
  "numberOfOrders": 0,
  "openingPrice": 0,
  "tickDirection": 0,
  "securityDesc": "",
  "securitySubType": "",
  "maturityDate": "2028-03-31",
  "previousClosingPrice": 0,
  "settlementType": "1",
  "quantityOffer": 0,
  "tradingHighPrice": 0,
  "denominationCcy": "EXT",
  "bidPrice": 0,
  "tradingLowPrice": 0,
  "market": "SENEBI",
  "volumeAmount": 0,
  "volume": 0,
  "trade": 0,
  "daysToMaturity": 666,
  "securityType": "CORP",
  "closingPrice": 0,
  "settlementPrice": 0,
  "quantityBid": 0
}

Diferencias vs panel on

• market = SENEBI (en vez de BYMA).
• Sufijo .SB en el symbol (ej A11LD.SB).
• Mucho mas volumen de tickers porque SENEBI agrupa toda emision corporativa

bilateral, no solo las listadas en panel principal.

---

10. Panel — Opciones

Endpoint: POST /options

Opciones de acciones argentinas. ~429 items.

Body

{}

Response

list directa.

Schema

{
  "tradeVolume": 1.0,
  "symbol": "ALUC1000AG",
  "imbalance": 0.0,
  "previousSettlementPrice": 0.0,
  "offerPrice": 0.0,
  "openInterest": 0.0,
  "vwap": 65.0,
  "description": "",
  "numberOfOrders": 1,
  "openingPrice": 65.0,
  "optionType": "CALL",
  "tickDirection": 0,
  "underlyingSymbol": "ALUA",
  "securityDesc": "",
  "securitySubType": "",
  "maturityDate": "2026-08-21",
  "previousClosingPrice": 0.0,
  "settlementType": "2",
  "quantityOffer": 0.0,
  "tradingHighPrice": 65.0,
  "denominationCcy": "ARS",
  "bidPrice": 0.0,
  "tradingLowPrice": 65.0,
  "market": "BYMA",
  "volumeAmount": 6500.0,
  "volume": 1.0,
  "trade": 65.0,
  "daysToMaturity": 78,
  "tradeHour": "14:59:50",
  "securityType": "OPT",
  "closingPrice": 65.0,
  "settlementPrice": 65.0,
  "quantityBid": 0.0
}

Campos especificos

Decodificacion del ticker

Las opciones BYMA siguen el formato: {ROOT}{C|V}{STRIKE}{MES}{AÑO?}

ALUC1000AG → ALUA + C (Call) + 1000 (strike) + AG (Agosto)

Para parsear consistentemente, usar el campo strike cuando este

presente, o derivarlo de underlyingSymbol + posicion del strike.

El esquema oficial requiere decodificar por contexto.

---

11. Historico — Instrumentos

Endpoint: GET /chart/historical-series/history

OHLCV historico de un instrumento (accion, CEDEAR, bono, ON, opcion).

Query params

Formato simbolo

⚠️ Sufijo CI no funciona en historicos — retorna HTTP 400.

⚠️ 48HS funciona pero retorna 0 puntos (no se negocia ese settlement con regularidad).

⚠️ Sin sufijo retorna 400 — siempre incluir 24HS.

Response

{
  "s": "ok",
  "t": [1715569200, 1715655600, 1715742000, ...],
  "o": [3500.0, 3520.5, 3490.0, ...],
  "h": [3550.0, 3540.0, 3510.0, ...],
  "l": [3480.0, 3490.0, 3460.0, ...],
  "c": [3520.0, 3510.0, 3495.0, ...],
  "v": [50000, 65000, 42000, ...]
}

Campos

Comportamiento de resolution

---

12. Historico — Indices

Endpoint: GET /chart/index-historical-series/history

Serie historica de un indice BYMA.

Query params

Igual que historico de instrumentos:

Indices verificados con datos

Indices que existen pero retornan ceros

A, B, V y otras letras retornan HTTP 200 con c[] lleno de 0.0 — probablemente indices deprecated o sin publicacion historica oficial.

Response

Mismo schema que historico de instrumentos:

{
  "s": "ok",
  "t": [1715569200, ...],
  "o": [...], "h": [...], "l": [...], "c": [...], "v": [...]
}

⚠️ El campo v[] (volumen) tipicamente es 0 en indices.

---

13. Bond Info — Ficha tecnica de bonos / ONs

Endpoint: POST /bnown/fichatecnica/especies/general

Ficha tecnica completa de un bono, LECAP, BONCAP u ON: ley aplicable, forma de amortizacion, esquema de intereses (cupones), fechas de emision/vencimiento, ISIN, moneda, monto nominal/residual, emisor.

Es el endpoint principal para calculos de cashflow porque devuelve el texto oficial con el cronograma de amortizacion y la formula de intereses (incluido step-up para bonos con tasas crecientes).

Body

{"symbol": "AE38"}

⚠️ Payload vacio ({}) retorna 200 con data: [] y empty: true.

Payload null retorna 400 ("Failed to read request").

Response

{
  "content": {
    "page_number": 1,
    "page_count": 1,
    "page_size": 50,
    "total_elements_count": 1
  },
  "data": [
    {
      "ley": "Nacional",
      "formaAmortizacion": "La amortizacion se efectuara en VEINTIDOS (22) cuotas semestrales iguales el 9 de enero y el 9 de julio de cada año, con la primera cuota el 9 de julio de 2027 y la ultima cuota el 9 de enero de 2038.\nLa totalidad de las condiciones definitivas de la presente emision constan en la Resolucion N° 381/2020 del Ministerio de Economia de la Nacion publicada el 18.08.2020 en el Boletin Oficial.",
      "denominacionMinima": 1,
      "fechaVencimiento": "2038-01-09 00:00:00.0",
      "tipoGarantia": "Comun",
      "fechaEmision": "2020-09-04 00:00:00.0",
      "fechaDevenganIntereses": "",
      "codigoIsin": "ARARGE3209U2",
      "tipoEspecie": "Titulos Publicos",
      "default": "",
      "tipoObligacion": "Valores Publicos Nacionales",
      "montoNominal": 10063292009,
      "denominacion": "BONOS DE LA REPUBLICA ARGENTINA EN DOLARES ESTADOUNIDENSES STEP UP 2038",
      "insType": "BOND",
      "paisLey": "",
      "moneda": "Dolares",
      "montoResidual": 10063292009,
      "interes": "Devengaran intereses, sobre la base de un año de 360 dias integrado por 12 meses de 30 dias cada uno, de acuerdo con las siguientes tasas anuales:\ni. Del 4 de septiembre de 2020 (inclusive) al 9 de julio de 2021 (exclusive): 0,125%.\nii. Del 9 de julio de 2021 (inclusive) al 9 de julio de 2022 (exclusive): 2,00%.\niii. Del 9 de julio de 2022 (inclusive) al 9 de julio de 2023 (exclusive): 3,875%.\niv. Del 9 de julio de 2023 (inclusive) al 9 de julio de 2024 (exclusive): 4,25%.\nv. Del 9 de julio de 2024 (inclusive) al vencimiento: 5,00%.",
      "emisor": "Gobierno Nacional"
    }
  ],
  "empty": false,
  "upgrade": false
}

Campos de data[0]

Ejemplos de aplicacion

1. Distinguir AL30 (ley local) vs GD30 (ley NY):

al30 = fetch_bond_info("AL30")
gd30 = fetch_bond_info("GD30")
print(al30['data'][0]['ley'])  # "Nacional"
print(gd30['data'][0]['ley'])  # "Nueva York" (mas seguro juridicamente)

2. Parsear cronograma de amortizacion (AE38):

info = fetch_bond_info("AE38")
texto = info['data'][0]['formaAmortizacion']
# "22 cuotas semestrales iguales el 9 de enero y el 9 de julio,
#  primera 9 julio 2027, ultima 9 enero 2038"
# -> ~4.545% del nominal por cuota, 22 cuotas

3. Detectar step-up vs tasa fija:

info = fetch_bond_info("AE38")
if "tasas anuales" in info['data'][0]['interes'].lower():
    print("Step-up bond")

Variantes y limitaciones

Encoding

Los textos largos (formaAmortizacion, interes) pueden contener caracteres latin-1 que se muestran como ? en consolas Windows pero se salvan correctamente con json.dumps(..., ensure_ascii=False) a archivos UTF-8.

---

14. Codigos: settlementType, securityType, securitySubType, market

settlementType

securityType

securitySubType

market

denominationCcy

tickDirection

---

15. Paginacion: limitaciones y workaround

Problema

Los endpoints POST devuelven en el content un campo page_count que sugiere paginacion (ej: page_count: 6 para public-bonds). Sin embargo, el parametro `page` en el body es IGNORADO por la API actual.

Evidencia experimental:

# Todas estas variantes retornan SIEMPRE pagina 1:
post("public-bonds", {"page": 2, "page_size": 10})
post("public-bonds", {"page_number": 2, "page_size": 10})
post("public-bonds", {"pageNumber": 2, "pageSize": 10})
post("public-bonds", {"current_page": 2})
post("public-bonds", {"offset": 10, "limit": 10})
# El response siempre tiene content.page_number == 1, data[0].symbol == "AE38"

Tampoco funciona:

• Content-Type: application/x-www-form-urlencoded (415 Unsupported)
• Headers extra (Origin, Referer, X-Requested-With)
• camelCase de los params

Workaround

Usar page_size grande para traer todo el dataset en una sola llamada:

post("public-bonds", {"page_size": 2000})       # 1018 items en 1 call
post("senebi-obligaciones-negociables", {"page_size": 5000})  # 3160 items

El script fetch_byma.py expone esto via flag --all que setea page_size=5000 automaticamente.

Tabla por panel

---

16. Manejo de errores

Patrones de error en historicos

• symbol=GGAL (sin sufijo) → 400 (body vacio).
• symbol=GGAL CI (sufijo CI no soportado) → 400.
• symbol=GGAL 48HS → 200 con t=[].
• symbol=AAPL 24HS (CEDEAR valido) → 200 con datos.

Paths que retornan 401

Cualquier path no incluido en la lista oficial:

• /indices, /indexes, /symbols, /search, /leading-bonds, etc.

---

17. Consideraciones tecnicas

Rate limiting

No documentado ni observado limite. Se recomienda:

• Minimo 0.3 segundos entre requests.
• El all mode usa time.sleep(0.3) entre cada llamada.
• Para batches > 50 requests, considerar pool con aiohttp con

concurrency cap = 5.

Delay de los datos

• Paneles intradia: tiempo real (15-min delay tipico de mercado argentino).
• Historicos: T-1 disponible al cierre del dia siguiente (~19hs ART).

Horarios de mercado

• Rueda BYMA: 11:00 - 17:00 ART (Lunes a Viernes).
• Pre-mercado / Post-mercado: limitado, mayormente no operativo.

Encoding

API retorna UTF-8 valido. No hay problemas de encoding como en MAE.

CORS

API admite CORS para localhost y dominios oficiales de BYMA. Para uso desde frontend, considerar proxy de cache.

Disponibilidad

• API disponible 24/7.
• Datos se actualizan solo en horario de rueda.
• Fines de semana y feriados: snapshots devuelven datos del ultimo dia habil.

Aviso legal

• API publica de BYMA, sin documentacion oficial.
• Los endpoints pueden cambiar sin aviso.
• Para uso comercial intensivo, contactar BYMA para licencias oficiales.

---

Referencias

• BYMA Oficial: https://www.byma.com.ar
• Open Market Data: https://open.bymadata.com.ar
• CNV (regulador): https://www.cnv.gov.ar
• Listado oficial de simbolos: ver paneles via API