API de Docta - Bonos de Argentina, FCI y US Treasuries

curl "https://api.doctacapital.com.ar/api/v1/treasuries/instruments/US91282CMM00" \
  -H "Authorization: Bearer $DOCTA_TOKEN"

{
  "isin": "US91282CMM00",
  "cusip": "91282CMM0",
  "kind": "NOTE",
  "title": {
    "cusip": "91282CMM0",
    "isin": "US91282CMM00",
    "issue_date": "2025-02-18",
    "security_type": "Note",
    "security_term": "10-Year",
    "maturity_date": "2035-02-15",
    "dated_date": "2025-02-15",
    "interest_rate": 4.625,
    "interest_payment_frequency": null,
    "first_interest_payment_date": null,
    "price_per_100": null,
    "high_discount_rate": null,
    "high_investment_rate": null,
    "tips": false,
    "floating_rate": false,
    "cash_management_bill": false,
    "reopening": false,
    "auction_date": null,
    "announcement_date": "2025-02-05"
  },
  "as_of": "2026-11-11",
  "days_to_maturity": 3018,
  "outstanding": true,
  "pay_date": "2035-02-15",
  "coupon": {
    "rate": 4.625,
    "frequency": null,
    "first_payment_date": null,
    "previous_date": "2026-08-15",
    "next_date": "2027-02-15",
    "remaining_payments": 17
  },
  "reopenings": [
    {
      "issue_date": "2025-02-18",
      "security_term": "10-Year",
      "reopening": false,
      "cash_management_bill": false,
      "price_per_100": null,
      "high_discount_rate": null,
      "high_investment_rate": null,
      "auction_date": null,
      "announcement_date": "2025-02-05"
    },
    {
      "issue_date": "2025-03-17",
      "security_term": "9-Year 11-Month",
      "reopening": true,
      "cash_management_bill": false,
      "price_per_100": null,
      "high_discount_rate": null,
      "high_investment_rate": null,
      "auction_date": null,
      "announcement_date": "2025-03-06"
    }
  ]
}

{
  "isin": "US912797VR56",
  "cusip": "912797VR5",
  "kind": "BILL",
  "title": {
    "cusip": "912797VR5",
    "isin": "US912797VR56",
    "issue_date": "2026-08-06",
    "security_type": "Bill",
    "security_term": "52-Week",
    "maturity_date": "2027-08-05",
    "dated_date": null,
    "interest_rate": null,
    "interest_payment_frequency": null,
    "first_interest_payment_date": null,
    "price_per_100": null,
    "high_discount_rate": null,
    "high_investment_rate": null,
    "tips": false,
    "floating_rate": false,
    "cash_management_bill": false,
    "reopening": false,
    "auction_date": null,
    "announcement_date": "2026-07-30"
  },
  "as_of": "2026-11-11",
  "days_to_maturity": 267,
  "outstanding": true,
  "pay_date": "2027-08-05",
  "coupon": null,
  "reopenings": [
    {
      "issue_date": "2026-08-06",
      "security_term": "52-Week",
      "reopening": false,
      "cash_management_bill": false,
      "price_per_100": null,
      "high_discount_rate": null,
      "high_investment_rate": null,
      "auction_date": null,
      "announcement_date": "2026-07-30"
    }
  ]
}

{
  "type": "/errors/not-found",
  "title": "Resource not found",
  "status": 404,
  "detail": "Title not in the Treasury catalog",
  "details": {
    "code": "not_in_catalog",
    "isin": "US0378331005"
  }
}

{
  "type": "/errors/validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "'US91282CMM01' fails the ISIN check digit",
  "details": {
    "code": "invalid_id"
  }
}

GET

api

treasuries

instruments

{id}

curl "https://api.doctacapital.com.ar/api/v1/treasuries/instruments/US91282CMM00" \
  -H "Authorization: Bearer $DOCTA_TOKEN"

