Traé los datos del tablero a donde los necesites

◈Conectarlo a tu agente (MCP)

El camino más corto: en vez de escribir consultas, le preguntás en castellano a tu propio Claude, Cursor o agente, y él consulta el tablero por vos. Necesitás dos datos: la URL y tu clave de API. Disponible para cuentas plus y admin.

copiarclaude mcp add --transport http curvas https://tu-tablero/api/mcp \
  --header "Authorization: Bearer ck_TU_CLAVE"

copiar{
  "mcpServers": {
    "curvas": {
      "type": "http",
      "url": "https://tu-tablero/api/mcp",
      "headers": { "Authorization": "Bearer ck_TU_CLAVE" }
    }
  }
}

copiarcurl -s -X POST https://tu-tablero/api/mcp \
  -H "Authorization: Bearer ck_TU_CLAVE" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Todo lo que ves es de lectura. Ninguna de las diez tools modifica nada, y tu clave nace de sólo lectura: aunque el agente quisiera, el servidor rechaza cualquier escritura.

El agente no hace las cuentas. Cada respuesta trae la TIR, la TEM y la TNA ya resueltas por el motor de valuación, con la liquidación y el tipo de cambio que se usaron. El agente cita esos números en lugar de derivarlos del precio — que es de dónde salen las tasas inventadas que suenan bien.

Rigen los mismos límites que la API: 120 llamadas por minuto (500 para admin) y 3 IPs por clave. Si además consultás por script, conviene una clave para cada cosa.

Unidades. Las tasas vienen en decimal (0.0868 es 8,68 %), salvo las series del BCRA, que vienen en porcentaje. Los precios son por 100 VN en la moneda de la especie: el ticker en pesos en ARS, la especie D en USD.

→Empezar

Iniciás sesión una vez, guardás la cookie y la mandás en cada consulta. La sesión dura 7 días.

copiarcurl -s -c cookies.txt \
  -X POST https://tu-tablero/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "vos@ejemplo.com", "password": "tu-password"}'

copiarcurl -s -b cookies.txt https://tu-tablero/api/me

⚿Claves de API

Para que un script o una planilla consulten sin iniciar sesión. Las emitís vos, desde tu cuenta, y las revocás cuando quieras. Disponibles para cuentas plus y admin.

copiarcurl -s -b cookies.txt \
  -X POST https://tu-tablero/api/internal/api-keys \
  -H "Content-Type: application/json" \
  -d '{"nombre": "planilla de flujos", "solo_lectura": true}'

copiarcurl -s -H "Authorization: Bearer ck_TU_CLAVE" \
  "https://tu-tablero/api/internal/flujos?ticker=AL30"

copiarcurl -s -b cookies.txt https://tu-tablero/api/internal/api-keys
curl -s -b cookies.txt -X DELETE https://tu-tablero/api/internal/api-keys/EL_ID

La clave actúa como vos: nunca da más permisos que los que tenés en el momento de usarla. Si tu cuenta cambia de rol o se desactiva, deja de funcionar sola, sin revocarla. Por defecto es de sólo lectura; una clave así no puede escribir aunque vos sí puedas.

Límites por clave. 120 llamadas por minuto para cuentas plus y 500 para admin — dos por segundo alcanzan de sobra para cualquier uso normal; el tope existe para que un bucle mal cerrado no se lleve puesto el backend. Al superarlo llega un 429 con Retry-After.

Además, cada clave se puede usar desde hasta 3 IPs distintas por semana (las cuentas admin no tienen este tope). Si tu proceso corre en varios lugares, emití una clave para cada uno: es gratis, te deja revocar sólo el que haga falta, y cada una lleva su propio presupuesto de llamadas.

≢Calculadora: precio ↔ tasa

Le mandás un precio y te devuelve la TIR, la TEM y la TNA. O al revés: le mandás una tasa y te devuelve el precio. Sobre el calendario real del activo, con la fecha de concertación y el T+x hábiles que le indiques.

copiarcurl -s -b cookies.txt -X POST https://tu-tablero/api/rf/calc/tasa \
  -H "Content-Type: application/json" \
  -d '{"ticker": "AL30D", "precio": 55.85, "t_mas": 1}'

copiarcurl -s -b cookies.txt -X POST https://tu-tablero/api/rf/calc/precio \
  -H "Content-Type: application/json" \
  -d '{"ticker": "AL30D", "tasa": 0.0868, "modo": "tir", "t_mas": 1}'

copiarcurl -s -b cookies.txt -X POST https://tu-tablero/api/rf/calc/tasa \
  -H "Content-Type: application/json" \
  -d '{"ticker": "TX28", "precio": 1739.5,
        "fecha_concertacion": "2026-09-22", "t_mas": 2,
        "conv": "30/360"}'

copiarcurl -s -b cookies.txt -X POST https://tu-tablero/api/rf/calc/tasa \
  -H "Content-Type: application/json" \
  -d '{"ticker": "AL30", "precio": 85440, "t_mas": 1}'

