Este endpoint calcula métricas de pricing y análisis de un bono específico basado en parámetros de precio objetivo.
Cuerpo de la Solicitud
El símbolo del bono (ej., “AL30”, “GD30”).
El objetivo del cálculo. Debe ser "price" para calcular métricas basadas en un precio objetivo.
El precio objetivo del bono.
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.
La fecha de operación en formato YYYY-MM-DD (ej., “2025-11-16”).
Ejemplo de Solicitud
curl -X POST "https://api.doctacapital.com.ar/api/v1/analytics/bonds/pricer" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"ticker": "AL30D",
"target": "price",
"value": 65,
"settlement_entry": "24hs",
"operation_date": "2025-11-19"
}'
Respuesta Exitosa
Precio limpio del bono (sin intereses devengados).
Precio sucio del bono (incluyendo intereses devengados).
Días hasta el vencimiento del bono.
Fecha de liquidación en formato YYYY-MM-DD.
Variación del precio respecto al precio dirty del ultimo dia.
Tasa Interna de Retorno (TIR) del bono.
Tasa Efectiva Anual (TEA) del bono.
Tasa Efectiva Mensual (TEM) del bono.
Tasa Nominal Anual (TNA) del bono.
Tasa Nominal Anual calculada con base 30/360.
Promedio de la tasa BADLAR de los últimos 5 días.
Ejemplo de Respuesta Exitosa
{
"clean_price": 80.98082191780821,
"dirty_price": 65,
"residual_value": 80,
"tv": 80.21534246575342,
"accured_interest": 0.2153424657534247,
"days_to_maturity": 1692,
"settlment_date": "2025-11-20",
"price_variation": -0.0030674846625767306,
"parity_price": 0.810318799396146,
"tir": 0.11069396742091445,
"tea": 0.11069396742091445,
"tem": 0.00878713349566751,
"tna": 0.13523337986308834,
"tna_30_360": 0.10544560194801011,
"duration": 2.1655192047684135,
"cer_settlment_date": null,
"cer_issue_date": null,
"tc_oficial": null,
"dolar_mep": null
}
Respuestas de Error
400 Solicitud Incorrecta
Parámetros inválidos o faltantes en el cuerpo de la solicitud.
{
"type": "/errors/bad-request",
"title": "Bad request",
"status": 400,
"detail": "Invalid request parameters",
"correlation_id": "6cd1fd05-63e9-4863-832f-d873e58e9d67"
}
401 No Autorizado
Token de acceso inválido o faltante.
{
"type": "/errors/authentication-required",
"title": "Authorization header missing",
"status": 401,
"detail": "Authorization header missing",
"correlation_id": "d6e20e07-0580-4e2d-9480-00a68c1ae493"
}
404 No Encontrado
Ticker no encontrado.
{
"type": "/errors/not-found",
"title": "Resource not found",
"status": 404,
"detail": "Ticker not found"
}
500 Error Interno del Servidor
Error interno del servidor.
{
"type": "/errors/internal-server-error",
"title": "Internal server error",
"status": 500,
"detail": "Internal server error",
"correlation_id": "6cd1fd05-63e9-4863-832f-d873e58e9d67"
}
Notas
- El campo
target debe ser "price" para calcular métricas basadas en un precio objetivo
- El campo
value representa el precio objetivo del bono
- La fecha de liquidación se calcula automáticamente basándose en
settlement_entry y operation_date
- Todas las tasas están expresadas en formato decimal (ej., 0.573 = 57.3%)
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Parámetros para el cálculo de pricing del bono
El símbolo del bono (ej., "AL30", "GD30")
El objetivo del cálculo. Debe ser "price" para calcular métricas basadas en un precio objetivo
El precio objetivo del bono
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
Available options:
C.I,
24hs,
48hs
La fecha de operación en formato YYYY-MM-DD
Métricas de pricing calculadas exitosamente
Precio limpio del bono (sin intereses devengados)
Precio sucio del bono (incluyendo intereses devengados)
Interés devengado acumulado
Días hasta el vencimiento del bono
Fecha de liquidación en formato YYYY-MM-DD
Variación del precio respecto al valor técnico
Precio de paridad del bono
Tasa Interna de Retorno (TIR) del bono
Tasa Efectiva Anual (TEA) del bono
Tasa Efectiva Mensual (TEM) del bono
Tasa Nominal Anual (TNA) del bono
Tasa Nominal Anual calculada con base 30/360
Duración del bono (medida de sensibilidad del precio a cambios en la tasa de interés)
Promedio de la tasa BADLAR de los últimos 5 días
