/mae

name: mae
description: "Datos de mercado del MAE (Mercado Abierto Electronico de Argentina): renta fija, cauciones, REPO, FOREX, contratos de futuro dolar (DDF), indice ARS-MAE, licitaciones primarias, comunicados institucionales, flujos de fondos para curvas. Sin API key."
license: MIT

MAE — Mercado Abierto Electronico de Argentina

Skill para extraer datos de mercado mayorista del [MAE](https://www.mae.com.ar) 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.

---

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

---

Scripts

| Script | Descripcion | |--------|-------------| | **[fetch_mae.py](./scripts/fetch_mae.py)** | Script principal: todos los endpoints disponibles |

---

Uso rapido

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

---

Endpoints disponibles

| Modo | Data | Endpoint | |------|------|----------| | `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