Obtiene los datos históricos de rendimiento de un bono específico.
Parámetros
Ticker del bono (ej., “AL30”).
Parámetros de Consulta
Fecha histórica específica en formato YYYY-MM-DD.
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 del bono solicitado (ej., “AL30”).
Serie histórica de rendimientos para el bono solicitado.
Fecha del dato en formato YYYY-MM-DD.
Tasa Interna de Retorno (TIR) expresada como decimal.
Tasa Nominal Anual (TNA) expresada como decimal.
Tasa Efectiva Anual (TEA) expresada como decimal.
Tasa Efectiva Mensual (TEM) expresada como decimal.
Fecha inicial del rango solicitado (YYYY-MM-DD).
Fecha final del rango solicitado (YYYY-MM-DD).
Metadatos de la respuesta.
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
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
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)
Datos de curva de rendimiento históricos obtenidos exitosamente
Serie histórica de rendimientos