Parámetros. ticker es lo único obligatorio además del precio o la tasa. fecha_concertacion por defecto es hoy; t_mas son días hábiles AR (saltea feriados) y por defecto sigue la rueda de 24 hs del tablero; modo acepta tir, tea, tem o tna; conv acepta actual/365 (por defecto), act/360, 30/360 o cualquier días/base.

Qué gobierna la convención. conv cambia cómo se expresa la TNA; no cambia la TIR ni el precio. El descuento es siempre días calendario sobre 365 — el campo base_descuento de la respuesta lo dice explícito. Pedir act/360 esperando que cambie la TIR es el malentendido más fácil de cometer acá.

Precios en pesos de bonos en dólares. Si mandás un AL30 a 120.710 (pesos), el tipo de cambio se aplica solo: la respuesta trae precio (el que mandaste), precio_descuento (el que se usó contra los flujos) y fx_kind/fx_val para que veas cuál se aplicó. Con fx forzás mep, ccl, a3500 o none.

Es el mismo motor que el tablero. Para el mismo papel, el mismo precio y la misma rueda, esta TIR es idéntica a la que ves en pantalla — verificado sobre 971 especies con diferencia exactamente cero.

%Precios y tasas en vivo

El stock de tasas: precio, TIR por punta, TEM, TNA, duration y convexidad de cada bono, con el tipo de cambio ya aplicado.

copiarcurl -s -b cookies.txt \
  "https://tu-tablero/api/rf/tasas?tickers=AL30,GD30,TX28&plazo=24hs"

copiarcurl -s -b cookies.txt \
  "https://tu-tablero/api/rf/tasas/book?tickers=AL30&plazo=24hs"

copiarcurl -s -b cookies.txt \
  "https://tu-tablero/api/rf/tasas/intraday?ticker=AL30&plazo=24hs&limit=500"

≡Flujos de fondos

El calendario de pagos de cada bono: fecha teórica y efectiva, interés, amortización, total y valor residual. Es la fuente que usa la valuación.

copiarcurl -s -b cookies.txt \
  "https://tu-tablero/api/internal/flujos?ticker=AL30"

copiarcurl -s -b cookies.txt https://tu-tablero/api/internal/flujos/tickers

A Google Sheets. Con Apps Script lo traés directo a la hoja:

copiarfunction traerFlujos(ticker) {
  var r = UrlFetchApp.fetch(
    "https://tu-tablero/api/internal/flujos?ticker=" + ticker,
    { headers: { "Authorization": "Bearer ck_TU_CLAVE" } }
  );
  var filas = JSON.parse(r.getContentText());
  var out = [["fecha", "interés", "amortización", "total"]];
  filas.forEach(function (f) {
    out.push([f.fecha_efectiva, f.interes, f.amortizacion, f.total]);
  });
  SpreadsheetApp.getActiveSheet()
    .getRange(1, 1, out.length, 4).setValues(out);
}

◫Condiciones de emisión

El pliego del instrumento: vencimiento, tasa, periodicidad, valor residual, moneda, legislación y jurisdicción de pago.

copiarcurl -s -b cookies.txt https://tu-tablero/api/internal/condiciones/AL30

copiarcurl -s -b cookies.txt \
  "https://tu-tablero/api/internal/condiciones?ticker=TX&limit=50"

$Dólar y tipo de cambio

MEP, CCL, canje, A3500 y la curva de futuros de ROFEX, con su interés abierto.

copiarcurl -s -b cookies.txt https://tu-tablero/api/dolar/contratos

copiarcurl -s -b cookies.txt https://tu-tablero/api/dolar/oi-matrix

⇉Curvas y forwards

La tasa forward implícita entre dos bonos, la matriz completa de un grupo y las pendientes. Acepta bid, offer o mid.

copiarcurl -s -b cookies.txt \
  -X POST https://tu-tablero/api/analysis/forward \
  -H "Content-Type: application/json" \
  -d '{"tickers": ["S30S6", "S29E7"], "tipo_serie": "clean"}'

copiarcurl -s -b cookies.txt \
  -X POST https://tu-tablero/api/analysis/forward-curves \
  -H "Content-Type: application/json" \
  -d '{"tickers": ["S30S6","S16O6","S30O6"]}'

Son POST porque el cuerpo lleva la lista de tickers y los parámetros. No modifican nada: calculan y devuelven.

◎Break-even de flotantes

Qué sendero de TAMAR o BADLAR necesita el mercado para que un flotante cupón cero iguale a una alternativa a tasa fija.

copiarcurl -s -b cookies.txt \
  "https://tu-tablero/api/rf/tamar-be/tabla?modo=curva&tol=0.041&plazo=24hs"

copiarcurl -s -b cookies.txt \
  "https://tu-tablero/api/rf/tamar-be?ticker=TTD26&objetivo=0.3336&precio=169.3"

∿Series del BCRA

Las series oficiales, ya normalizadas. Las más usadas: 44 es TAMAR y 7 es BADLAR.

copiarcurl -s -b cookies.txt \
  "https://tu-tablero/api/bcra/series/44?desde=2026-01-01"

copiarcurl -s -b cookies.txt https://tu-tablero/api/bcra/catalog