Back to Details

byma

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

BYMA — Bolsas y Mercados Argentinos

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:
  • 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).
本Skill用于通过BYMA的公开市场数据API（
open.bymadata.com.ar
）提取BYMA的市场数据——无需API密钥，无需身份验证。
BYMA是阿根廷的主要证券交易所（MERVAL的继任者），可交易以下品类：
  • 领先股票（MERVAL成分股面板，含20个代码）。
  • CEDEARs（约1143个独特品种 × 2种结算方式）。
  • 主权公共债券 + LECAPs + BONCAPs（约104个独特品种 × 6种变体）。
  • 公司债券（ON）（约2117项）。
  • SENEBI ON（双边交易板块，约3160项）。
  • 回购交易（133项，格式为
    DOLAR-DDMM-U-CT-USD
    ）。
  • 期权（约429项，含行权价、持仓量、到期日）。
  • 指数：S&P MERVAL（代码
    M
    ）、BURCAP（代码
    G
    ）。
  • 历史OHLCV数据：所有工具的日/周/月线数据。
  • 债券技术资料（摊销方式、阶梯利率、ISIN、适用法律、发行方）。

⚠️ 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.
  • 这是BYMA的公开API，无官方文档。端点可能会无预警变更。
  • 请遵守BYMA的使用条款，请求频率不要超过1次/秒。
  • 数据存在延迟（阿根廷市场通常延迟约15分钟）。
  • 如需商业密集型使用，请联系BYMA获取官方授权。

🔒 Nota sobre certificado SSL

🔒 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.
BYMA的SSL证书其中间CA未包含在Python标准
certifi
证书包中，会导致以下错误：
SSLError: CERTIFICATE_VERIFY_FAILED
本脚本使用
verify=False
 —— 连接仍为TLS加密，但跳过证书链验证。这是BYMA公开库（如
pyhomebroker
、
bymadata
等）的标准做法。
若不想使用
verify=False
，可将BYMA的中间证书安装到系统信任存储中。

Scripts

脚本

ScriptDescripcion
fetch_byma.pyScript principal: todos los endpoints disponibles
脚本描述
fetch_byma.py主脚本：包含所有可用端点

Uso rapido

快速使用

bash
undefined
bash
undefined

── PANELES (POST) ────────────────────────────────────────────────────

── 面板数据（POST请求） ────────────────────────────────────────────────────

Panel lideres: 20 acciones MERVAL x 2 settlements (40 items)

领先股票面板：20支MERVAL成分股 × 2种结算方式（共40项）

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)
py scripts/fetch_byma.py panel leading-equity py scripts/fetch_byma.py panel leading-equity --t0 # 仅CI（T+0）结算 py scripts/fetch_byma.py panel leading-equity --t1 # 仅24小时（T+1）结算

Panel CEDEARs (~2000 items, lista directa)

CEDEARs面板（约2000项，直接返回列表）

py scripts/fetch_byma.py panel cedears
py scripts/fetch_byma.py panel cedears

Panel bonos publicos (1018 items, paginado a 189 por defecto)

公共债券面板（1018项，默认分页每页189项）

py scripts/fetch_byma.py panel public-bonds py scripts/fetch_byma.py panel public-bonds --all # trae los 1018 en una llamada
py scripts/fetch_byma.py panel public-bonds py scripts/fetch_byma.py panel public-bonds --all # 单次请求获取全部1018项

Panel ON corporativas (~2117 items, lista directa)

公司债券（ON）面板（约2117项，直接返回列表）

py scripts/fetch_byma.py panel on
py scripts/fetch_byma.py panel on

Panel cauciones (~133 items)

回购交易面板（约133项）

py scripts/fetch_byma.py panel cauciones
py scripts/fetch_byma.py panel cauciones

Panel SENEBI ON (3160 items, paginado)

SENEBI ON面板（3160项，分页返回）

py scripts/fetch_byma.py panel senebi-on py scripts/fetch_byma.py panel senebi-on --all # trae los 3160 en una llamada
py scripts/fetch_byma.py panel senebi-on py scripts/fetch_byma.py panel senebi-on --all # 单次请求获取全部3160项

Panel opciones (~429 items, con strike, OI, vencimiento)

期权面板（约429项，含行权价、持仓量、到期日）

py scripts/fetch_byma.py panel options
py scripts/fetch_byma.py panel options

