Skip to main content
GET
/
api
/
v1
/
bonds
/
yields
/
{symbol}
/
historical
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"
{
  "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
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.doctacapital.com.ar/llms.txt

Use this file to discover all available pages before exploring further.

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