Skip to main content
GET
Devuelve la curva del Tesoro de Estados Unidos de un día: una tasa por tenor. Opcionalmente suma una tasa interpolada a N días y la curva de otra fecha con el cambio por tenor. Las tasas vienen en porcentaje (4.98 es 4,98%). Requiere el scope treasuries:read.

Curvas disponibles

Hay una curva por día hábil de Estados Unidos. par_yield tiene tasas desde el 2 de enero de 2025. Si pedís una fecha anterior a la primera de la curva, el error trae esa fecha en first_rate_date.

Parámetros de consulta

string
default:"par_yield"
par_yield, bill_discount o bill_coupon_equivalent.
string
Día de la curva, YYYY-MM-DD. Si no hay tasas ese día (fin de semana, feriado o una fecha posterior a la última), la API devuelve el último día con tasas anterior y lo informa en rate_date y rate_age_days. Predeterminado: el último día con tasas.
string
Días al vencimiento, de 1 a 20000. Suma interpolated: la tasa interpolada linealmente en días entre los dos tenors que rodean ese plazo.
string
Segunda fecha, YYYY-MM-DD. Suma compare: la curva de ese día, con la misma regla de último día con tasas, y el cambio por tenor.

Ejemplo de solicitud

Respuesta exitosa

string
Curva devuelta.
string
Fecha pedida en date, o el último día con tasas si no la mandaste.
string
Día de la curva devuelta: el último día con tasas en o antes de requested_date.
integer
Días entre rate_date y requested_date. 0 si ese día tiene tasas.
array
Un punto por tenor, de menor a mayor plazo.
string
Etiqueta del tenor (ej., 2Y, 1.5M, 52W).
integer
Plazo del tenor en días (ej., 2Y es 730, 52W es 364).
number | null
Tasa en porcentaje. null si el Tesoro no publicó ese tenor ese día.
object | null
Solo con tenor_days; si no, null.
integer
El plazo pedido.
number
Tasa interpolada, en porcentaje. En un tenor exacto es la tasa de ese tenor. Por debajo del primer tenor o por encima del último, la del extremo.
string
Siempre linear_days.
object
Tenor inferior usado: tenor, tenor_days y rate.
object
Tenor superior usado: tenor, tenor_days y rate. Igual a lower en un tenor exacto o fuera de los extremos.
object | null
Solo con compare_date; si no, null.
string
La fecha pedida en compare_date.
string
Día de la curva de comparación.
integer
Días entre compare.rate_date y compare.requested_date.
array
Un punto por tenor, en el mismo orden que points: tenor, tenor_days, rate (la tasa del día de comparación, en porcentaje) y change.
number | null
Tasa de la curva principal menos tasa de la curva de comparación, en puntos porcentuales y redondeada a 6 decimales. null si falta alguna de las dos.
Una fecha posterior a la última con tasas no es un error. Con compare_date=2099-01-01, compare trae la última curva disponible y rate_age_days: 26350. Mirá siempre rate_date para saber qué día graficás.

Ejemplo de respuesta exitosa

En el primer ejemplo, points y compare.points están recortados a cuatro de los 14 tenors.

Errores

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.

Query Parameters

curve
enum<string>
default:par_yield

Curva: par_yield (notas y bonos, 1M a 30Y), bill_discount o bill_coupon_equivalent (letras, 4W a 52W).

Available options:
par_yield,
bill_discount,
bill_coupon_equivalent
date
string<date>

Día de la curva, YYYY-MM-DD. Predeterminado: el último día con tasas.

tenor_days
integer

Días al vencimiento, de 1 a 20000. Agrega interpolated.

Required range: 1 <= x <= 20000
compare_date
string<date>

Segunda fecha, YYYY-MM-DD. Agrega compare con el cambio por tenor.

Response

Curva de un día

curve
enum<string>
Available options:
par_yield,
bill_discount,
bill_coupon_equivalent
requested_date
string<date>
rate_date
string<date>
rate_age_days
integer
points
object[]
interpolated
object | null
compare
object | null