── HISTORICOS OHLCV (GET) ────────────────────────────────────────────

── 历史OHLCV数据（GET请求） ────────────────────────────────────────────

Historico de un instrumento — formato simbolo: "TICKER 24HS"

单工具历史数据 —— 格式为 "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
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 py scripts/fetch_byma.py historico "AAPLD 24HS" # 美元计价CEDEAR py scripts/fetch_byma.py historico "AL30 24HS" # 阿根廷比索计价债券 py scripts/fetch_byma.py historico "AL30D 24HS" # 美元计价债券 py scripts/fetch_byma.py historico "AL30C 24HS" # 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)

指定日期范围（默认：最近30天）

py scripts/fetch_byma.py historico "GGAL 24HS" --desde 2024-05-15 --hasta 2026-06-05
py scripts/fetch_byma.py historico "GGAL 24HS" --desde 2024-05-15 --hasta 2026-06-05

Resolutions: D (diario), W (semanal), M (mensual)

数据周期：D（日线）、W（周线）、M（月线）

py scripts/fetch_byma.py historico "GGAL 24HS" --resolution W py scripts/fetch_byma.py historico "GGAL 24HS" --resolution M
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

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

BURCAP指数历史数据

py scripts/fetch_byma.py indice G
py scripts/fetch_byma.py indice G

── FICHA TECNICA DE BONOS ─────────────────────────────────────────────

── 债券技术资料 ─────────────────────────────────────────────

Ficha tecnica completa: forma de amortizacion, intereses, ISIN, ley, emisor

完整技术资料：摊销方式、利率、ISIN、适用法律、发行方

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
py scripts/fetch_byma.py bond-info AE38 # 2038年到期阶梯利率美元主权债券 py scripts/fetch_byma.py bond-info AL30 # 2030年到期本地法美元主权债券 py scripts/fetch_byma.py bond-info GD30 # 2030年到期纽约法美元主权债券 py scripts/fetch_byma.py bond-info AE38C # CCL变体（同一份技术资料） py scripts/fetch_byma.py bond-info AE38D # USD MEP变体（同一份技术资料） py scripts/fetch_byma.py bond-info BPOA7 # BOPREAL系列1 A py scripts/fetch_byma.py bond-info TY30P # BONCAP债券 py scripts/fetch_byma.py bond-info TZX26 # CER计价BONCAP债券 py scripts/fetch_byma.py bond-info S237Q # LECAP债券 py scripts/fetch_byma.py bond-info SBC1C # 公司债券（ON）

── COMBINADO ──────────────────────────────────────────────────────────

── 组合请求 ──────────────────────────────────────────────────────────

Snapshot de todos los paneles + MERVAL + BURCAP

所有面板数据 + MERVAL + BURCAP快照

py scripts/fetch_byma.py all
py scripts/fetch_byma.py all

── OUTPUT ─────────────────────────────────────────────────────────────

── 输出设置 ─────────────────────────────────────────────────────────────

Guardar a archivo JSON

保存为JSON文件

py scripts/fetch_byma.py panel leading-equity -o leading.json py scripts/fetch_byma.py all -o snapshot_byma.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)

静默模式（仅输出JSON，无日志）

py scripts/fetch_byma.py panel cauciones -q

---
py scripts/fetch_byma.py panel cauciones -q

---

Endpoints disponibles

可用端点

ModoDataEndpoint
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).
模式数据内容端点
panel leading-equity
MERVAL前20支成分股 × 2种结算方式（40项）
POST /leading-equity
panel cedears
CEDEARs（约2000项）
POST /cedears
panel public-bonds
主权债券 + LECAPs/BONCAPs（约1018项）
POST /public-bonds
panel on
公司债券（ONs，约2117项）
POST /negociable-obligations
panel cauciones
回购交易（约133项）
POST /cauciones
panel senebi-on
SENEBI ONs（约3160项，分页）
POST /senebi-obligaciones-negociables
panel options
期权（约429项）
POST /options
historico <SYM>
单工具的日/周/月OHLCV数据
GET /chart/historical-series/history?symbol={...}
indice <COD>
指数OHLCV数据（M=MERVAL，G=BURCAP）
GET /chart/index-historical-series/history?symbol={...}
bond-info <TICKER>
债券/LECAP/BONCAP/ON的技术资料（摊销、利率、ISIN、发行方）
POST /bnown/fichatecnica/especies/general
all
所有面板数据 + 指数快照（组合请求）
总计：已验证10个公开端点 ✅（8个POST + 2个历史数据GET）。

