mae

MAE — アルゼンチンの電子公開市場

MAE の公開マーケットデータ APIを使って、ホールセール市場データを取得するスキルです。API キーも認証も不要です。

MAE は、以下の取引が行われるアルゼンチンのホールセール市場です。

• 固定利付債（LECAPs、BONCAPs、BOPREALes、ハードドル建て債券、ONs）。
• カウシオネス（期間別のペソ建て CAARS、ドル建て CAUSD）。
• REPO／同時売買（REPO、REPX、SIMU）。
• ホールセール FOREX（電信送金ドル、EUR、CNH、GBP）。
• Dólar Diferido a Fix（DDF） — 月次ドル先物。
• ARS-MAE 指数 — ホールセールドルの基準値。
• 州、ONs、財務省の新発債入札。

---

⚠️ 法的注意事項

• MAE の公開 API です。公式ドキュメントはありません。エンドポイントは予告なく変更される場合があります。
• MAE の利用規約を遵守してください。1 秒あたり 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（USD 建てステップアップ債）
CAU	カウシオネス	CAARS $ 001、CAUSD D 007
FOR	FOREX	UST$T（ホールセール電信送金ドル）、EB$T（ユーロ紙幣）
DDF	Dólar Diferido a Fix（先物）	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	ハードダラーのステップアップ	AE38、AL30、GD30
B	BOPREAL シリーズ 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 と同じスキーマに加えて、以下が含まれます。

フィールド	型	説明
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コンソールでは ? と表示されることがありますが、UTF-8ファイルには json.dumps(..., ensure_ascii=False) を使って正しく保存できます。

エラー処理

ステータス	典型的な原因
400	無効な種類／状態／パラメーター。上記のサポート対象値を確認してください。
404	エンドポイントが存在しません。パスとして指定できるのは、このSKILLに記載されているもののみです。
500	サポートされていない組み合わせ（例：datos/DDF、flujo-fondos/C）。

スクリプトは HTTPError を捕捉し、エラーメッセージを含む本文を表示します。

---

スキルの構成

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

---

詳細なドキュメント： 各エンドポイント、JSONスキーマ、例、 セグメント／期間／通貨／取引セッションのコード、技術上の注意事項については、references/REFERENCE.md を参照してください。