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

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

{
  "isin": "US91282CMM00",
  "cusip": "91282CMM0",
  "family": "NOTE",
  "security_type": "Note",
  "security_term": "10-Year",
  "issue_date": "2025-02-18",
  "maturity_date": "2035-02-15",
  "coupon": 4.625,
  "as_of": "2026-11-10",
  "rate_date": "2026-11-10",
  "rate_age_days": 0,
  "method": "par_yield_interpolated",
  "units": "percent",
  "currency": "USD",
  "price": 99.0500870138465,
  "price_usd_per_100": 99.0500870138465,
  "dirty_price": 99.0500870138465,
  "clean_price": 97.95667668775954,
  "accrued_interest": 1.0934103260869565,
  "par_yield": 4.927972602739726,
  "prev_coupon": "2026-08-15",
  "next_coupon": "2027-02-15",
  "residual_days": 3019
}

{
  "isin": "US912797VR56",
  "cusip": "912797VR5",
  "family": "BILL",
  "security_type": "Bill",
  "security_term": "52-Week",
  "issue_date": "2026-08-06",
  "maturity_date": "2027-08-05",
  "as_of": "2026-11-10",
  "rate_date": "2026-11-10",
  "rate_age_days": 0,
  "method": "bill_discount_interpolated",
  "units": "percent",
  "currency": "USD",
  "price": 96.80052503052504,
  "price_usd_per_100": 96.80052503052504,
  "price_per_100": 96.80052503052504,
  "discount_rate": 4.297802197802198,
  "coupon_equivalent": 4.469651318800733,
  "residual_days": 268
}

{
  "isin": "US91282CMM00",
  "cusip": "91282CMM0",
  "family": "NOTE",
  "security_type": "Note",
  "security_term": "10-Year",
  "issue_date": "2025-02-18",
  "maturity_date": "2035-02-15",
  "coupon": 4.625,
  "as_of": "2026-11-10",
  "rate_date": "2026-11-10",
  "rate_age_days": 0,
  "method": "par_yield_interpolated",
  "units": "percent",
  "currency": "ARS",
  "price": 166277.26384039284,
  "price_usd_per_100": 99.0500870138465,
  "dirty_price": 99.0500870138465,
  "clean_price": 97.95667668775954,
  "accrued_interest": 1.0934103260869565,
  "par_yield": 4.927972602739726,
  "prev_coupon": "2026-08-15",
  "next_coupon": "2027-02-15",
  "residual_days": 3019,
  "fx_used": "ccl",
  "fx_value": 1678.71900826446,
  "fx_date": "2026-11-06"
}

{
  "type": "/errors/not-found",
  "title": "Resource not found",
  "status": 404,
  "detail": "TIPS are not valued: they need the CPI index",
  "details": {
    "code": "excluded_tips",
    "isin": "US91282CFR79"
  }
}

{
  "type": "/errors/validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "No 'par_yield' rates on or before 2020-01-02",
  "details": {
    "code": "no_rates_on_or_before",
    "first_rate_date": "2025-01-02"
  }
}

GET

api

treasuries

instruments

{id}

price

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

{
  "isin": "US91282CMM00",
  "cusip": "91282CMM0",
  "family": "NOTE",
  "security_type": "Note",
  "security_term": "10-Year",
  "issue_date": "2025-02-18",
  "maturity_date": "2035-02-15",
  "coupon": 4.625,
  "as_of": "2026-11-10",
  "rate_date": "2026-11-10",
  "rate_age_days": 0,
  "method": "par_yield_interpolated",
  "units": "percent",
  "currency": "USD",
  "price": 99.0500870138465,
  "price_usd_per_100": 99.0500870138465,
  "dirty_price": 99.0500870138465,
  "clean_price": 97.95667668775954,
  "accrued_interest": 1.0934103260869565,
  "par_yield": 4.927972602739726,
  "prev_coupon": "2026-08-15",
  "next_coupon": "2027-02-15",
  "residual_days": 3019
}

{
  "isin": "US912797VR56",
  "cusip": "912797VR5",
  "family": "BILL",
  "security_type": "Bill",
  "security_term": "52-Week",
  "issue_date": "2026-08-06",
  "maturity_date": "2027-08-05",
  "as_of": "2026-11-10",
  "rate_date": "2026-11-10",
  "rate_age_days": 0,
  "method": "bill_discount_interpolated",
  "units": "percent",
  "currency": "USD",
  "price": 96.80052503052504,
  "price_usd_per_100": 96.80052503052504,
  "price_per_100": 96.80052503052504,
  "discount_rate": 4.297802197802198,
  "coupon_equivalent": 4.469651318800733,
  "residual_days": 268
}