Base URL

基础URL

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

Convenciones de simbolos

代码符号约定

Historicos: formato 
TICKER 24HS

历史数据：格式为 
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.
TipoEjemplo
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
⚠️ 所有历史数据请求必须添加后缀
 24HS
（含空格）。无后缀会返回HTTP 400错误。后缀
CI
也会返回400（不支持）。
48HS
会返回200但数据为空。
类型示例
股票
GGAL 24HS
, 
ALUA 24HS
, 
YPFD 24HS
阿根廷比索计价CEDEAR
AAPL 24HS
, 
MSFT 24HS
美元计价CEDEAR
AAPLD 24HS
, 
MSFTD 24HS
阿根廷比索计价主权债券
AL30 24HS
, 
GD30 24HS
, 
AE38 24HS
USD MEP计价主权债券
AL30D 24HS
, 
GD30D 24HS
CCL计价主权债券
AL30C 24HS
, 
GD30C 24HS
LECAP/BONCAP
TY30P 24HS
, 
TZX26 24HS

Bonos: convencion de sufijos por moneda

债券：按货币区分的后缀约定

SufijoVarianteEjemplo
(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
后缀变体类型示例
（无）ARS — 比索计价
AL30
C
CCL（即时清算/EXT）
AL30C
D
USD MEP
AL30D
X
, 
Y
, 
Z
其他变体（日内交易、替代结算方式）
AL30X

Indices conocidos

已知指数代码

CodigoIndice
M
S&P MERVAL
G
BURCAP
Otros codigos (A, B, V, etc.) son aceptados pero retornan series con todos ceros — probablemente indices deprecated.
代码指数名称
M
S&P MERVAL
G
BURCAP
其他代码（A、B、V等）可被接受，但返回全零数据——可能是已废弃的指数。

Filtros comunes en POST paneles

POST面板请求的通用过滤器

FiltroDescripcion
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
.
过滤器描述
T0=true
仅返回
settlementType=1
（CI / 即时清算）
T1=true
仅返回
settlementType=2
（24小时结算）
T2=true
仅返回
settlementType=3
（48小时结算——几乎无数据）
page_size=5000
单次请求获取全部数据集（推荐用于
public-bonds
和
senebi-on
）
⚠️ 参数
page
（页码）被API忽略——始终返回第1页。解决方案：使用大
page_size
或
--all
标志。

Consideraciones tecnicas

技术细节

Datos devueltos por 
panel
(todos)

panel
请求返回的数据（所有面板）

Cada item incluye:
CampoTipoDescripcion
symbol
stringTicker 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
floatUltimo precio operado.
closingPrice
floatCierre del dia.
settlementPrice
floatPrecio de settlement.
openingPrice
, 
tradingHighPrice
, 
tradingLowPrice
floatOHL del dia.
previousClosingPrice
, 
previousSettlementPrice
floatCierre / settlement anterior.
imbalance
floatVariacion % vs anterior (decimal: -0.0098 = -0.98%).
volume
, 
tradeVolume
floatVolumen nominal.
volumeAmount
floatMonto efectivo en moneda.
vwap
floatVolume-Weighted Average Price.
bidPrice
, 
offerPrice
floatMejor bid/offer (0 fuera de horario).
quantityBid
, 
quantityOffer
floatCantidades de bid/offer.
numberOfOrders
intNumero total de ordenes del dia.
openInterest
floatInteres abierto (real en opciones/cauciones; 0 en acciones).
tickDirection
int-1 / 0 / +1 (downtick / unchanged / uptick).
tradeHour
stringHora del ultimo trade.
每个条目包含以下字段：
字段类型描述
symbol
stringBYMA代码。
settlementType
string
"1"
（CI）或
"2"
（24小时）。
securityType
string
CS
（普通股）、
CD
（CEDEAR）、
GO
（政府债券）、
CORP
（公司债券）、
QS
（回购）、
OPT
（期权）。
denominationCcy
string
ARS
, 
USD
, 
EXT
。
market
string
BYMA
或
SENEBI
。
trade
float最新成交价。
closingPrice
float当日收盘价。
settlementPrice
float结算价。
openingPrice
, 
tradingHighPrice
, 
tradingLowPrice
float当日开盘价/最高价/最低价。
previousClosingPrice
, 
previousSettlementPrice
float前一日收盘价/结算价。
imbalance
float较前一日涨跌幅（小数：-0.0098 = -0.98%）。
volume
, 
tradeVolume
float名义成交量。
volumeAmount
float实际成交金额（对应货币）。
vwap
float成交量加权平均价。
bidPrice
, 
offerPrice
float最优买价/卖价（非交易时段为0）。
quantityBid
, 
quantityOffer
float买/卖委托量。
numberOfOrders
int当日总委托单数。
openInterest
float持仓量（期权/回购为真实值；股票为0）。
tickDirection
int-1 / 0 / +1（下跌/持平/上涨）。
tradeHour
string最新成交时间。

Campos extra en bonos / ONs / cauciones / opciones

债券/公司债券/回购/期权的额外字段

CampoDescripcion
maturityDate
Fecha de vencimiento (ISO 
YYYY-MM-DD
).
daysToMaturity
Dias hasta vencimiento.
underlyingSymbol
Underlying (solo cauciones y opciones).
optionType
CALL
o 
PUT
(solo opciones).
字段描述
maturityDate
到期日（ISO格式
YYYY-MM-DD
）。
daysToMaturity
剩余到期天数。
underlyingSymbol
标的资产代码（仅回购和期权）。
optionType
CALL
或
PUT
（仅期权）。

Datos devueltos por 
historico
e 
indice

historico
和
indice
请求返回的数据

json
{
  "s": "ok",
  "t": [unix_seconds, ...],
  "o": [opens, ...],
  "h": [highs, ...],
  "l": [lows, ...],
  "c": [closes, ...],
  "v": [volumes, ...]
}
CampoDescripcion
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).
json
{
  "s": "ok",
  "t": [unix_seconds, ...],
  "o": [opens, ...],
  "h": [highs, ...],
  "l": [lows, ...],
  "c": [closes, ...],
  "v": [volumes, ...]
}
字段描述
s
状态：
"ok"
, 
"no_data"
, 
"error"
。
t[]
UTC时间戳（秒级，非毫秒）。
o[]
, 
h[]
, 
l[]
, 
c[]
按索引对齐的OHLC数据。
v[]
成交量（指数通常为0）。

