Back to Details

mae

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

MAE — Mercado Abierto Electronico de Argentina

MAE — 阿根廷电子公开市场

Skill para extraer datos de mercado mayorista del MAE via su API publica de market data — sin API key, sin autenticacion.
El MAE es el mercado argentino mayorista donde se negocian:
  • Renta Fija (LECAPs, BONCAPs, BOPREALes, bonos hard dollar, ONs).
  • Cauciones (CAARS pesos, CAUSD dolares por plazo).
  • REPO / Simultaneas (REPO, REPX, SIMU).
  • FOREX mayorista (dolar transferencia, EUR, CNH, GBP).
  • Dolar Diferido a Fix (DDF) — futuros de dolar mensuales.
  • Indice ARS-MAE — referencia del dolar mayorista.
  • Licitaciones primarias de provincias, ONs y Tesoro.
用于通过MAE的公开市场数据API提取批发市场数据的工具（Skill）——无需API密钥，无需认证。
MAE是阿根廷的批发市场，可交易以下品类：
  • 固定收益（LECAPs、BONCAPs、BOPREALes、硬美元债券、ONs）。
  • 回购协议（比索CAARS、美元CAUSD分期限）。
  • REPO / 同步交易（REPO、REPX、SIMU）。
  • 批发市场外汇（转账美元、欧元EUR、人民币CNH、英镑GBP）。
  • 美元延迟固定合约（DDF）——月度美元期货。
  • ARS-MAE指数——批发市场美元参考指标。
  • 省府、ONs及财政部的一级招标。

⚠️ Aviso Legal

⚠️ 法律声明

  • API publica del MAE, sin documentacion oficial. Los endpoints pueden cambiar sin aviso.
  • Respetar terminos de uso del MAE. No hacer mas de 1 req/segundo (no documentado pero razonable).
  • Los datos son delayed (5-15 min en intradia; T-1 en historicos).
  • Para uso comercial intensivo, contactar al MAE para licencias formales.
  • MAE公开API无官方文档，端点可能无预警变更。
  • 遵守MAE使用条款，请求频率不超过1次/秒（无官方规定但属合理范围）。
  • 数据存在延迟（盘中延迟5-15分钟；历史数据为T-1）。
  • 如需商业密集使用，请联系MAE获取正式授权。

Scripts

脚本

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

Uso rapido

快速使用

bash
undefined
bash
undefined

── SNAPSHOTS INTRADIA ──────────────────────────────────────────────────

── 盘中快照 ──────────────────────────────────────────────────

Resumen top 10 de cada categoria (con grafico intradia mini)

各品类Top10汇总（含迷你盘中走势图）

py scripts/fetch_mae.py resumen RF # Renta fija (LECAPs/BONCAPs lideres) py scripts/fetch_mae.py resumen CAU # Cauciones (CAARS/CAUSD) py scripts/fetch_mae.py resumen FOR # FOREX (US$ tran, EUR, etc.) py scripts/fetch_mae.py resumen DDF # Dolar Diferido a Fix (futuros)
py scripts/fetch_mae.py resumen RF # 固定收益（领先的LECAPs/BONCAPs） py scripts/fetch_mae.py resumen CAU # 回购协议（CAARS/CAUSD） py scripts/fetch_mae.py resumen FOR # 外汇（转账美元、欧元等） py scripts/fetch_mae.py resumen DDF # 美元延迟固定合约（期货）

Cotizaciones COMPLETAS del dia (no solo top 10)

当日完整报价（不限于Top10）

py scripts/fetch_mae.py datos RF # ~289 lineas py scripts/fetch_mae.py datos CAU # ~3 lineas py scripts/fetch_mae.py datos FOR # ~14 lineas
py scripts/fetch_mae.py datos RF # ~289行 py scripts/fetch_mae.py datos CAU # ~3行 py scripts/fetch_mae.py datos FOR # ~14行

Volumen por categoria (Renta Fija TRD / PPT / FOREX) con share %

