---
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`

## Request

- Base URL: `https://api.doctacapital.com.ar`
- URL: `https://api.doctacapital.com.ar/api/v1/analytics/bonds/pricer`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/doctacapital/apis/api-de-bonos-de-docta/docs/api/v1/analytics/bonds/pricer/post.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/doctacapital/apis/api-de-bonos-de-docta.md) - [All operations](https://skmtc.dev/doctacapital/apis/api-de-bonos-de-docta/llms.txt) - [OpenAPI document](https://skmtc.dev/doctacapital/apis/api-de-bonos-de-docta/revisions/49378395cd14?raw)