mae

MAE — 阿根廷电子开放市场

用于提取 MAE 批发市场数据的技能， 通过其公开市场数据 API 获取——无需 API 密钥，无需身份验证。

MAE 是阿根廷的批发市场，交易品种包括：

• 固定收益（LECAPs、BONCAPs、BOPREALes、硬美元债券、ONs）。
• 回购交易（比索 CAARS、按期限划分的美元 CAUSD）。
• REPO / 同步交易（REPO、REPX、SIMU）。
• 批发 FOREX（电汇美元、EUR、CNH、GBP）。
• 美元延期定盘（DDF）——美元月度期货。
• ARS-MAE 指数——批发美元参考指标。
• 省级政府、ONs 和财政部的一级发行招标。

---

⚠️ 法律声明

• MAE 的公开 API，无官方文档。端点可能会在不另行通知的情况下更改。
• 请遵守 MAE 的使用条款。每秒请求不要超过 1 次（虽无文档说明，但这是合理的频率）。
• 数据存在延迟（日内数据延迟 5-15 分钟；历史数据延迟 T-1）。
• 如需高强度商业用途，请联系 MAE 获取正式许可。

---

脚本

脚本	描述
fetch_mae.py	主脚本：所有可用端点

---

快速使用

# ── SNAPSHOTS INTRADIA ──────────────────────────────────────────────────

# Resumen top 10 de cada categoria (con grafico intradia mini)
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)

# Cotizaciones COMPLETAS del dia (no solo top 10)
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

# Volumen por categoria (Renta Fija TRD / PPT / FOREX) con share %
py scripts/fetch_mae.py volumen ARS      # En pesos
py scripts/fetch_mae.py volumen USD      # En dolares

# Indice ARS-MAE actual (PBO + PPN intradia)
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 '$'

# ── INSTITUCIONAL ───────────────────────────────────────────────────────

# Comunicados (sin filtro: ultimos 60; con filtro: rango especifico)
py scripts/fetch_mae.py comunicados
py scripts/fetch_mae.py comunicados --desde 2026-05-05 --hasta 2026-06-05

# Calendario de licitaciones proximas
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

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

# Flujo fondos cotizaciones (precio + TIR + MD + cashflows futuros)
py scripts/fetch_mae.py flujo-fondos H   # Bonos hard dollar (AE38, etc.)
py scripts/fetch_mae.py flujo-fondos B   # BOPREALes serie 1

# ── HISTORICOS ──────────────────────────────────────────────────────────

# Historico renta fija (grid + chart)
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

# Volumen FOREX por dia (sin detalle)
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

# 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

# Historico REPO con detalle por rueda (REPO, REPX, SIMU)
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)
py scripts/fetch_mae.py repo-fecha --desde 2026-05-05 --hasta 2026-06-05

# Indice ARS-MAE historico (PPN al cierre por dia)
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

# ── OUTPUT ─────────────────────────────────────────────────────────────

# Guardar a archivo
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)
py scripts/fetch_mae.py resumen RF -q

---

可用端点

模式	数据	端点
resumen <tipo>	领涨的前 10 个证券 + 日内迷你图表	/api/mercado/resumen/{RF|CAU|FOR|DDF}
datos <tipo>	当日全部报价（RF 约 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	即将举行的一级发行招标日历	/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	按范围查询 FOREX 历史数据（含详细信息）	/api/mercado/titulo/historicoforex?oTitulo={...}
hist-forex-vol	仅查询 FOREX 每日总成交量	/api/mercado/titulo/historicoforex/volumenoperado?oTitulo={...}
hist-cau	按范围查询回购交易历史数据	/api/mercado/titulo/historicocauciones?oTitulo={...}
hist-cau-vt	查询 1 笔回购交易的利率和成交量序列	/api/mercado/cauciones/valorescierre/volumentasas?oTitulo={...}
hist-repo	按交易时段查询详细 REPO 历史数据	/api/mercado/titulo/historicorepo?oTitulo={...}
repo-fecha	按日期查询 REPO 成交量 + tasaPP	/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 个公开端点 ✅

---

支持的类别

resumen 的有效类型

类型	描述	代码示例
RF	固定收益	S12J6（LECAP）、BPOB7（BOPREAL）、AE38（美元阶梯式债券）
CAU	回购交易	CAARS $ 001、CAUSD D 007
FOR	FOREX	UST$T（批发电汇美元）、EB$T（欧元现钞）
DDF	美元延期定盘（期货）	DLR062026、DLR072026、DLR082026

其他任何类型（REPO、DLR、RVA 等）都会返回 HTTP 400。

datos 的有效类型

与 resumen 相同，但：

• DDF 会返回 HTTP 500（不支持）。

licitaciones-estado 的有效状态

代码	状态
A	正常
F	已完成
C	已取消
S	已暂停（通常为空）
P	已安排