各品类成交量（固定收益TRD / PPT / 外汇）及占比

py scripts/fetch_mae.py volumen ARS # En pesos py scripts/fetch_mae.py volumen USD # En dolares
py scripts/fetch_mae.py volumen ARS # 比索计价 py scripts/fetch_mae.py volumen USD # 美元计价

Indice ARS-MAE actual (PBO + PPN intradia)

当前ARS-MAE指数（盘中PBO + PPN）

py scripts/fetch_mae.py indice-ars
py scripts/fetch_mae.py indice-ars

── MAPA DE PROSPECTOS ──────────────────────────────────────────────────

── 标的图谱 ──────────────────────────────────────────────────

Mapa de titulos por segmento/plazo/moneda

按板块/期限/货币分类的标的图谱

py scripts/fetch_mae.py mapa --segmento BT --plazo 001 --moneda '$' py scripts/fetch_mae.py mapa --segmento BT --plazo 002 --moneda D py scripts/fetch_mae.py mapa --segmento PPT --plazo 001 --moneda '$'
py scripts/fetch_mae.py mapa --segmento BT --plazo 001 --moneda '$' py scripts/fetch_mae.py mapa --segmento BT --plazo 002 --moneda D py scripts/fetch_mae.py mapa --segmento PPT --plazo 001 --moneda '$'

── INSTITUCIONAL ───────────────────────────────────────────────────────

── 机构信息 ───────────────────────────────────────────────────────

Comunicados (sin filtro: ultimos 60; con filtro: rango especifico)

公告（无筛选：最近60条；带筛选：指定时间范围）

py scripts/fetch_mae.py comunicados py scripts/fetch_mae.py comunicados --desde 2026-05-05 --hasta 2026-06-05
py scripts/fetch_mae.py comunicados py scripts/fetch_mae.py comunicados --desde 2026-05-05 --hasta 2026-06-05

Calendario de licitaciones proximas

upcoming一级招标日历

py scripts/fetch_mae.py licitaciones
py scripts/fetch_mae.py licitaciones

Licitaciones DETALLADAS filtradas por estado

按状态筛选的详细招标信息

py scripts/fetch_mae.py licitaciones-estado --estado A --desde 2026-05-05 --hasta 2026-06-05 py scripts/fetch_mae.py licitaciones-estado --estado F --desde 2026-05-05 --hasta 2026-06-05 py scripts/fetch_mae.py licitaciones-estado --estado P --desde 2026-05-05 --hasta 2026-06-05
py scripts/fetch_mae.py licitaciones-estado --estado A --desde 2026-05-05 --hasta 2026-06-05 py scripts/fetch_mae.py licitaciones-estado --estado F --desde 2026-05-05 --hasta 2026-06-05 py scripts/fetch_mae.py licitaciones-estado --estado P --desde 2026-05-05 --hasta 2026-06-05

── CURVAS RENTA FIJA ───────────────────────────────────────────────────

── 固定收益曲线 ───────────────────────────────────────────────────

Flujo fondos cotizaciones (precio + TIR + MD + cashflows futuros)

资金流报价（价格 + 内部收益率TIR + 修正久期MD + 未来现金流）

py scripts/fetch_mae.py flujo-fondos H # Bonos hard dollar (AE38, etc.) py scripts/fetch_mae.py flujo-fondos B # BOPREALes serie 1
py scripts/fetch_mae.py flujo-fondos H # 硬美元债券（如AE38） py scripts/fetch_mae.py flujo-fondos B # BOPREALes系列1

── HISTORICOS ──────────────────────────────────────────────────────────

── 历史数据 ──────────────────────────────────────────────────────────

Historico renta fija (grid + chart)

固定收益历史数据（表格 + 图表）

py scripts/fetch_mae.py hist-rf --desde 2026-05-05 --hasta 2026-06-04
py scripts/fetch_mae.py hist-rf --desde 2026-05-05 --hasta 2026-06-04