Datos devueltos por 
bond-info

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]
:
CampoTipoDescripcion
ley
stringJurisdiccion aplicable: 
Nacional
, 
Extranjera
, 
Nueva York
, 
Inglaterra
. Critico para distinguir AL30 (ley local) de GD30 (ley NY).
formaAmortizacion
stringTEXTO PLANO con el cronograma de amortizacion (numero de cuotas, periodicidad, fechas, %). Para bullet: 
"Al vencimiento"
.
interes
stringTEXTO PLANO con esquema de devengo de intereses. Para step-up describe cada tramo de tasa. Para CER describe el ajuste por inflacion.
denominacionMinima
intDenominacion minima de emision.
fechaEmision
string
YYYY-MM-DD HH:MM:SS.f
.
fechaVencimiento
string
YYYY-MM-DD HH:MM:SS.f
.
fechaDevenganIntereses
stringFecha inicio devengo (suele estar vacia).
codigoIsin
stringISIN del instrumento.
tipoEspecie
string
Titulos Publicos
, 
Obligaciones Negociables
, 
Letras del Tesoro
.
tipoObligacion
stringClasificacion regulatoria: 
Valores Publicos Nacionales
, 
Provinciales
, 
Corporativos
.
tipoGarantia
string
Comun
, etc.
default
stringEstado de default (vacio si esta al dia).
montoNominal
intMonto nominal total emitido.
montoResidual
intMonto residual actual (post-amortizaciones).
denominacion
stringNombre oficial completo del bono.
insType
string
BOND
.
paisLey
stringPais 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.
返回
{content, data, empty, upgrade}
，其中
data[0]
（存在时）包含债券的技术资料。对于股票、期权或不存在的代码：
data: []
且
empty: true
。
data[0]
的字段：
字段类型描述
ley
string适用司法管辖区：
Nacional
（本国）、
Extranjera
（外国）、
Nueva York
（纽约）、
Inglaterra
（英国）。这是区分AL30（本地法）和GD30（纽约法）的关键。
formaAmortizacion
string纯文本格式的摊销时间表（分期数、周期、日期、比例）。到期一次还本为
"Al vencimiento"
。
interes
string纯文本格式的计息规则。阶梯利率会描述每个利率区间，CER债券会描述通胀调整规则。
denominacionMinima
int最小发行面值。
fechaEmision
string
YYYY-MM-DD HH:MM:SS.f
格式。
fechaVencimiento
string
YYYY-MM-DD HH:MM:SS.f
格式。
fechaDevenganIntereses
string计息起始日（通常为空）。
codigoIsin
string工具的ISIN代码。
tipoEspecie
string
Titulos Publicos
（公共债券）、
Obligaciones Negociables
（公司债券）、
Letras del Tesoro
（国库券）。
tipoObligacion
string监管分类：
Valores Publicos Nacionales
（本国公共债券）、
Provinciales
（省级）、
Corporativos
（公司）。
tipoGarantia
string
Comun
（普通）等。
default
string违约状态（正常时为空）。
montoNominal
int总发行面值。
montoResidual
int当前剩余面值（摊销后）。
denominacion
string债券官方全称。
insType
string
BOND
。
paisLey
string适用法律所属国家。
moneda
string
Dolares
（美元）、
Pesos
（比索）、
Pesos Ajustables por CER
（CER调整比索）、
Dolar Linked
（美元挂钩）。
emisor
string
Gobierno Nacional
（本国政府）、
Provincia de Buenos Aires
（布宜诺斯艾利斯省）、
YPF S.A.
等。