{
  "isin": "US91282CMM00",
  "cusip": "91282CMM0",
  "kind": "NOTE",
  "title": {
    "cusip": "91282CMM0",
    "isin": "US91282CMM00",
    "issue_date": "2025-02-18",
    "security_type": "Note",
    "security_term": "10-Year",
    "maturity_date": "2035-02-15",
    "dated_date": "2025-02-15",
    "interest_rate": 4.625,
    "interest_payment_frequency": null,
    "first_interest_payment_date": null,
    "price_per_100": null,
    "high_discount_rate": null,
    "high_investment_rate": null,
    "tips": false,
    "floating_rate": false,
    "cash_management_bill": false,
    "reopening": false,
    "auction_date": null,
    "announcement_date": "2025-02-05"
  },
  "as_of": "2026-11-11",
  "days_to_maturity": 3018,
  "outstanding": true,
  "pay_date": "2035-02-15",
  "coupon": {
    "rate": 4.625,
    "frequency": null,
    "first_payment_date": null,
    "previous_date": "2026-08-15",
    "next_date": "2027-02-15",
    "remaining_payments": 17
  },
  "reopenings": [
    {
      "issue_date": "2025-02-18",
      "security_term": "10-Year",
      "reopening": false,
      "cash_management_bill": false,
      "price_per_100": null,
      "high_discount_rate": null,
      "high_investment_rate": null,
      "auction_date": null,
      "announcement_date": "2025-02-05"
    },
    {
      "issue_date": "2025-03-17",
      "security_term": "9-Year 11-Month",
      "reopening": true,
      "cash_management_bill": false,
      "price_per_100": null,
      "high_discount_rate": null,
      "high_investment_rate": null,
      "auction_date": null,
      "announcement_date": "2025-03-06"
    }
  ]
}

{
  "isin": "US912797VR56",
  "cusip": "912797VR5",
  "kind": "BILL",
  "title": {
    "cusip": "912797VR5",
    "isin": "US912797VR56",
    "issue_date": "2026-08-06",
    "security_type": "Bill",
    "security_term": "52-Week",
    "maturity_date": "2027-08-05",
    "dated_date": null,
    "interest_rate": null,
    "interest_payment_frequency": null,
    "first_interest_payment_date": null,
    "price_per_100": null,
    "high_discount_rate": null,
    "high_investment_rate": null,
    "tips": false,
    "floating_rate": false,
    "cash_management_bill": false,
    "reopening": false,
    "auction_date": null,
    "announcement_date": "2026-07-30"
  },
  "as_of": "2026-11-11",
  "days_to_maturity": 267,
  "outstanding": true,
  "pay_date": "2027-08-05",
  "coupon": null,
  "reopenings": [
    {
      "issue_date": "2026-08-06",
      "security_term": "52-Week",
      "reopening": false,
      "cash_management_bill": false,
      "price_per_100": null,
      "high_discount_rate": null,
      "high_investment_rate": null,
      "auction_date": null,
      "announcement_date": "2026-07-30"
    }
  ]
}

{
  "type": "/errors/not-found",
  "title": "Resource not found",
  "status": 404,
  "detail": "Title not in the Treasury catalog",
  "details": {
    "code": "not_in_catalog",
    "isin": "US0378331005"
  }
}

{
  "type": "/errors/validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "'US91282CMM01' fails the ISIN check digit",
  "details": {
    "code": "invalid_id"
  }
}

Devuelve la ficha de un título del Tesoro de Estados Unidos: la subasta original, todas las reaperturas y el calendario de cupones alrededor de as_of. Responde cualquier título del catálogo, también vencidos, TIPS y FRN. No trae precio: para eso está /price. Requiere el scope treasuries:read.

Parámetros de ruta

string

required

ISIN de 12 caracteres (US91282CMM00), ISIN sin dígito verificador de 11 (US91282CMM0) o CUSIP de 9 (91282CMM0). No distingue mayúsculas. Las tres formas devuelven la misma ficha.

Parámetros de consulta

string

Fecha de referencia, YYYY-MM-DD, para days_to_maturity, outstanding y el calendario de cupones. Predeterminado: la fecha del día del servidor. Acepta fechas pasadas y futuras.

Ejemplo de solicitud

curl "https://api.doctacapital.com.ar/api/v1/treasuries/instruments/US91282CMM00" \
  -H "Authorization: Bearer $DOCTA_TOKEN"

Respuesta exitosa

string

ISIN de 12 caracteres, cualquiera sea la forma del id que mandaste.

string

CUSIP de 9 caracteres.

string

Tipo de título: BILL, CMB, NOTE, BOND, TIPS o FRN.

object

La subasta original del título, con los datos que publica el Tesoro.

string

CUSIP.

string

ISIN.

string

Fecha de emisión de la subasta original.

string

Tipo según el Tesoro: Bill, Note o Bond. Un TIPS o un FRN vienen como Note o Bond.

string