Historico FOREX (por dia con detalle de cada moneda/plazo)

外汇历史数据（按日，含各货币/期限详情）

py scripts/fetch_mae.py hist-forex --desde 2026-05-05 --hasta 2026-06-05
py scripts/fetch_mae.py hist-forex --desde 2026-05-05 --hasta 2026-06-05

Volumen FOREX por dia (sin detalle)

外汇日成交量（无详情）

py scripts/fetch_mae.py hist-forex-vol --desde 2026-05-05 --hasta 2026-06-05
py scripts/fetch_mae.py hist-forex-vol --desde 2026-05-05 --hasta 2026-06-05

Historico cauciones agrupado por dia

按日汇总的回购协议历史数据

py scripts/fetch_mae.py hist-cau --desde 2026-05-05 --hasta 2026-06-05
py scripts/fetch_mae.py hist-cau --desde 2026-05-05 --hasta 2026-06-05

Serie de tasas + volumen de UNA caucion especifica (titulo + plazo)

单一回购协议的利率 + 成交量序列（标的 + 期限）

py scripts/fetch_mae.py hist-cau-vt --titulo CAARS --plazo 001 --desde 2026-05-05 --hasta 2026-06-05 py scripts/fetch_mae.py hist-cau-vt --titulo CAUSD --plazo 001 --desde 2026-05-05 --hasta 2026-06-05
py scripts/fetch_mae.py hist-cau-vt --titulo CAARS --plazo 001 --desde 2026-05-05 --hasta 2026-06-05 py scripts/fetch_mae.py hist-cau-vt --titulo CAUSD --plazo 001 --desde 2026-05-05 --hasta 2026-06-05

Historico REPO con detalle por rueda (REPO, REPX, SIMU)

含轮次详情的REPO历史数据（REPO、REPX、SIMU）

py scripts/fetch_mae.py hist-repo --desde 2026-05-05 --hasta 2026-06-05
py scripts/fetch_mae.py hist-repo --desde 2026-05-05 --hasta 2026-06-05

Volumen y tasa PP REPO por fecha (sin detalle por rueda)

按日期统计的REPP成交量及利率（无轮次详情）

py scripts/fetch_mae.py repo-fecha --desde 2026-05-05 --hasta 2026-06-05
py scripts/fetch_mae.py repo-fecha --desde 2026-05-05 --hasta 2026-06-05

Indice ARS-MAE historico (PPN al cierre por dia)

ARS-MAE指数历史数据（每日收盘PPN）

py scripts/fetch_mae.py indice-ars-hist --desde 2026-05-05 --hasta 2026-06-05
py scripts/fetch_mae.py indice-ars-hist --desde 2026-05-05 --hasta 2026-06-05

── COMBINADOS ──────────────────────────────────────────────────────────

── 组合查询 ──────────────────────────────────────────────────────────

Todos los snapshots (resumen + datos + volumen + indice + comunicados + licitaciones + flujos)

所有快照（汇总 + 数据 + 成交量 + 指数 + 公告 + 招标 + 资金流）

py scripts/fetch_mae.py all
py scripts/fetch_mae.py all

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

── 输出 ─────────────────────────────────────────────────────────────

Guardar a archivo

保存至文件

py scripts/fetch_mae.py resumen RF -o resumen_rf.json py scripts/fetch_mae.py all -o snapshot.json
py scripts/fetch_mae.py resumen RF -o resumen_rf.json py scripts/fetch_mae.py all -o snapshot.json

Modo silencioso (solo JSON, sin logs)

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

py scripts/fetch_mae.py resumen RF -q

---
py scripts/fetch_mae.py resumen RF -q

---

Endpoints disponibles

可用端点