{
  "isin": "US91282CMM00",
  "cusip": "91282CMM0",
  "family": "NOTE",
  "security_type": "Note",
  "security_term": "10-Year",
  "issue_date": "2025-02-18",
  "maturity_date": "2035-02-15",
  "coupon": 4.625,
  "as_of": "2026-11-10",
  "rate_date": "2026-11-10",
  "rate_age_days": 0,
  "method": "par_yield_interpolated",
  "units": "percent",
  "currency": "ARS",
  "price": 166277.26384039284,
  "price_usd_per_100": 99.0500870138465,
  "dirty_price": 99.0500870138465,
  "clean_price": 97.95667668775954,
  "accrued_interest": 1.0934103260869565,
  "par_yield": 4.927972602739726,
  "prev_coupon": "2026-08-15",
  "next_coupon": "2027-02-15",
  "residual_days": 3019,
  "fx_used": "ccl",
  "fx_value": 1678.71900826446,
  "fx_date": "2026-11-06"
}

{
  "type": "/errors/not-found",
  "title": "Resource not found",
  "status": 404,
  "detail": "TIPS are not valued: they need the CPI index",
  "details": {
    "code": "excluded_tips",
    "isin": "US91282CFR79"
  }
}

{
  "type": "/errors/validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "No 'par_yield' rates on or before 2020-01-02",
  "details": {
    "code": "no_rates_on_or_before",
    "first_rate_date": "2025-01-02"
  }
}

Devuelve el precio de modelo de una letra, nota o bono del Tesoro de Estados Unidos, en dólares o en pesos. Es un precio calculado sobre la curva del Tesoro de un día, no una cotización de mercado ni una operación. Requiere el scope treasuries:read.

Cómo se calcula

Docta valúa el título con la curva publicada el día rate_date, el último día con tasas en o antes de as_of:

Letras y letras de caja (family: "BILL"): la tasa de descuento de la curva bill_discount interpolada linealmente en días al vencimiento (discount_rate), y precio 100 × (1 − discount_rate / 100 × residual_days / 360).
Notas y bonos (family: "NOTE" o "BOND"): los cupones y el capital descontados al par_yield interpolado linealmente en días al vencimiento, con capitalización semestral. El interés corrido se devenga ACT/ACT hasta as_of. price es el precio sucio.

Por debajo del primer tenor o por encima del último, la interpolación toma la tasa del extremo. Los TIPS, los FRN y los STRIPS no se valúan y responden 404.

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.

Parámetros de consulta

string

Fecha de valuación, YYYY-MM-DD, hasta hoy. Una fecha futura responde 422 invalid_date. Predeterminado: el último día con tasas. En un fin de semana o feriado usa la curva del último día hábil anterior.

string

default:"usd"

Moneda de price: usd, ars_ccl (pesos al dólar CCL) o ars_mep (pesos al dólar MEP). El dólar es el de as_of o el último publicado antes.

Ejemplo de solicitud

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

Respuesta exitosa

Las tasas vienen en porcentaje (4.927972602739726 es 4,93%) y lo dice units: "percent". Los precios son por 100 de valor nominal. Solo price cambia de moneda con currency; los demás precios quedan siempre en dólares. La respuesta no tiene campos en null: los que no aplican a la familia del título no vienen.

string

ISIN de 12 caracteres.

string

CUSIP de 9 caracteres.

string

Cómo se valúa el título: BILL (letras y letras de caja), NOTE o BOND.

string

Tipo según el Tesoro: Bill, Note o Bond.

string

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

string

Fecha de emisión.

string

Fecha de vencimiento.

number

Solo notas y bonos. Tasa de cupón anual, en porcentaje.

string

Fecha de valuación. Sin as_of en la request, es el último día con tasas.

string

Día de la curva usada.

integer

Días entre rate_date y as_of. 0 en un día hábil, 2 un domingo.

string

bill_discount_interpolated para letras, par_yield_interpolated para notas y bonos.

string

Siempre percent: las tasas de esta respuesta están en porcentaje.

string

USD, o ARS con currency=ars_ccl o ars_mep. Indica la moneda de price y nada más.

number

Precio de modelo por 100 de valor nominal, en currency. En una letra es el precio; en una nota o un bono, el precio sucio.

number

