API de Bonos de Docta - Documentación

Obtiene los datos históricos de rendimiento de un bono específico.

Parámetros

symbol

string

required

Ticker del bono (ej., “AL30”).

Parámetros de Consulta

from_date

string

required

Fecha histórica específica en formato YYYY-MM-DD.

to_date

string

required

Fecha histórica específica en formato YYYY-MM-DD.

Ejemplo de Solicitud

curl -X GET "https://api.doctacapital.com.ar/api/v1/bonds/yields/AL30/historical?from_date=2025-01-01&to_date=2025-01-02" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Respuesta Exitosa

ticker

string

Ticker del bono solicitado (ej., “AL30”).

data

array

Serie histórica de rendimientos para el bono solicitado.

data[].date

string

Fecha del dato en formato YYYY-MM-DD.

data[].tir

number

Tasa Interna de Retorno (TIR) expresada como decimal.

data[].tna

number

Tasa Nominal Anual (TNA) expresada como decimal.

data[].tea

number

Tasa Efectiva Anual (TEA) expresada como decimal.

data[].tem

number

Tasa Efectiva Mensual (TEM) expresada como decimal.

from_date

string

Fecha inicial del rango solicitado (YYYY-MM-DD).

to_date

string

Fecha final del rango solicitado (YYYY-MM-DD).

metadata

object

Metadatos de la respuesta.

metadata.total_records

number

Cantidad total de registros en el período solicitado.

Ejemplo de Respuesta Exitosa

{
  "ticker": "AL30",
  "data": [
    {
      "date": "2025-01-02",
      "tir": 0.107148,
      "tna": 0.136547,
      "tea": 0.107148,
      "tem": 0.008518
    },
    {
      "date": "2025-01-03",
      "tir": 0.106576,
      "tna": 0.135581,
      "tea": 0.106576,
      "tem": 0.008475
    }
  ],
  "from_date": "2025-01-01",
  "to_date": "2025-02-01",
  "metadata": {
    "total_records": 2
  }
}

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

400 Solicitud Incorrecta

Parámetro subasset_class inválido.

{
  "type": "/errors/http-error",
  "title": "subasset_class: Value error, Invalid subasset_class 'FIXED_RATES'. Supported values: BOPREAL, CER, DOLLAR_LINKED, FIXED_RATE, HARD_DOLLAR, ON, ON_BADLAR, ON_DOLLAR_LINKED, ON_TAMAR, SUB_SOBERANO, SUB_SOBERANO_BADLAR, SUB_SOBERANO_CER",
  "status": 400,
  "detail": "subasset_class: Value error, Invalid subasset_class 'FIXED_RATES'. Supported values: BOPREAL, CER, DOLLAR_LINKED, FIXED_RATE, HARD_DOLLAR, ON, ON_BADLAR, ON_DOLLAR_LINKED, ON_TAMAR, SUB_SOBERANO, SUB_SOBERANO_BADLAR, SUB_SOBERANO_CER"
}

400 Fecha Futura

Fecha histórica no puede ser en el futuro.

{
  "type": "/errors/http-error",
  "title": "date: Value error, Historical date must be in the past",
  "status": 400,
  "detail": "date: Value error, Historical date must be in the past"
}

404 No Encontrado

Símbolo/ticker no encontrado o no hay datos disponibles.

{
  "type": "/errors/not-found",
  "title": "Resource not found: /bonds/tir_curve/historical",
  "status": 404,
  "detail": "Resource not found: /bonds/tir_curve/historical",
  "correlation_id": "438caef0-f014-4a80-874c-4d0261ff28a3"
}

Notas

Los datos están disponibles solo para días hábiles (excluyendo fines de semana y feriados)
Las TIR (Tasas Internas de Retorno) se expresan como decimales (ej., 0.104657 = 10.4657%)
La disponibilidad de datos históricos puede variar según la clase de subactivo y el rango de fechas
Los datos incluyen instrumentos específicos con sus respectivos tickers y características financieras

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>

default:2025-01-10

required

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

to_date

string<date>

default:2025-10-10

required

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

Response

Datos de curva de rendimiento históricos obtenidos exitosamente

ticker

string

required

Símbolo del bono

data

any[]

required

Serie histórica de rendimientos

from_date

string<date>

required

Fecha inicio del rango

Example:

"2025-01-01"

to_date

string<date>

required

Fecha fin del rango

Example:

"2025-02-01"

metadata

any

required

Introducción

Autenticación

Bonos

Yields históricos

Parámetros

Parámetros de Consulta

Ejemplo de Solicitud

Respuesta Exitosa

Ejemplo de Respuesta Exitosa

Respuestas de Error

500 Error Interno del Servidor

401 No Autorizado

400 Solicitud Incorrecta

400 Fecha Futura

404 No Encontrado

Notas

Authorizations

Path Parameters

Query Parameters

Response

​Parámetros

​Parámetros de Consulta

​Ejemplo de Solicitud

​Respuesta Exitosa

​Ejemplo de Respuesta Exitosa

​Respuestas de Error

​500 Error Interno del Servidor

​401 No Autorizado

​400 Solicitud Incorrecta

​400 Fecha Futura

​404 No Encontrado

​Notas

Authorizations

Path Parameters

Query Parameters

Response

Parámetros

Parámetros de Consulta

Ejemplo de Solicitud

Respuesta Exitosa

Ejemplo de Respuesta Exitosa

Respuestas de Error

500 Error Interno del Servidor

401 No Autorizado

400 Solicitud Incorrecta

400 Fecha Futura

404 No Encontrado

Notas