ModoDataEndpoint
resumen <tipo>
Top 10 titulos lideres + mini-grafico intradia
/api/mercado/resumen/{RF|CAU|FOR|DDF}
datos <tipo>
TODAS las cotizaciones del dia (~289 lineas en RF)
/api/mercado/datos/{RF|CAU|FOR}
volumen <moneda>
Volumen por categoria de mercado con share %
/api/mercado/volumen-categoria/{ARS|USD}
mapa
Mapa de prospectos por segmento/plazo/moneda
/api/mercado/mapa?oTitulo={...}
comunicados
Comunicados institucionales del MAE
/api/institucional/comunicados[?oTitulo={...}]
licitaciones
Calendario de licitaciones primarias proximas
/api/mercado/licitaciones
licitaciones-estado
Licitaciones detalladas por estado y rango
/api/mercado/licitacionesporestado/Todos?oTitulo={...}
flujo-fondos <letra>
Cashflows + precio + TIR + MD para curvas RF
/api/emisiones/flujofondoscotiz/{B|H}
hist-rf
Historico renta fija por rango
/api/mercado/titulo/historicorentafija?oTitulo={...}
hist-forex
Historico FOREX por rango (con detalle)
/api/mercado/titulo/historicoforex?oTitulo={...}
hist-forex-vol
Solo volumen total FOREX por dia
/api/mercado/titulo/historicoforex/volumenoperado?oTitulo={...}
hist-cau
Historico cauciones por rango
/api/mercado/titulo/historicocauciones?oTitulo={...}
hist-cau-vt
Series de tasa y volumen para 1 caucion
/api/mercado/cauciones/valorescierre/volumentasas?oTitulo={...}
hist-repo
Historico REPO con detalle por rueda
/api/mercado/titulo/historicorepo?oTitulo={...}
repo-fecha
Volumen + tasaPP REPO por fecha
/api/mercado/repo/titulosfecha?oTitulo={...}
indice-ars
Indice ARS-MAE snapshot intradia (PBO + PPN)
/api/mercado/indiceARS
indice-ars-hist
Serie historica diaria del Indice ARS-MAE
/api/mercado/titulo/indicearsmae/historico?oTitulo={...}
all
Todos los snapshots actuales (sin historicos)(combinado)
Total: 17 endpoints publicos verificados ✅
模式数据内容端点
resumen <tipo>
领先标的Top10 + 迷你盘中走势图
/api/mercado/resumen/{RF|CAU|FOR|DDF}
datos <tipo>
当日所有报价（固定收益约289行）
/api/mercado/datos/{RF|CAU|FOR}
volumen <moneda>
各品类成交量及占比
/api/mercado/volumen-categoria/{ARS|USD}
mapa
按板块/期限/货币分类的标的图谱
/api/mercado/mapa?oTitulo={...}
comunicados
MAE机构公告
/api/institucional/comunicados[?oTitulo={...}]
licitaciones
upcoming一级招标日历
/api/mercado/licitaciones
licitaciones-estado
按状态和时间范围筛选的详细招标信息
/api/mercado/licitacionesporestado/Todos?oTitulo={...}
flujo-fondos <letra>
固定收益曲线的现金流 + 价格 + TIR + MD
/api/emisiones/flujofondoscotiz/{B|H}
hist-rf
指定时间范围的固定收益历史数据
/api/mercado/titulo/historicorentafija?oTitulo={...}
hist-forex
指定时间范围的外汇历史数据（含详情）
/api/mercado/titulo/historicoforex?oTitulo={...}
hist-forex-vol
仅外汇日总成交量
/api/mercado/titulo/historicoforex/volumenoperado?oTitulo={...}
hist-cau
指定时间范围的回购协议历史数据
/api/mercado/titulo/historicocauciones?oTitulo={...}
hist-cau-vt
单一回购协议的利率和成交量序列
/api/mercado/cauciones/valorescierre/volumentasas?oTitulo={...}
hist-repo
含轮次详情的REPO历史数据
/api/mercado/titulo/historicorepo?oTitulo={...}
repo-fecha
按日期统计的REPP成交量 + 利率
/api/mercado/repo/titulosfecha?oTitulo={...}
indice-ars
ARS-MAE指数盘中快照（PBO + PPN）
/api/mercado/indiceARS
indice-ars-hist
ARS-MAE指数每日历史序列
/api/mercado/titulo/indicearsmae/historico?oTitulo={...}
all
当前所有快照（不含历史数据）（组合端点）
总计：已验证17个公开端点 ✅

