API de Bonos de Docta - Documentación

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

string

required

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

string

required

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

number

required

El precio objetivo del bono.

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.

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

number

Precio limpio del bono (sin intereses devengados).

number

Precio sucio del bono (incluyendo intereses devengados).

number

Valor residual del bono.

number

Valor técnico del bono.

number

Interés devengado.

integer

Días hasta el vencimiento del bono.

string

Fecha de liquidación en formato YYYY-MM-DD.

number

Paridad del bono.

number

Tasa Interna de Retorno (TIR) del bono.

number

Tasa Efectiva Anual (TEA) del bono.

number

Tasa Efectiva Mensual (TEM) del bono.

number

Tasa Nominal Anual (TNA) del bono.

number

Tasa Nominal Anual calculada con base 30/360.

number

Margen del bono.

number

Duración del bono.

number

Promedio de la tasa BADLAR de los últimos 5 días.

number

Variación de precio.

number

Precio sucio implícito. Se devuelve en lugar de clean_price, dirty_price y tir cuando se consulta con target: "tir".

number | null

Valor del índice CER a la fecha de liquidación. Solo en bonos ajustados por CER.

number | null

Valor del índice CER a la fecha de emisión. Solo en bonos ajustados por CER.

number | null

Valor UVA a la fecha de liquidación. Solo en bonos ajustados por UVA.

number | null

Valor UVA a la fecha de emisión. Solo en bonos ajustados por UVA.

number | null

Tipo de cambio oficial aplicado. Solo en bonos dollar-linked.

number | null

Dólar MEP aplicado. Solo en bonos en dólares.

La forma de la respuesta depende de target: con target: "price" se devuelven clean_price, dirty_price y tir; con target: "tir" se devuelve market_price en su lugar. Los campos margen y badlar_last5 solo aparecen en bonos de tasa variable (BADLAR/TAMAR), y los campos CER, UVA, tc_oficial y dolar_mep solo cuando aplica el ajuste correspondiente al bono.

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

La forma de la respuesta depende de target: con target='price' se devuelven clean_price, dirty_price y tir; con target='tir' se devuelve market_price en su lugar. margen y badlar_last5 solo aparecen en bonos de tasa variable (BADLAR/TAMAR); los campos CER, UVA, tc_oficial y dolar_mep solo cuando aplica el ajuste del bono.

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

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

price_variation

number

Variación de precio

cer_settlment_date

number

Valor del índice CER a la fecha de liquidación (solo bonos CER)

cer_issue_date

number

Valor del índice CER a la fecha de emisión (solo bonos CER)

uva_settlment_date

number | null

Valor UVA a la fecha de liquidación (solo bonos UVA)

uva_issue_date

number | null

Valor UVA a la fecha de emisión (solo bonos UVA)

tc_oficial

number | null

Tipo de cambio oficial aplicado (solo dollar-linked)

dolar_mep

number | null

Dólar MEP aplicado (solo bonos en dólares)

market_price

number

Precio sucio implícito. Se devuelve en lugar de clean_price/dirty_price/tir cuando target='tir'.

Introducción

Autenticación

Bonos

FCI

Calculadora

Cuerpo de la Solicitud

Ejemplo de Solicitud

Respuesta Exitosa

Ejemplo de Respuesta Exitosa

Respuestas de Error

400 Solicitud Incorrecta

401 No Autorizado

404 No Encontrado

500 Error Interno del Servidor

Notas

Authorizations

Body

Response

​Cuerpo de la Solicitud

​Ejemplo de Solicitud

​Respuesta Exitosa

​Ejemplo de Respuesta Exitosa

​Respuestas de Error

​400 Solicitud Incorrecta

​401 No Autorizado

​404 No Encontrado

​500 Error Interno del Servidor

​Notas

Authorizations

Body

Response

Cuerpo de la Solicitud

Ejemplo de Solicitud

Respuesta Exitosa

Ejemplo de Respuesta Exitosa

Respuestas de Error

400 Solicitud Incorrecta

401 No Autorizado

404 No Encontrado

500 Error Interno del Servidor

Notas