El mismo precio en dólares por 100, cualquiera sea currency. Es el valor que encadenás con la calculadora: input=price en una letra, input=dirty en una nota o un bono.

number

Solo letras. Precio en dólares por 100, igual a price_usd_per_100.

number

Solo letras. Tasa de descuento bancario interpolada en la curva bill_discount, en porcentaje.

number

Solo letras. Rendimiento equivalente de cupón (la fórmula del Tesoro, base 365 o 366) del precio de modelo, en porcentaje.

number

Solo notas y bonos. Precio sucio en dólares por 100.

number

Solo notas y bonos. Precio limpio en dólares por 100: dirty_price menos accrued_interest.

number

Solo notas y bonos. Interés corrido al as_of, en dólares por 100.

number

Solo notas y bonos. Rendimiento de la curva par_yield interpolado a los días al vencimiento, en porcentaje. Es la tasa con la que se descontó el título.

string

Solo notas y bonos. Último cupón en o antes de as_of.

string

Solo notas y bonos. Próximo cupón.

integer

Días corridos de as_of al vencimiento.

string

Solo con currency en pesos. ccl o mep.

number

Solo con currency en pesos. Pesos por dólar usados para price.

string

Solo con currency en pesos. Fecha del dólar usado: la de as_of o la última anterior con dato.

Para el rendimiento de mercado de este precio, pasá price_usd_per_100 a la calculadora, que responde en fracción. No mezcles par_yield (porcentaje) con las tasas de la calculadora sin convertir la escala. La receta completa está en la guía.

Ejemplo de respuesta exitosa

{
  "isin": "US91282CMM00",
  "cusip": "91282CMM0",
  "family": "NOTE",
  "security_type": "Note",
  "security_term": "10-Year",
  "issue_date": "2025-02-18",
  "maturity_date": "2035-02-15",
  "coupon": 4.625,
  "as_of": "2026-11-10",
  "rate_date": "2026-11-10",
  "rate_age_days": 0,
  "method": "par_yield_interpolated",
  "units": "percent",
  "currency": "USD",
  "price": 99.0500870138465,
  "price_usd_per_100": 99.0500870138465,
  "dirty_price": 99.0500870138465,
  "clean_price": 97.95667668775954,
  "accrued_interest": 1.0934103260869565,
  "par_yield": 4.927972602739726,
  "prev_coupon": "2026-08-15",
  "next_coupon": "2027-02-15",
  "residual_days": 3019
}

{
  "isin": "US912797VR56",
  "cusip": "912797VR5",
  "family": "BILL",
  "security_type": "Bill",
  "security_term": "52-Week",
  "issue_date": "2026-08-06",
  "maturity_date": "2027-08-05",
  "as_of": "2026-11-10",
  "rate_date": "2026-11-10",
  "rate_age_days": 0,
  "method": "bill_discount_interpolated",
  "units": "percent",
  "currency": "USD",
  "price": 96.80052503052504,
  "price_usd_per_100": 96.80052503052504,
  "price_per_100": 96.80052503052504,
  "discount_rate": 4.297802197802198,
  "coupon_equivalent": 4.469651318800733,
  "residual_days": 268
}

{
  "isin": "US91282CMM00",
  "cusip": "91282CMM0",
  "family": "NOTE",
  "security_type": "Note",
  "security_term": "10-Year",
  "issue_date": "2025-02-18",
  "maturity_date": "2035-02-15",
  "coupon": 4.625,
  "as_of": "2026-11-10",
  "rate_date": "2026-11-10",
  "rate_age_days": 0,
  "method": "par_yield_interpolated",
  "units": "percent",
  "currency": "ARS",
  "price": 166277.26384039284,
  "price_usd_per_100": 99.0500870138465,
  "dirty_price": 99.0500870138465,
  "clean_price": 97.95667668775954,
  "accrued_interest": 1.0934103260869565,
  "par_yield": 4.927972602739726,
  "prev_coupon": "2026-08-15",
  "next_coupon": "2027-02-15",
  "residual_days": 3019,
  "fx_used": "ccl",
  "fx_value": 1678.71900826446,
  "fx_date": "2026-11-06"
}

{
  "type": "/errors/not-found",
  "title": "Resource not found",
  "status": 404,
  "detail": "TIPS are not valued: they need the CPI index",
  "details": {
    "code": "excluded_tips",
    "isin": "US91282CFR79"
  }
}

