Skip to main content
GET
/
api
/
v1
/
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

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

​
Parámetros de Consulta

​
nominal_units
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

​
ticker
string
El símbolo del bono solicitado.
​
data
array
Serie de eventos de flujo de caja del bono.
​
data[].issue_date
string
Fecha de emisión del bono (YYYY-MM-DD).
​
data[].payment_date
string
Fecha de pago (YYYY-MM-DD).
​
data[].capital
number
Capital pagado en la fecha.
​
data[].interest_rate
number
Tasa de interés del período (decimal).
​
data[].interest_amount
number
Interés pagado en la fecha.
​
data[].residual_value
number
Capital remanente luego del pago.
​
data[].cash_flow
number
Flujo total (capital + interés) en la fecha.
​
data[].adj_interest_amount
number
Interés ajustado en la fecha.
​
data[].adj_capital
number
Capital ajustado en la fecha.
​
metadata
object
Metadatos de la respuesta.
​
metadata.subasset_class
string
Sub-clase de activo del bono.
​
metadata.nominal_units
number
Unidades nominales usadas para el cálculo.
​
metadata.total_records
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