Cómo acceder a la API de Bonos de Docta

En esta guía te mostramos cómo obtener tus credenciales y hacer tu primer request a la API de Bonos de Docta. En 5 minutos vas a tener todo configurado para integrar datos de bonos locales en cualquiera sistema: Excel, Power BI, Tableau, Python, o cualquier herramienta que pueda hacer requests HTTP.

Antes de empezar

Solo necesitás una cuenta en Docta. El plan gratuito incluye 10 requests por día, suficiente para probar todos los endpoints y validar que la API cubre tu caso de uso.

Paso 1: Crear tu cuenta

Ingresá a doctacapital.com.ar/auth y completá el registro con tu email.

Paso 2: Acceder a la sección API

Una vez dentro del dashboard, hacé click en tu cuenta (abajo a la izquierda) y seleccioná la sección API.

Paso 3: Generar credenciales

Hacé click en "Generar credenciales". El sistema te va a dar dos valores:

• client_id — Identificador de tu aplicación
• client_secret — Tu clave secreta (solo se muestra una vez)

⚠️ Importante: Guardá el client_secret en un lugar seguro ya que solo se muestra una vez luego de generarlo.

Paso 4: Obtener el access token

La API usa OAuth2. Antes de consultar cualquier endpoint, necesitás intercambiar tus credenciales por un token de acceso.

Request de autenticación

POST https://api.doctacapital.com.ar/api/v1/auth/token
Content-Type: application/json

{
  "grant_type": "client_credentials",
  "client_id": "TU_CLIENT_ID",
  "client_secret": "TU_CLIENT_SECRET"
}

Respuesta

{
  "access_token": "eyJhbGciOiJIUzI1NiIs...",
  "token_type": "Bearer",
  "expires_in": 3600
}

Usalo en el header Authorization: Bearer <token> en todos los requests siguientes.

Paso 5: Hacer tu primer request

Por ejemplo, podes probar con la calculadora de bonos. Este endpoint te devuelve todas las métricas de un bono dado un precio, fecha de concertación y período de liquidación.

Ejemplo: Calcular métricas del AL30D

POST https://api.doctacapital.com.ar/api/v1/analytics/bonds/pricer
Authorization: Bearer <tu_access_token>
Content-Type: application/json

{
  "ticker": "AL30D",
  "target": "price",
  "value": 65,
  "settlement_entry": "24hs",
  "operation_date": "2025-11-19"
}

Respuesta

{
  "clean_price": 80.98082191780821,
  "dirty_price": 65,
  "residual_value": 80,
  "tv": 80.21534246575342,
  "accured_interest": 0.2153424657534247,
  "days_to_maturity": 1692,
  "settlment_date": "2025-11-20",
  "price_variation": -0.0030674846625767306,
  "parity_price": 0.810318799396146,
  "tir": 0.11069396742091445,
  "tea": 0.11069396742091445,
  "tem": 0.00878713349566751,
  "tna": 0.13523337986308834,
  "tna_30_360": 0.10544560194801011,
  "duration": 2.1655192047684135
}

Parámetros de la calculadora

Parámetro	Descripción
ticker	Símbolo del bono (ej: AL30D, GD30D, TX26)
target	Siempre "price" para calcular desde un precio
value	Precio dirty del bono
settlement_entry	Período de liquidación: "C.I", "24hs" o "48hs"
operation_date	Fecha de concertación (YYYY-MM-DD). Acepta fechas históricas.

Otros endpoints disponibles

• GET /bonds/instruments — Lista completa de bonos disponibles
• GET /bonds/instruments/{ticker} — Detalle de un bono específico
• GET /bonds/yields/intraday — Yields actualizados durante la rueda
• GET /bonds/yields/historical — Series históricas de yields por segmento
• GET /bonds/cashflow/{ticker} — Flujos de fondos proyectados

Consultá la documentación completa para ver más información de cada endpoint.

Tips de seguridad

• Guardá el client_secret en un gestor de secretos (1Password, Bitwarden, AWS Secrets Manager)
• No incluyas credenciales en código fuente ni repositorios
• Si sospechás que tus credenciales se filtraron, generá nuevas credenciales desde tu cuenta
• Usá variables de entorno para manejar credenciales en tus scripts

¿Necesitás más requests?

El plan gratuito tiene un límite de 10 requests por día. Si necesitás integrar la API en producción (reportes automáticos, dashboards, sistemas internos), el plan Pro te da requests ilimitados. Contactanos para más información.