API de Bonos de Docta - Documentación

curl -X GET "https://api.doctacapital.com.ar/api/v1/bonds/analytics/AL30/cashflow?nominal_units=100" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "ticker": "AL30",
  "data": [
    {
      "issue_date": "2020-09-04",
      "payment_date": "2021-07-09",
      "capital": 0.0,
      "interest_rate": 0.13,
      "interest_amount": 0.1101388888888889,
      "residual_value": 100.0,
      "cash_flow": 0.1101388888888889,
      "adj_interest_amount": 0.1101388888888889,
      "adj_capital": 0.0
    },
    {
      "issue_date": "2020-09-04",
      "payment_date": "2025-01-09",
      "capital": 8.0,
      "interest_rate": 0.75,
      "interest_amount": 0.375,
      "residual_value": 88.0,
      "cash_flow": 8.36,
      "adj_interest_amount": 0.36,
      "adj_capital": 8.0
    }
  ],
  "metadata": {
    "subasset_class": "HARD_DOLLAR",
    "nominal_units": 100.0,
    "total_records": 19
  }
}

GET

api

bonds

analytics

{symbol}

cashflow

curl -X GET "https://api.doctacapital.com.ar/api/v1/bonds/analytics/AL30/cashflow?nominal_units=100" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

{
  "ticker": "AL30",
  "data": [
    {
      "issue_date": "2020-09-04",
      "payment_date": "2021-07-09",
      "capital": 0.0,
      "interest_rate": 0.13,
      "interest_amount": 0.1101388888888889,
      "residual_value": 100.0,
      "cash_flow": 0.1101388888888889,
      "adj_interest_amount": 0.1101388888888889,
      "adj_capital": 0.0
    },
    {
      "issue_date": "2020-09-04",
      "payment_date": "2025-01-09",
      "capital": 8.0,
      "interest_rate": 0.75,
      "interest_amount": 0.375,
      "residual_value": 88.0,
      "cash_flow": 8.36,
      "adj_interest_amount": 0.36,
      "adj_capital": 8.0
    }
  ],
  "metadata": {
    "subasset_class": "HARD_DOLLAR",
    "nominal_units": 100.0,
    "total_records": 19
  }
}

Este endpoint obtiene el flujo de caja de un bono específico, incluyendo todos los pagos de capital e intereses.

Parámetros de Ruta

string

default:"AL30"

required

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

Parámetros de Consulta

integer

default:"100"

Unidades nominales para el cálculo. Esto determina el valor nominal de la posición del bono para la cual calcular el flujo de caja.

Ejemplo de Solicitud

curl -X GET "https://api.doctacapital.com.ar/api/v1/bonds/analytics/AL30/cashflow?nominal_units=100" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Respuesta Exitosa

string

El símbolo del bono solicitado.

array

Serie de eventos de flujo de caja del bono.

string

Fecha de emisión del bono (YYYY-MM-DD).

string

Fecha de pago (YYYY-MM-DD).

number

Capital pagado en la fecha.

number

Tasa de interés del período (decimal).

number

Interés pagado en la fecha.

number

Capital remanente luego del pago.

number

Flujo total (capital + interés) en la fecha.

number

Interés ajustado en la fecha.

number

Capital ajustado en la fecha.

object

Metadatos de la respuesta.

string

Sub-clase de activo del bono.

number

Unidades nominales usadas para el cálculo.

number

Cantidad total de registros.

Ejemplo de Respuesta Exitosa

{
  "ticker": "AL30",
  "data": [
    {
      "issue_date": "2020-09-04",
      "payment_date": "2021-07-09",
      "capital": 0.0,
      "interest_rate": 0.13,
      "interest_amount": 0.1101388888888889,
      "residual_value": 100.0,
      "cash_flow": 0.1101388888888889,
      "adj_interest_amount": 0.1101388888888889,
      "adj_capital": 0.0
    },
    {
      "issue_date": "2020-09-04",
      "payment_date": "2025-01-09",
      "capital": 8.0,
      "interest_rate": 0.75,
      "interest_amount": 0.375,
      "residual_value": 88.0,
      "cash_flow": 8.36,
      "adj_interest_amount": 0.36,
      "adj_capital": 8.0
    }
  ],
  "metadata": {
    "subasset_class": "HARD_DOLLAR",
    "nominal_units": 100.0,
    "total_records": 19
  }
}

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 de flujo de caja incluyen todos los pagos hasta el vencimiento del bono
Los montos se calculan basándose en metadata.nominal_units

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

nominal_units

integer

Unidades nominales para el cálculo

Required range: x >= 1

Response

Bond cashflow data successfully retrieved

ticker

string

required

Símbolo del bono

data

any[]

required

Lista de flujos de caja del bono

metadata

any

required

Yields históricos Valor Residual Histórico

Introducción

Autenticación

Bonos

FCI

Flujo de Caja de Bonos

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