API de Bonos de Docta - Documentación

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
  }
]

GET

api

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

string

default:"AL30"

required

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

Parámetros de Consulta

string

required

Fecha de inicio del rango en formato YYYY-MM-DD.

string

required

Fecha de fin del rango en formato YYYY-MM-DD.

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.

string

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

string

Plazo de liquidación utilizado (ej., “24hs”).

string

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

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

Flujo de Caja de Bonos Calculadora

Introducción

Autenticación

Bonos

FCI

Valor Residual Histórico

Parámetros de Ruta

Parámetros de Consulta

Ejemplo de Solicitud

Respuesta Exitosa

Ejemplo de Respuesta Exitosa

Respuestas de Error

500 Error Interno del Servidor

401 No Autorizado

404 No Encontrado

Notas

Authorizations

Path Parameters

Query Parameters

Response

​Parámetros de Ruta

​Parámetros de Consulta

​Ejemplo de Solicitud

​Respuesta Exitosa

​Ejemplo de Respuesta Exitosa

​Respuestas de Error

​500 Error Interno del Servidor

​401 No Autorizado

​404 No Encontrado

​Notas

Authorizations

Path Parameters

Query Parameters

Response

Parámetros de Ruta

Parámetros de Consulta

Ejemplo de Solicitud

Respuesta Exitosa

Ejemplo de Respuesta Exitosa

Respuestas de Error

500 Error Interno del Servidor

401 No Autorizado

404 No Encontrado

Notas