Skip to main content
GET
/
api
/
v1
/
bonds
/
analytics
/
{symbol}
/
cashflows
/
residual-value
curl -X GET "https://api.doctacapital.com.ar/api/v1/bonds/analytics/AL30/cashflows/residual-value?from_date=2025-01-01&to_date=2025-01-10&settlement_entry=24hs" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

[
  {
    "operation_date": "2025-01-02",
    "settlement_entry": "24hs",
    "settlement_date": "2025-01-03",
    "residual_value": 96.0
  },
  {
    "operation_date": "2025-01-03",
    "settlement_entry": "24hs",
    "settlement_date": "2025-01-06",
    "residual_value": 96.0
  },
  {
    "operation_date": "2025-01-06",
    "settlement_entry": "24hs",
    "settlement_date": "2025-01-07",
    "residual_value": 96.0
  },
  {
    "operation_date": "2025-01-07",
    "settlement_entry": "24hs",
    "settlement_date": "2025-01-08",
    "residual_value": 96.0
  },
  {
    "operation_date": "2025-01-08",
    "settlement_entry": "24hs",
    "settlement_date": "2025-01-09",
    "residual_value": 96.0
  },
  {
    "operation_date": "2025-01-09",
    "settlement_entry": "24hs",
    "settlement_date": "2025-01-10",
    "residual_value": 88.0
  },
  {
    "operation_date": "2025-01-10",
    "settlement_entry": "24hs",
    "settlement_date": "2025-01-13",
    "residual_value": 88.0
  }
]
Este endpoint obtiene la serie histórica de valor residual de un bono específico, filtrada por rango de fechas y plazo de liquidación.

​
Parámetros de Ruta

​
symbol
string
default:"AL30"
required
El símbolo del bono (ej., “AL30”, “GD30”).

​
Parámetros de Consulta

​
from_date
string
required
Fecha de inicio del rango en formato YYYY-MM-DD.
​
to_date
string
required
Fecha de fin del rango en formato YYYY-MM-DD.
​
settlement_entry
string
required
Plazo de liquidación. Valores posibles: CI (contado inmediato), 24hs (24 horas), 48hs (48 horas), 72hs (72 horas).

​
Ejemplo de Solicitud

curl -X GET "https://api.doctacapital.com.ar/api/v1/bonds/analytics/AL30/cashflows/residual-value?from_date=2025-01-01&to_date=2025-01-10&settlement_entry=24hs" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

​
Respuesta Exitosa

La respuesta es un array de objetos con los valores residuales para cada día hábil del rango solicitado.
​
[].operation_date
string
Fecha de operación en formato YYYY-MM-DD.
​
[].settlement_entry
string
Plazo de liquidación utilizado (ej., “24hs”).
​
[].settlement_date
string
Fecha de liquidación correspondiente en formato YYYY-MM-DD.
​
[].residual_value
number
Valor residual del bono en la fecha de liquidación.

​
Ejemplo de Respuesta Exitosa

[
  {
    "operation_date": "2025-01-02",
    "settlement_entry": "24hs",
    "settlement_date": "2025-01-03",
    "residual_value": 96.0
  },
  {
    "operation_date": "2025-01-03",
    "settlement_entry": "24hs",
    "settlement_date": "2025-01-06",
    "residual_value": 96.0
  },
  {
    "operation_date": "2025-01-06",
    "settlement_entry": "24hs",
    "settlement_date": "2025-01-07",
    "residual_value": 96.0
  },
  {
    "operation_date": "2025-01-07",
    "settlement_entry": "24hs",
    "settlement_date": "2025-01-08",
    "residual_value": 96.0
  },
  {
    "operation_date": "2025-01-08",
    "settlement_entry": "24hs",
    "settlement_date": "2025-01-09",
    "residual_value": 96.0
  },
  {
    "operation_date": "2025-01-09",
    "settlement_entry": "24hs",
    "settlement_date": "2025-01-10",
    "residual_value": 88.0
  },
  {
    "operation_date": "2025-01-10",
    "settlement_entry": "24hs",
    "settlement_date": "2025-01-13",
    "residual_value": 88.0
  }
]

​
Respuestas de Error

​
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"
}

​
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"
}

​
Notas

  • Los datos están disponibles solo para días hábiles (excluyendo fines de semana y feriados)
  • El valor residual refleja el capital remanente del bono luego de cada amortización
  • La fecha de liquidación (settlement_date) se calcula automáticamente según el plazo de liquidación y el calendario de días hábiles

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
symbol
string
required

El símbolo del bono

Query Parameters

​
from_date
string<date>
required

Fecha de inicio del rango (YYYY-MM-DD)

​
to_date
string<date>
required

Fecha de fin del rango (YYYY-MM-DD)

​
settlement_entry
enum<string>
required

Plazo de liquidación: CI (contado inmediato), 24hs, 48hs o 72hs

Available options:
CI,
24hs,
48hs,
72hs

Response

Serie de valores residuales obtenida exitosamente

​
operation_date
string<date>
required

Fecha de operación

​
settlement_entry
string
required

Plazo de liquidación

​
settlement_date
string<date>
required

Fecha de liquidación

​
residual_value
number
required

Valor residual del bono