Skip to main content
POST
/
api
/
v1
/
analytics
/
bonds
/
pricer
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"
  }'

{
  "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",
  "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,
  "margen": null,
  "badlar_last5": null
}
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

​
ticker
string
required
El símbolo del bono (ej., “AL30”, “GD30”).
​
target
string
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
string
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
required
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

​
clean_price
number
Precio limpio del bono (sin intereses devengados).
​
dirty_price
number
Precio sucio del bono (incluyendo intereses devengados).
​
residual_value
number
Valor residual del bono.
​
tv
number
Valor técnico del bono.
​
accured_interest
number
Interés devengado.
​
days_to_maturity
integer
Días hasta el vencimiento del bono.
​
settlment_date
string
Fecha de liquidación en formato YYYY-MM-DD.
​
parity_price
number
Paridad del bono.
​
tir
number
Tasa Interna de Retorno (TIR) del bono.
​
tea
number
Tasa Efectiva Anual (TEA) del bono.
​
tem
number
Tasa Efectiva Mensual (TEM) del bono.
​
tna
number
Tasa Nominal Anual (TNA) del bono.
​
tna_30_360
number
Tasa Nominal Anual calculada con base 30/360.
​
margen
number
Margen del bono.
​
duration
number
Duración del bono.
​
badlar_last5
number
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",
  "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,
  "margen": null,
  "badlar_last5": 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%)

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Parámetros para el cálculo de pricing del bono

​
ticker
string
required

El símbolo del bono (ej., "AL30", "GD30")

Example:

"AL30D"

​
target
enum<string>
required

El objetivo del cálculo. Debe ser "price" para calcular métricas basadas en un precio objetivo

Available options:
price
Example:

"price"

​
value
number
required

El precio objetivo del bono

Example:

65

​
settlement_entry
enum<string>
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

Available options:
C.I,
24hs,
48hs
Example:

"24hs"

​
operation_date
string<date>
required

La fecha de operación en formato YYYY-MM-DD

Example:

"2025-11-19"

Response

Métricas de pricing calculadas exitosamente

​
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