Categorias soportadas

支持的品类

Tipos validos para 
resumen

resumen
可用类型

TipoDescripcionEjemplo de tickers
RF
Renta Fija
S12J6
(LECAP), 
BPOB7
(BOPREAL), 
AE38
(Bono USD step-up)
CAU
Cauciones
CAARS $ 001
, 
CAUSD D 007
FOR
FOREX
UST$T
(dolar transferencia mayorista), 
EB$T
(Euro billete)
DDF
Dolar Diferido a Fix (futuros)
DLR062026
, 
DLR072026
, 
DLR082026
Cualquier otro tipo (REPO, DLR, RVA, etc.) retorna HTTP 400.
类型描述代码示例
RF
固定收益
S12J6
（LECAP）、
BPOB7
（BOPREAL）、
AE38
（硬美元阶梯利率债券）
CAU
回购协议
CAARS $ 001
、
CAUSD D 007
FOR
外汇
UST$T
（批发市场转账美元）、
EB$T
（现钞欧元）
DDF
美元延迟固定合约（期货）
DLR062026
、
DLR072026
、
DLR082026
其他类型（REPO、DLR、RVA等）将返回HTTP 400。

Tipos validos para 
datos

datos
可用类型

Igual que 
resumen
excepto:
  • DDF
    retorna HTTP 500 (no soportado).
与
resumen
相同，除了：
  • DDF
    返回HTTP 500（不支持）。

Estados validos para 
licitaciones-estado

licitaciones-estado
可用状态

CodigoEstado
A
Activa
F
Finalizada
C
Cancelada
S
Suspendida (suele venir vacio)
P
Programada
Otros codigos (
M
, 
X
, 
N
, 
I
, 
T
, 
Todos
) retornan HTTP 400.
代码状态
A
活跃
F
已完成
C
已取消
S
已暂停（通常为空）
P
已计划
其他代码（
M
、
X
、
N
、
I
、
T
、
Todos
）返回HTTP 400。

Letras validas para 
flujo-fondos

flujo-fondos
可用字母

LetraCategoriaEjemplos
H
Hard dollar step-upAE38, AL30, GD30
B
BOPREALes serie 1BPOB7, BPOD7, BPOC7
Otras letras retornan lista vacia. 
C
retorna HTTP 500.
字母品类示例
H
硬美元阶梯利率债券AE38、AL30、GD30
B
BOPREALes系列1BPOB7、BPOD7、BPOC7
其他字母返回空列表。
C
返回HTTP 500。

Tickers validos para 
hist-cau-vt

hist-cau-vt
可用代码

TickerDescripcion
CAARS
Caucion en pesos
CAUSD
Caucion en dolares
CAU
Aggregated (CAARS + CAUSD)
代码描述
CAARS
比索回购协议
CAUSD
美元回购协议
CAU
汇总（CAARS + CAUSD）

Plazos comunes

常见期限

PlazoDiasDescripcion
000
0CI (Contado Inmediato)
001
124hs
002
248hs
007
77 dias
期限代码天数描述
000
0即时交割（CI）
001
124小时
002
248小时
007
77天

Monedas

货币代码

CodigoDescripcion
$
Pesos argentinos
D
Dolar Bilateral D (similar MEP)
T
Dolar transferencia mayorista
C
Dolar Cable (CCL)
代码描述
$
阿根廷比索
D
双边美元D（类似MEP）
T
批发市场转账美元
C
电缆美元（CCL）

Segmentos comunes (mercado/mapa)

常见板块（市场/图谱）