{
  "type": "/errors/validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "No 'par_yield' rates on or before 2020-01-02",
  "details": {
    "code": "no_rates_on_or_before",
    "first_rate_date": "2025-01-02"
  }
}

Errores

Gana el primer error que aplica, en el orden de la tabla.

Status	`details.code`	Cuándo	Ejemplo de `detail`
422	`invalid_id`	El `id` no tiene forma de ISIN, ISIN de 11 o CUSIP, o falla el dígito verificador.	`'US91282CMM01' fails the ISIN check digit`
422	`invalid_date`	`as_of` mal formado, inexistente o futuro.	`'as_of' 2099-01-01 is in the future (today is 2026-11-11)`
422	`invalid_currency`	`currency` fuera de `usd`, `ars_ccl`, `ars_mep`.	`'currency' must be one of ['usd', 'ars_ccl', 'ars_mep'], got 'eur'`
404	`not_in_catalog`	El título no está en el catálogo del Tesoro.	`Title not in the Treasury catalog`
404	`excluded_tips`, `excluded_frn`, `excluded_strips`, `excluded_other`	El título no se valúa.	`Floating rate notes are not valued: the catalog has no margin`
404	`matured`	El título vence en o antes de `as_of`. Trae `maturity_date`.	`US9127933Y02 matured on 1980-04-03`
404	`not_issued`	`as_of` es anterior a la emisión. Trae `issue_date`.	`US91282CMM00 is issued on 2025-02-18`
422	`no_rates_on_or_before`	No hay curva en o antes de `as_of` (las tasas empiezan el 2025-01-02). Trae `first_rate_date`.	`No 'par_yield' rates on or before 2020-01-02`
422	`no_rates`	La curva no tiene ninguna tasa cargada. Trae `first_rate_date`.
422	`no_fx`	No hay dólar CCL o MEP en o antes de `as_of`. Trae `fx_used`.

Todos los 404 traen details.isin. 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 valuación hasta hoy, YYYY-MM-DD. Predeterminado: el último día con tasas.

currency

enum<string>

default:usd

Moneda de price: usd, ars_ccl o ars_mep (pesos al dólar CCL o MEP de as_of o el último anterior).

Available options:

usd,

ars_ccl,

ars_mep

Response

Precio de modelo

isin

string

cusip

string

family

enum<string>

Available options:

BILL,

NOTE,

BOND

security_type

string

security_term

string

issue_date

string<date>

maturity_date

string<date>

coupon

number

Notas y bonos: cupón anual en porcentaje

as_of

string<date>

Fecha de valuación

rate_date

string<date>

Día de la curva usada

rate_age_days

integer

Días entre rate_date y as_of

method

enum<string>

Available options:

bill_discount_interpolated,

par_yield_interpolated

units

enum<string>

Available options:

percent

currency

enum<string>

Moneda de price

Available options:

USD,

ARS

price

number

Precio de modelo por 100 en currency; sucio en notas y bonos

price_usd_per_100

number

El mismo precio en dólares por 100

price_per_100

number

Letras: precio en dólares por 100

discount_rate

number

Letras: tasa de descuento en porcentaje

coupon_equivalent

number

Letras: equivalente de cupón en porcentaje

dirty_price

number

Notas y bonos: precio sucio en dólares por 100

clean_price

number

Notas y bonos: precio limpio en dólares por 100

accrued_interest

number

Notas y bonos: interés corrido en dólares por 100

par_yield

number

Notas y bonos: par yield interpolado en porcentaje

prev_coupon

string<date>

next_coupon

string<date>

residual_days

integer

Días de as_of al vencimiento

fx_used

enum<string>

Con currency en pesos

Available options:

ccl,

mep

fx_value

number

Pesos por dólar

fx_date

string<date>

Fecha del dólar usado

Introducción

Autenticación

Bonos

FCI

US Treasuries

Precio de modelo de un US Treasury

Cómo se calcula

Parámetros de ruta

Parámetros de consulta

Ejemplo de solicitud

Respuesta exitosa

Ejemplo de respuesta exitosa

Errores

Authorizations

Path Parameters

Query Parameters

Response

​Cómo se calcula

​Parámetros de ruta

​Parámetros de consulta

​Ejemplo de solicitud

​Respuesta exitosa

​Ejemplo de respuesta exitosa

​Errores

Authorizations

Path Parameters

Query Parameters

Response

Cómo se calcula

Parámetros de ruta

Parámetros de consulta

Ejemplo de solicitud

Respuesta exitosa

Ejemplo de respuesta exitosa

Errores