Diferencia entre paneles 
dict
y 
list

面板返回格式：字典与列表的区别

PanelTipo responseEstructura
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
面板返回类型结构
leading-equity
, 
public-bonds
, 
senebi-on
字典
{content: {page_number, page_count, page_size, total_elements_count}, data: [...], empty, upgrade}
cedears
, 
on
, 
cauciones
, 
options
列表直接返回
[item, item, ...]

Flags adicionales

额外标志

FlagDescripcion
--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)
标志描述
--all
强制设置
page_size=5000
，单次请求获取全部数据
--t0
仅返回settlementType=1（CI）的数据
--t1
仅返回settlementType=2（24小时）的数据
--page N
页码（被API忽略——请使用
--all
）
--page-size N
每页条目数（默认：200）
--desde YYYY-MM-DD
起始日期（历史数据）
--hasta YYYY-MM-DD
结束日期（历史数据）
--resolution X
数据周期：
D
, 
W
, 
M
（默认：
D
）
-o archivo.json
将输出保存到文件
-q
/ 
--quiet
静默模式（仅输出JSON）

Rate limiting

请求频率限制

No hay rate limiting documentado. Recomendado:
  • Minimo 0.3 segundos entre requests.
  • El modo 
    all
    usa 
    time.sleep(0.3)
    automaticamente.
无文档说明的请求频率限制，建议：
  • 请求间隔至少0.3秒。
  • all
    模式会自动添加
    time.sleep(0.3)
    。

Manejo de errores

错误处理

StatusCausas tipicas
400Simbolo invalido (sin 
24HS
, ticker desconocido)
401Endpoint inexistente (BYMA usa 401 generico, no 404)
415Content-Type erroneo (POST debe ser 
application/json
)
500Error interno de BYMA
状态码常见原因
400无效代码（未加
24HS
后缀、未知代码）
401端点不存在（BYMA通用返回401，而非404）
415Content-Type错误（POST请求必须为
application/json
）
500BYMA内部错误

Conversion de fechas

日期转换

python
from datetime import datetime, timezone
python
from datetime import datetime, timezone

Unix seconds -> datetime

Unix秒级时间戳 -> datetime

dt = datetime.fromtimestamp(ts, tz=timezone.utc)
dt = datetime.fromtimestamp(ts, tz=timezone.utc)

datetime -> Unix seconds

datetime -> Unix秒级时间戳

ts = int(datetime(2026, 6, 5, tzinfo=timezone.utc).timestamp())

---
ts = int(datetime(2026, 6, 5, tzinfo=timezone.utc).timestamp())

---

Estructura del skill

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.
skills/byma/
├── SKILL.md                          # 本文件（快速指南）
├── references/
│   └── REFERENCE.md                  # 所有端点的完整文档
└── scripts/
    └── fetch_byma.py                 # 主脚本
详细文档： 请查阅references/REFERENCE.md 获取各端点的详尽说明、JSON schema、settlementType/securityType代码、SSL证书处理、分页及技术细节。