CodigoDescripcion
BT
Bilateral TRD
PPT
Plazo Pesos Transferible
PT
Plazo Transferible
BL
Bilateral
TX
Tomador/Colocador
RV
Renta Variable
EX
Extranjeras (Cedears, ADRs)
代码描述
BT
双边TRD
PPT
可转让比索期限
PT
可转让期限
BL
双边
TX
借入方/贷出方
RV
可变收益
EX
境外标的（Cedears、ADRs）

Consideraciones tecnicas

技术说明

Datos devueltos por 
resumen

resumen
返回数据

Cada item:
CampoTipoDescripcion
ticker
stringCodigo del titulo
tipoEmision
string
TPN
, 
TPP
, 
ON
, 
CAU
, 
FOR
, 
DDF
descripcion
stringDescripcion humana
plazo
stringCodigo de plazo
fechaLiquidacion
string|nullISO8601
moneda
string
$
, 
D
, 
T
, 
C
segmento
stringCodigo de segmento
variacion
floatVariacion % vs cierre anterior
ultimo
floatUltimo precio operado
cantidad
floatCantidad nominal
monto
floatMonto efectivo
datosGrafico.precios[]
listSerie intradia 
{time: unix_ts_s, value: float}
datosGrafico.volumenes[]
listSerie intradia de volumenes
每个条目包含：
字段类型描述
ticker
string标的代码
tipoEmision
string
TPN
、
TPP
、
ON
、
CAU
、
FOR
、
DDF
descripcion
string人工可读描述
plazo
string期限代码
fechaLiquidacion
string|nullISO8601格式
moneda
string
$
、
D
、
T
、
C
segmento
string板块代码
variacion
float较前收盘价涨跌幅（%）
ultimo
float最新成交价
cantidad
float名义数量
monto
float实际金额
datosGrafico.precios[]
list盘中价格序列 
{time: unix时间戳(秒), value: float}
datosGrafico.volumenes[]
list盘中成交量序列

Datos devueltos por 
datos

datos
返回数据

Mismo schema que 
resumen
mas:
CampoTipoDescripcion
volumen
floatCantidad nominal negociada
codigoSegmento
stringCodigo corto del segmento
ultimaTasa
floatSolo cauciones/REPO (en bonos = 0)
cierreAnterior
floatPrecio o tasa cierre anterior
minimo
, 
maximo
floatRango del dia
openInterest
floatSolo DDF/REPO
precioCierre
, 
precioApertura
float|nullOpen/Close del dia
Y NO incluye 
datosGrafico
(eso es exclusivo de 
resumen
).
与
resumen
schema相同，新增：
字段类型描述
volumen
float已交易名义数量
codigoSegmento
string板块短代码
ultimaTasa
float仅回购协议/REPO可用（债券为0）
cierreAnterior
float前收盘价或利率
minimo
, 
maximo
float当日价格区间
openInterest
float仅DDF/REPO可用
precioCierre
, 
precioApertura
float|null当日开盘/收盘价
不包含
datosGrafico
（该字段仅
resumen
提供）。

Datos devueltos por 
volumen

volumen
返回数据

CampoDescripcion
nombre
Nombre corto categoria
descripcion
Descripcion larga
volumen
Volumen del dia
share
Share % dentro del grupo
grupo
Contado
, 
Monedas
moneda
ARS
o 
USD
orden
Orden de display
字段描述
nombre
品类简称
descripcion
品类全称
volumen
当日成交量
share
在组内的占比（%）
grupo
Contado
（即期）、
Monedas
（货币）
moneda
ARS
或
USD
orden
显示顺序

Datos devueltos por 
licitaciones

licitaciones
返回数据

json
{
  "timeZone": "UTC",
  "events": [
    {"id": -621, "title": "...", "start": "...", "end": "..."}
  ]
}
json
{
  "timeZone": "UTC",
  "events": [
    {"id": -621, "title": "...", "start": "...", "end": "..."}
  ]
}

Datos devueltos por 
licitaciones-estado

licitaciones-estado
返回数据

