---
title: "POST /api/v1/analytics/bonds/pricer"
method: POST
path: "/api/v1/analytics/bonds/pricer"
tags: ["Bonds"]
---

# POST /api/v1/analytics/bonds/pricer

`POST /api/v1/analytics/bonds/pricer`

Calcula TIR, TNA, TEM, TNA_30_360, VT, VR, Precio Dirty, Intereses Corridos, de un bono en función de un precio  dirty objetivo, una fecha de concertación y un plazo de liquidación (CI, 24hs, 48hs)

## Request body

- BondPricerRequest
  - `ticker` string, required — El símbolo del bono (ej., "AL30", "GD30")
  - `target` 'price', required — El objetivo del cálculo. Debe ser "price" para calcular métricas basadas en un precio objetivo
  - `value` number, required — El precio objetivo del bono
  - `settlement_entry` 'C.I' | '24hs' | '48hs', required — El tipo de liquidación. Puede ser "24hs" para liquidación en 24 horas, "48hs" para liquidación en 48 horas o "C.I" para contado inmediato
  - `operation_date` string, date, required — La fecha de operación en formato YYYY-MM-DD

## Response `200`

Métricas de pricing calculadas exitosamente

- BondPricerResponse
  - `clean_price` number, required — Precio limpio del bono (sin intereses devengados)
  - `dirty_price` number, required — Precio sucio del bono (incluyendo intereses devengados)
  - `residual_value` number, required — Valor residual del bono
  - `tv` number, required — Valor técnico del bono
  - `accured_interest` number, required — Interés devengado acumulado
  - `days_to_maturity` integer, required — Días hasta el vencimiento del bono
  - `settlment_date` string, date, required — Fecha de liquidación en formato YYYY-MM-DD
  - `parity_price` number, required — Precio de paridad del bono
  - `tir` number, required — Tasa Interna de Retorno (TIR) del bono
  - `tea` number, required — Tasa Efectiva Anual (TEA) del bono
  - `tem` number, required — Tasa Efectiva Mensual (TEM) del bono
  - `tna` number, required — Tasa Nominal Anual (TNA) del bono
  - `tna_30_360` number, required — Tasa Nominal Anual calculada con base 30/360
  - `margen` number, required — Margen del bono
  - `duration` number, required — Duración del bono (medida de sensibilidad del precio a cambios en la tasa de interés)
  - `badlar_last5` number, required — Promedio de la tasa BADLAR de los últimos 5 días

## Other responses

- `400` — Solicitud incorrecta - parámetros inválidos o faltantes
- `401` — No autorizado - token de acceso inválido o faltante
- `404` — Ticker no encontrado
- `500` — Error interno del servidor

---

[API](https://skmtc.net/doctacapital/apis/api-de-bonos-de-docta.md) · [All operations](https://skmtc.net/doctacapital/apis/api-de-bonos-de-docta/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/doctacapital/api-de-bonos-de-docta/revisions/49378395cd14/schema)