Skip to main content
GET
Lista los títulos del Tesoro de Estados Unidos, una fila por título: las reaperturas se agrupan en la subasta original. Cubre letras, letras de caja, notas, bonos, TIPS y FRN desde 1980. Es la base del screener y del buscador. No trae precio: para eso está /price. Requiere el scope treasuries:read.

​
Parámetros de consulta

Todos son opcionales. Sin ninguno, la API devuelve las primeras 1.000 filas de los 5.099 títulos del catálogo, vencidos incluidos.
​
string
Tipos de título separados por punto, sin distinguir mayúsculas: bill, cmb, note, bond, tips, frn. Ejemplo: type=note.bond. Sin type entran todos.
​
string
Fecha de referencia, YYYY-MM-DD. Define qué títulos están vigentes (outstanding), los days_to_maturity y last_auction. Predeterminado: la fecha del día del servidor. Acepta fechas pasadas y futuras.
​
string
default:"false"
true deja solo los títulos vigentes en as_of: emitidos en o antes de esa fecha (issue_date <= as_of) y que vencen después (as_of < maturity_date). false lista todos. Acepta true, false, 1, 0, yes, no.
​
string
Vencimiento mínimo, inclusivo, YYYY-MM-DD.
​
string
Vencimiento máximo, inclusivo, YYYY-MM-DD.
​
string
Plazo exacto de la subasta original, tal como lo publica el Tesoro, sin distinguir mayúsculas: 52-Week, 26-Week, 2-Year, 10-Year, 30-Year. Algunos títulos tienen plazos como 29-Year 9-Month.
​
string
Fragmento del ISIN o del CUSIP, sin distinguir mayúsculas. q=91282CJK encuentra US91282CJK80.
​
string
default:"1000"
Máximo de filas, de 1 a 10000. total informa cuántos títulos cumplen los filtros aunque no entren todos.
​
string
Datos extra, separados por punto. El único valor es reopenings, que agrega a cada fila auctions con todas las subastas del título.
Las filas vienen ordenadas por maturity_date ascendente y, en el mismo vencimiento, por ISIN. Con outstanding=true&limit=10000 traés todos los títulos vigentes en una request: eran 454 el 11 de noviembre de 2026.

​
Ejemplo de solicitud

​
Respuesta exitosa

​
string
Fecha de referencia usada, YYYY-MM-DD.
​
object
Los filtros aplicados, ya normalizados: type (lista en minúscula o null), outstanding (booleano), maturity_from, maturity_to, term, q (en mayúscula) e include (lista o null). Un filtro que no mandaste vuelve en null.
​
integer
Títulos que cumplen los filtros, antes de aplicar limit.
​
integer
Filas devueltas en data.
​
array
Un título por fila.
​
string
ISIN de 12 caracteres.
​
string
CUSIP de 9 caracteres.
​
string
Tipo de título: BILL, CMB, NOTE, BOND, TIPS o FRN. Sale de las marcas del título: un TIPS o un FRN tienen security_type Note o Bond, y una letra de caja tiene Bill.
​
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 de la subasta original.
​
string | null
Fecha desde la que devenga el primer cupón. null en letras.
​
string
Fecha de vencimiento.
​
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.
​
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 según el Tesoro. Puede venir en null: el 11 de noviembre de 2026 venía en null en los 454 títulos vigentes.
​
string | null
Fecha del primer pago de intereses. Puede venir en null, igual que interest_payment_frequency.
​
integer
Cantidad de reaperturas: subastas del título además de la original.
​
object
Datos de la subasta original: auction_date, announcement_date, price_per_100, high_discount_rate y high_investment_rate. Solo announcement_date viene completo en todo el catálogo vigente. Los demás pueden venir en null, y el 11 de noviembre de 2026 price_per_100, high_discount_rate y high_investment_rate venían en null en todos los títulos vigentes.
​
object | null
La última subasta hecha en o antes de as_of, la original o una reapertura: issue_date, security_term (plazo de esa subasta, ej., 9-Year 10-Month), reopening, cash_management_bill, price_per_100, high_discount_rate, high_investment_rate, auction_date y announcement_date. Cuando auction_date es null, la fecha que cuenta es issue_date. null si as_of es anterior a la primera subasta.
​
array
Solo con include=reopenings. Todas las subastas del título, la original incluida, ordenadas por issue_date, con los mismos campos que last_auction: issue_date, security_term, reopening, cash_management_bill, price_per_100, high_discount_rate, high_investment_rate, auction_date y announcement_date.

​
Ejemplo de respuesta exitosa

La respuesta trae tres letras. Acá se muestra la primera.

​
Errores

Un filtro que no matchea nada no es un error: devuelve total: 0 y data vacío. 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

​
type
string

Tipos separados por punto: bill, cmb, note, bond, tips, frn. Ej.: note.bond.

​
as_of
string<date>

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

​
outstanding
enum<string>
default:false

true deja los títulos con issue_date <= as_of < maturity_date. false lista todos.

Available options:
true,
false
​
maturity_from
string<date>

Vencimiento mínimo, inclusivo, YYYY-MM-DD.

​
maturity_to
string<date>

Vencimiento máximo, inclusivo, YYYY-MM-DD.

​
term
string

Plazo exacto de la subasta original, ej. 52-Week o 10-Year.

​
q
string

Fragmento del ISIN o del CUSIP.

​
limit
integer
default:1000

Máximo de filas, de 1 a 10000.

Required range: 1 <= x <= 10000
​
include
enum<string>

Extras separados por punto. Único valor: reopenings (agrega auctions a cada fila).

Available options:
reopenings

Response

Catálogo de títulos

​
as_of
string<date>
required

Fecha de referencia

​
filters
object
required

Filtros aplicados, normalizados

​
total
integer
required

Títulos que cumplen los filtros

​
returned
integer
required

Filas devueltas

​
data
object[]
required