Cada licitacion incluye 30+ campos: 
titulo
, 
emisor
, 
industria
, 
moneda
, 
ampliableHasta
, 
variableLicitar
, 
montoaLicitar
, 
rueda
, 
modalidad
, 
liquidador
, 
estado
, 
tipo
, 
colocador
, 
observaciones
, 
monto_Adjudicado
, 
sistema_Adjudicacion
, 
valor_Corte
, 
duration
, 
fechaModificacion
, 
plazoEspecie
, 
archivos[]
.
每个招标包含30+字段：
titulo
（标题）、
emisor
（发行方）、
industria
（行业）、
moneda
（货币）、
ampliableHasta
（可延期至）、
variableLicitar
（招标变量）、
montoaLicitar
（招标金额）、
rueda
（轮次）、
modalidad
（模式）、
liquidador
（清算方）、
estado
（状态）、
tipo
（类型）、
colocador
（承销方）、
observaciones
（备注）、
monto_Adjudicado
（中标金额）、
sistema_Adjudicacion
（中标系统）、
valor_Corte
（ cutoff值）、
duration
（期限）、
fechaModificacion
（修改日期）、
plazoEspecie
（标的期限）、
archivos[]
（文件）。

Datos devueltos por 
flujo-fondos

flujo-fondos
返回数据

Cada bono:
CampoDescripcion
especie
Ticker del bono
descripcion
Descripcion humana
moneda
D
(dolar) o 
$
precio
Precio actual cotizacion
tir
TIR anual (%)
md
Modified Duration (años)
detalle[]
Lista de cashflows futuros: 
fechaPago
, 
vr
, 
vrCartera
, 
cashFlow
, 
renta
, 
amortizacion
, 
amasR
每个债券包含：
字段描述
especie
债券代码
descripcion
人工可读描述
moneda
D
（美元）或
$
（比索）
precio
当前报价
tir
年内部收益率（%）
md
修正久期（年）
detalle[]
未来现金流列表：
fechaPago
（支付日期）、
vr
、
vrCartera
、
cashFlow
（现金流）、
renta
（利息）、
amortizacion
（摊销）、
amasR

Datos devueltos por 
hist-cau-vt

hist-cau-vt
返回数据

json
{
  "tasa": [{"time": 1779840000, "value": 19.8849}, ...],
  "volumen": [{"time": 1779840000, "value": 3079030400000.0}, ...]
}
time
esta en segundos UTC (no milisegundos).
json
{
  "tasa": [{"time": 1779840000, "value": 19.8849}, ...],
  "volumen": [{"time": 1779840000, "value": 3079030400000.0}, ...]
}
time
为UTC秒级时间戳（非毫秒）。

Datos devueltos por 
hist-repo

hist-repo
返回数据

Por dia, con 
details[]
que incluye un item por rueda:
CampoDescripcion
rueda
REPO
, 
REPX
, 
SIMU
tasaApertura
, 
ultimaTasa
Tasa apertura / cierre del dia
tasaMaximo
, 
tasaMinimo
Maximo y minimo del dia
cierreAyer
Cierre del dia anterior
cantidad
, 
volumen
Cantidad nominal y volumen efectivo
tasaPP
Tasa promedio ponderada
variacion
Variacion vs cierre anterior
cantOperaciones
Numero de operaciones
plazo
, 
segmento
Plazo y segmento
按日统计，
details[]
包含每轮次的条目：
字段描述
rueda
REPO
、
REPX
、
SIMU
tasaApertura
, 
ultimaTasa
当日开盘/收盘利率
tasaMaximo
, 
tasaMinimo
当日利率区间
cierreAyer
前一日收盘价
cantidad
, 
volumen
名义数量及实际成交量
tasaPP
加权平均利率
variacion
较前收盘价涨跌幅
cantOperaciones
交易次数
plazo
, 
segmento
期限及板块

Flags adicionales

额外参数