Plazo de la subasta original (ej., 10-Year).

string

Fecha de vencimiento.

string | null

Fecha desde la que devenga el primer cupón. null en letras.

number | null

Tasa de cupón anual, en porcentaje (4.625 es 4,625%). null en letras y FRN.

string | null

Frecuencia de pago de intereses. Puede venir en null.

string | null

Fecha del primer pago de intereses. Puede venir en null.

number | null

Precio de la subasta por 100 de valor nominal. Puede venir en null.

number | null

Tasa de descuento de corte de la subasta. Puede venir en null.

number | null

Tasa de inversión de corte de la subasta. Puede venir en null.

boolean

Si es un TIPS.

boolean

Si es un FRN.

boolean

Si es una letra de caja (CMB).

boolean

Si esta subasta es una reapertura. En title es false salvo que el catálogo no tenga la subasta original.

string | null

Fecha de la subasta. Puede venir en null.

string | null

Fecha de anuncio de la subasta.

string

Fecha de referencia usada.

integer

Días corridos de as_of al vencimiento. Negativo en un título vencido.

boolean

Si el título está vigente en as_of: emitido en o antes de esa fecha y con vencimiento posterior.

string

Día en que se paga el vencimiento: maturity_date si es día hábil en el calendario de la Reserva Federal, si no el siguiente hábil.

object | null

Calendario de cupones en as_of. null en letras y letras de caja.

number | null

Tasa de cupón anual, en porcentaje. null en un FRN.

string | null

Frecuencia de pago. Puede venir en null.

string | null

Fecha del primer pago. Puede venir en null.

string | null

Último cupón en o antes de as_of. En un título vencido es maturity_date. null antes del inicio del devengamiento y en un FRN.

string | null

Próximo cupón después de as_of. null en un título vencido y en un FRN.

integer | null

Cupones que quedan por pagar después de as_of, el del vencimiento incluido. 0 en un título vencido. null en un FRN.

array

Todas las subastas del título, la original incluida, ordenadas por issue_date.

string

Fecha de emisión de esa subasta.

string

Plazo de esa subasta (ej., 9-Year 11-Month en una reapertura de una nota a 10 años).

boolean

false en la subasta original, true en una reapertura.

boolean

Si esa subasta fue de letra de caja.

number | null

Precio de esa subasta por 100. Puede venir en null.

number | null

Tasa de descuento de corte. Puede venir en null.

number | null

Tasa de inversión de corte. Puede venir en null.

string | null

Fecha de esa subasta. Puede venir en null.

string | null

Fecha de anuncio de esa subasta.

Varios datos de subasta vienen en null. El 11 de noviembre de 2026, price_per_100, high_discount_rate, high_investment_rate, interest_payment_frequency y first_interest_payment_date venían en null en todos los títulos vigentes. No los uses como precio: el precio está en /price.

Ejemplo de respuesta exitosa

La nota tiene tres subastas. reopenings está recortado a la original y la primera reapertura.

{
  "isin": "US91282CMM00",
  "cusip": "91282CMM0",
  "kind": "NOTE",
  "title": {
    "cusip": "91282CMM0",
    "isin": "US91282CMM00",
    "issue_date": "2025-02-18",
    "security_type": "Note",
    "security_term": "10-Year",
    "maturity_date": "2035-02-15",
    "dated_date": "2025-02-15",
    "interest_rate": 4.625,
    "interest_payment_frequency": null,
    "first_interest_payment_date": null,
    "price_per_100": null,
    "high_discount_rate": null,
    "high_investment_rate": null,
    "tips": false,
    "floating_rate": false,
    "cash_management_bill": false,
    "reopening": false,
    "auction_date": null,
    "announcement_date": "2025-02-05"
  },
  "as_of": "2026-11-11",
  "days_to_maturity": 3018,
  "outstanding": true,
  "pay_date": "2035-02-15",
  "coupon": {
    "rate": 4.625,
    "frequency": null,
    "first_payment_date": null,
    "previous_date": "2026-08-15",
    "next_date": "2027-02-15",
    "remaining_payments": 17
  },
  "reopenings": [
    {
      "issue_date": "2025-02-18",
      "security_term": "10-Year",
      "reopening": false,
      "cash_management_bill": false,
      "price_per_100": null,
      "high_discount_rate": null,
      "high_investment_rate": null,
      "auction_date": null,
      "announcement_date": "2025-02-05"
    },
    {
      "issue_date": "2025-03-17",
      "security_term": "9-Year 11-Month",
      "reopening": true,
      "cash_management_bill": false,
      "price_per_100": null,
      "high_discount_rate": null,
      "high_investment_rate": null,
      "auction_date": null,
      "announcement_date": "2025-03-06"
    }
  ]
}