其他代码（M、X、N、I、T、Todos）会返回 HTTP 400。

flujo-fondos 的有效字母

字母	类别	示例
H	Hard dollar step-up	AE38、AL30、GD30
B	BOPREALes 第 1 系列	BPOB7、BPOD7、BPOC7

其他字母会返回空列表。C 会返回 HTTP 500。

hist-cau-vt 的有效代码

代码	描述
CAARS	比索质押
CAUSD	美元质押
CAU	聚合（CAARS + CAUSD）

常见期限

期限	天数	描述
000	0	CI（即时交割）
001	1	24 小时
002	2	48 小时
007	7	7 天

货币

代码	描述
$	阿根廷比索
D	双边美元 D（类似 MEP）
T	批发转账美元
C	电汇美元（CCL）

常见细分市场（市场/地图）

代码	描述
BT	双边 TRD
PPT	可转让比索期限
PT	可转让期限
BL	双边
TX	借入方/出借方
RV	浮动收益
EX	外国证券（Cedears、ADR）

---

技术注意事项

resumen 返回的数据

每项：

字段	类型	描述
ticker	string	证券代码
tipoEmision	string	TPN、TPP、ON、CAU、FOR、DDF
descripcion	string	人类可读的描述
plazo	string	期限代码
fechaLiquidacion	string|null	ISO8601
moneda	string	$、D、T、C
segmento	string	细分市场代码
variacion	float	相较前一收盘价的变化百分比
ultimo	float	最新成交价
cantidad	float	名义数量
monto	float	实际金额
datosGrafico.precios[]	list	日内序列 {time: unix_ts_s, value: float}
datosGrafico.volumenes[]	list	日内成交量序列

datos 返回的数据

与 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 独有的）。

volumen 返回的数据

字段	描述
nombre	类别简称
descripcion	详细描述
volumen	当日成交量
share	在组内的占比百分比
grupo	Contado、Monedas
moneda	ARS 或 USD
orden	显示顺序

licitaciones 返回的数据

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

licitaciones-estado 返回的数据

每项招标包含 30 多个字段：titulo、emisor、industria、moneda、 ampliableHasta、variableLicitar、montoaLicitar、rueda、modalidad、 liquidador、estado、tipo、colocador、observaciones、 monto_Adjudicado、sistema_Adjudicacion、valor_Corte、duration、 fechaModificacion、plazoEspecie、archivos[]。

flujo-fondos 返回的数据

每只债券：

字段	描述
especie	债券代码
descripcion	人类可读的描述
moneda	D （美元）或 $
precio	当前报价
tir	年化 TIR（%）
md	修正久期（年）
detalle[]	未来现金流列表：fechaPago、vr、vrCartera、cashFlow、renta、amortizacion、amasR

hist-cau-vt 返回的数据

{
  "tasa": [{"time": 1779840000, "value": 19.8849}, ...],
  "volumen": [{"time": 1779840000, "value": 3079030400000.0}, ...]
}

time 的单位是 UTC 秒（不是毫秒）。

hist-repo 返回的数据

按日返回，包含 details[]，其中每个交易时段对应一个条目：

字段	描述
rueda	REPO、REPX、SIMU
tasaApertura、ultimaTasa	当日开盘利率 / 收盘利率
tasaMaximo、tasaMinimo	当日最高和最低利率
cierreAyer	前一日收盘价
cantidad、volumen	名义数量和实际成交量
tasaPP	加权平均利率
variacion	相较前一日收盘价的变化
cantOperaciones	操作次数
plazo、segmento	期限和细分市场

其他标志

标志	描述
--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，不显示日志）

速率限制

没有文档记录的速率限制。建议：

• 两次请求之间至少间隔 0.3 秒。
• all 模式会在每次调用之间自动执行 time.sleep(0.3)。

编码

某些文本字段（招标标题、评论）包含 latin-1 字符，这些字符在 Windows 控制台中会显示为 ?，但使用 json.dumps(..., ensure_ascii=False) 保存到 UTF-8 文件时不会有问题。

错误处理

状态	常见原因
400	类型 / 状态 / 参数无效。请检查上方列出的受支持值。
404	端点不存在。路径仅接受此 SKILL 中列出的值。
500	不受支持的组合（例如：datos/DDF、flujo-fondos/C）。

脚本会捕获 HTTPError，并显示包含错误消息的响应正文。

---

skill 结构

skills/mae/
├── SKILL.md                          # Este archivo (guia rapida)
├── references/
│   └── REFERENCE.md                  # Documentacion completa de todos los endpoints
└── scripts/
    └── fetch_mae.py                  # Script principal

---

详细文档： 请参阅 references/REFERENCE.md 以了解每个端点、JSON 架构、示例、细分市场/期限/货币/交易时段代码以及技术注意事项的完整文档。