FlagDescripcion
--desde YYYY-MM-DD
Fecha desde (requerida en historicos y 
licitaciones-estado
)
--hasta YYYY-MM-DD
Fecha hasta (requerida en historicos y 
licitaciones-estado
)
--segmento <COD>
Segmento para 
mapa
(default: 
BT
)
--plazo <COD>
Plazo (default: 
001
)
--moneda <COD>
Moneda para 
mapa
(default: 
$
)
--estado <COD>
Estado para 
licitaciones-estado
(default: 
A
)
--titulo <TICKER>
Ticker para 
hist-cau-vt
(default: 
CAARS
)
--unit <COD>
Unit para 
repo-fecha
(ignorado por la API; default: 
USD
)
-o archivo.json
Guardar output a archivo JSON
-q
/ 
--quiet
Modo silencioso (solo JSON, sin logs)
参数描述
--desde YYYY-MM-DD
起始日期（历史数据和
licitaciones-estado
必填）
--hasta YYYY-MM-DD
结束日期（历史数据和
licitaciones-estado
必填）
--segmento <COD>
mapa
的板块参数（默认：
BT
）
--plazo <COD>
期限参数（默认：
001
）
--moneda <COD>
mapa
的货币参数（默认：
$
）
--estado <COD>
licitaciones-estado
的状态参数（默认：
A
）
--titulo <TICKER>
hist-cau-vt
的标的代码参数（默认：
CAARS
）
--unit <COD>
repo-fecha
的单位参数（API忽略；默认：
USD
）
-o archivo.json
将输出保存至JSON文件
-q
/ 
--quiet
静默模式（仅输出JSON，无日志）

Rate limiting

请求频率限制

No hay rate limiting documentado. Se recomienda:
  • Minimo 0.3 segundos entre requests.
  • El modo 
    all
    usa 
    time.sleep(0.3)
    entre cada llamada automaticamente.
无官方文档说明的请求频率限制，建议：
  • 请求间隔至少0.3秒。
  • all
    模式会自动在每次调用间添加
    time.sleep(0.3)
    延迟。

Encoding

编码

Algunos campos texto (titulos de licitaciones, comentarios) tienen caracteres latin-1 que se muestran como 
?
en consola Windows pero se salvan bien con 
json.dumps(..., ensure_ascii=False)
en archivos UTF-8.
部分文本字段（招标标题、备注）包含latin-1字符，在Windows控制台中显示为
?
，但使用
json.dumps(..., ensure_ascii=False)
保存为UTF-8文件时可正常显示。

Manejo de errores

错误处理

StatusCausas tipicas
400Tipo / estado / parametro invalido. Verificar valores soportados arriba.
404Endpoint inexistente. Las paths solo aceptan lo listado en este SKILL.
500Combinacion no soportada (ej: 
datos/DDF
, 
flujo-fondos/C
).
El script captura 
HTTPError
y muestra el body con el mensaje de error.
状态码常见原因
400无效类型/状态/参数，请检查上方支持的取值。
404端点不存在，仅支持本Skill列出的路径。
500不支持的组合（如：
datos/DDF
、
flujo-fondos/C
）。
脚本会捕获
HTTPError
并显示包含错误信息的响应体。

Estructura del skill

Skill结构

skills/mae/
├── SKILL.md                          # Este archivo (guia rapida)
├── references/
│   └── REFERENCE.md                  # Documentacion completa de todos los endpoints
└── scripts/
    └── fetch_mae.py                  # Script principal
Documentacion detallada: Consultar references/REFERENCE.md para documentacion exhaustiva de cada endpoint, schemas JSON, ejemplos, codigos de segmentos/plazos/monedas/ruedas y consideraciones tecnicas.
skills/mae/
├── SKILL.md                          # 本文件（快速指南）
├── references/
│   └── REFERENCE.md                  # 所有端点的完整文档
└── scripts/
    └── fetch_mae.py                  # 主脚本
详细文档： 查看references/REFERENCE.md 获取所有端点的详尽说明、JSON schema、示例、板块/期限/货币/轮次代码及技术注意事项。