{
  "isin": "US912797VR56",
  "cusip": "912797VR5",
  "kind": "BILL",
  "title": {
    "cusip": "912797VR5",
    "isin": "US912797VR56",
    "issue_date": "2026-08-06",
    "security_type": "Bill",
    "security_term": "52-Week",
    "maturity_date": "2027-08-05",
    "dated_date": null,
    "interest_rate": null,
    "interest_payment_frequency": null,
    "first_interest_payment_date": null,
    "price_per_100": null,
    "high_discount_rate": null,
    "high_investment_rate": null,
    "tips": false,
    "floating_rate": false,
    "cash_management_bill": false,
    "reopening": false,
    "auction_date": null,
    "announcement_date": "2026-07-30"
  },
  "as_of": "2026-11-11",
  "days_to_maturity": 267,
  "outstanding": true,
  "pay_date": "2027-08-05",
  "coupon": null,
  "reopenings": [
    {
      "issue_date": "2026-08-06",
      "security_term": "52-Week",
      "reopening": false,
      "cash_management_bill": false,
      "price_per_100": null,
      "high_discount_rate": null,
      "high_investment_rate": null,
      "auction_date": null,
      "announcement_date": "2026-07-30"
    }
  ]
}

{
  "type": "/errors/not-found",
  "title": "Resource not found",
  "status": 404,
  "detail": "Title not in the Treasury catalog",
  "details": {
    "code": "not_in_catalog",
    "isin": "US0378331005"
  }
}

{
  "type": "/errors/validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "'US91282CMM01' fails the ISIN check digit",
  "details": {
    "code": "invalid_id"
  }
}

Errores

Status	`details.code`	Cuándo
404	`not_in_catalog`	El identificador es válido pero no es un título del Tesoro (`US0378331005` es una acción). `details.isin` trae el ISIN normalizado.
404	`excluded_strips`	El CUSIP es de STRIPS, que no están en el catálogo.
422	`invalid_id`	El `id` no tiene forma de ISIN, ISIN de 11 o CUSIP (`abc`), o falla el dígito verificador.
422	`invalid_date`	`as_of` no es una fecha `YYYY-MM-DD` válida (`'as_of' must be YYYY-MM-DD, got 'hoy'`).

La taxonomía completa está en la guía.

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string

required

ISIN de 12 caracteres (US91282CMM00), ISIN sin dígito verificador de 11 (US91282CMM0) o CUSIP de 9 (91282CMM0). No distingue mayúsculas.

Pattern: ^([A-Za-z0-9]{9}|[Uu][Ss][A-Za-z0-9]{9,10})$

Query Parameters

as_of

string<date>

Fecha de referencia para el calendario de cupones, days_to_maturity y outstanding, YYYY-MM-DD. Predeterminado: hoy.

Response

Ficha del título

isin

string

ISIN

cusip

string

CUSIP

kind

enum<string>

Tipo de título

Available options:

BILL,

CMB,

NOTE,

BOND,

TIPS,

FRN

title

object

Subasta original

Show child attributes

as_of

string<date>

Fecha de referencia

days_to_maturity

integer

Días de as_of al vencimiento

outstanding

boolean

Vigente en as_of

pay_date

string<date>

Vencimiento o el siguiente día hábil de la Reserva Federal

coupon

object | null

Calendario de cupones; null en letras

Show child attributes

reopenings

object[]

Todas las subastas, la original incluida

Show child attributes

Introducción

Autenticación

Bonos

FCI

US Treasuries

Ficha de un US Treasury

Parámetros de ruta

Parámetros de consulta

Ejemplo de solicitud

Respuesta exitosa

Ejemplo de respuesta exitosa

Errores

Authorizations

Path Parameters

Query Parameters

Response

​Parámetros de ruta

​Parámetros de consulta

​Ejemplo de solicitud

​Respuesta exitosa

​Ejemplo de respuesta exitosa

​Errores

Authorizations

Path Parameters

Query Parameters

Response

Parámetros de ruta

Parámetros de consulta

Ejemplo de solicitud

Respuesta exitosa

Ejemplo de respuesta exitosa

Errores