> ## Documentation Index > Fetch the complete documentation index at: https://docs.docta.com.ar/llms.txt > Use this file to discover all available pages before exploring further. # Catálogo de US Treasuries > Catálogo de títulos del Tesoro de Estados Unidos, una fila por título (las reaperturas se agrupan en la subasta original), ordenado por maturity_date. Letras, letras de caja, notas, bonos, TIPS y FRN desde 1980. No trae precio. Por defecto lista todos los títulos, vencidos incluidos, hasta limit=1000. Coupon en porcentaje. > [!NOTE] > > 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`](https://docs.docta.com.ar/api-reference/endpoint/treasuries-instruments-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. **type** `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. **as\_of** `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. **outstanding** `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`. **maturity\_from** `string` Vencimiento mínimo, inclusivo, `YYYY-MM-DD`. **maturity\_to** `string` Vencimiento máximo, inclusivo, `YYYY-MM-DD`. **term** `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`. **q** `string` Fragmento del ISIN o del CUSIP, sin distinguir mayúsculas. `q=91282CJK` encuentra `US91282CJK80`. **limit** `string` (default: 1000) Máximo de filas, de 1 a 10000. `total` informa cuántos títulos cumplen los filtros aunque no entren todos. **include** `string` Datos extra, separados por punto. El único valor es `reopenings`, que agrega a cada fila `auctions` con todas las subastas del título. > [!NOTE] > > 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 ```bash cURL theme={null} curl "https://api.doctacapital.com.ar/api/v1/treasuries/instruments?type=bill&outstanding=true&limit=3" \ -H "Authorization: Bearer $DOCTA_TOKEN" ``` ## Respuesta exitosa **as\_of** `string` Fecha de referencia usada, `YYYY-MM-DD`. **filters** `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`. **total** `integer` Títulos que cumplen los filtros, antes de aplicar `limit`. **returned** `integer` Filas devueltas en `data`. **data** `array` Un título por fila. **data\[].isin** `string` ISIN de 12 caracteres. **data\[].cusip** `string` CUSIP de 9 caracteres. **data\[].kind** `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`. **data\[].security\_type** `string` Tipo según el Tesoro: `Bill`, `Note` o `Bond`. **data\[].security\_term** `string` Plazo de la subasta original (ej., `52-Week`, `10-Year`). **data\[].issue\_date** `string` Fecha de emisión de la subasta original. **data\[].dated\_date** `string | null` Fecha desde la que devenga el primer cupón. `null` en letras. **data\[].maturity\_date** `string` Fecha de vencimiento. **data\[].days\_to\_maturity** `integer` Días corridos de `as_of` al vencimiento. Negativo en un título vencido. **data\[].outstanding** `boolean` Si el título está vigente en `as_of`. **data\[].coupon** `number | null` Tasa de cupón anual, en porcentaje (`4.625` es 4,625%). `null` en letras y FRN. **data\[].interest\_payment\_frequency** `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. **data\[].first\_interest\_payment\_date** `string | null` Fecha del primer pago de intereses. Puede venir en `null`, igual que `interest_payment_frequency`. **data\[].reopenings** `integer` Cantidad de reaperturas: subastas del título además de la original. **data\[].auction** `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. **data\[].last\_auction** `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. **data\[].auctions** `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. ```json 200 theme={null} { "as_of": "2026-11-11", "filters": { "type": ["bill"], "outstanding": true, "maturity_from": null, "maturity_to": null, "term": null, "q": null, "include": null }, "total": 44, "returned": 3, "data": [ { "isin": "US912797UY17", "cusip": "912797UY1", "kind": "BILL", "security_type": "Bill", "security_term": "26-Week", "issue_date": "2026-05-14", "dated_date": null, "maturity_date": "2026-11-12", "days_to_maturity": 1, "outstanding": true, "coupon": null, "interest_payment_frequency": null, "first_interest_payment_date": null, "reopenings": 2, "auction": { "auction_date": null, "announcement_date": "2026-05-07", "price_per_100": null, "high_discount_rate": null, "high_investment_rate": null }, "last_auction": { "issue_date": "2026-10-01", "security_term": "6-Week", "reopening": true, "cash_management_bill": false, "price_per_100": null, "high_discount_rate": null, "high_investment_rate": null, "auction_date": null, "announcement_date": "2026-09-24" } } ] } ``` ```json 200 include=reopenings theme={null} { "as_of": "2026-11-11", "filters": { "type": null, "outstanding": false, "maturity_from": null, "maturity_to": null, "term": null, "q": "91282CJK", "include": ["reopenings"] }, "total": 1, "returned": 1, "data": [ { "isin": "US91282CJK80", "cusip": "91282CJK8", "kind": "NOTE", "security_type": "Note", "security_term": "3-Year", "issue_date": "2023-11-15", "dated_date": "2023-11-15", "maturity_date": "2026-11-15", "days_to_maturity": 4, "outstanding": true, "coupon": 4.625, "interest_payment_frequency": null, "first_interest_payment_date": null, "reopenings": 0, "auction": { "auction_date": null, "announcement_date": "2023-11-01", "price_per_100": null, "high_discount_rate": null, "high_investment_rate": null }, "last_auction": { "issue_date": "2023-11-15", "security_term": "3-Year", "reopening": false, "cash_management_bill": false, "price_per_100": null, "high_discount_rate": null, "high_investment_rate": null, "auction_date": null, "announcement_date": "2023-11-01" }, "auctions": [ { "issue_date": "2023-11-15", "security_term": "3-Year", "reopening": false, "cash_management_bill": false, "price_per_100": null, "high_discount_rate": null, "high_investment_rate": null, "auction_date": null, "announcement_date": "2023-11-01" } ] } ] } ``` ```json 422 theme={null} { "type": "/errors/validation-error", "title": "Validation Error", "status": 422, "detail": "'type' accepts ['bill', 'cmb', 'note', 'bond', 'tips', 'frn'] separated by dots, got ['foo']", "details": { "code": "invalid_type" } } ``` ## Errores | Status | `details.code` | Cuándo | | - | - | - | | 422 | `invalid_type` | `type` con un valor fuera de la lista. | | 422 | `invalid_include` | `include` distinto de `reopenings`. | | 422 | `invalid_parameter` | `limit` fuera de 1 a 10000 (`'limit' must be between 1 and 10000, got 0`) u `outstanding` que no es booleano. | | 422 | `invalid_date` | `as_of`, `maturity_from` o `maturity_to` no son una fecha `YYYY-MM-DD` válida. | 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](https://docs.docta.com.ar/api-reference/treasuries-guia.md#errores). ## OpenAPI ````yaml GET /api/v1/treasuries/instruments openapi: 3.1.0 info: title: API de Docta description: >- API de mercado argentino: bonos (instrumentos, cashflows, curvas/yields) y FCI (screener, series, performance, comparaciones y analytics de industria). license: name: MIT version: 1.0.0 servers: - url: https://api.doctacapital.com.ar security: [] paths: /api/v1/treasuries/instruments: get: tags: - US Treasuries description: >- Catálogo de títulos del Tesoro de Estados Unidos, una fila por título (las reaperturas se agrupan en la subasta original), ordenado por maturity_date. Letras, letras de caja, notas, bonos, TIPS y FRN desde 1980. No trae precio. Por defecto lista todos los títulos, vencidos incluidos, hasta limit=1000. Coupon en porcentaje. parameters: - name: type in: query required: false description: >- Tipos separados por punto: bill, cmb, note, bond, tips, frn. Ej.: note.bond. schema: type: string example: note.bond - name: as_of in: query required: false description: >- Fecha de referencia para outstanding, days_to_maturity y last_auction, YYYY-MM-DD. Predeterminado: hoy. schema: type: string format: date - name: outstanding in: query required: false description: >- true deja los títulos con issue_date <= as_of < maturity_date. false lista todos. schema: type: string enum: - 'true' - 'false' default: 'false' - name: maturity_from in: query required: false description: Vencimiento mínimo, inclusivo, YYYY-MM-DD. schema: type: string format: date - name: maturity_to in: query required: false description: Vencimiento máximo, inclusivo, YYYY-MM-DD. schema: type: string format: date - name: term in: query required: false description: Plazo exacto de la subasta original, ej. 52-Week o 10-Year. schema: type: string example: 52-Week - name: q in: query required: false description: Fragmento del ISIN o del CUSIP. schema: type: string example: 91282CJK - name: limit in: query required: false description: Máximo de filas, de 1 a 10000. schema: type: integer minimum: 1 maximum: 10000 default: 1000 - name: include in: query required: false description: >- Extras separados por punto. Único valor: reopenings (agrega auctions a cada fila). schema: type: string enum: - reopenings responses: '200': description: Catálogo de títulos content: application/json: schema: $ref: '#/components/schemas/TreasuryCatalogResponse' example: as_of: '2026-11-11' filters: type: - bill outstanding: true maturity_from: null maturity_to: null term: null q: null include: null total: 44 returned: 3 data: - isin: US912797UY17 cusip: 912797UY1 kind: BILL security_type: Bill security_term: 26-Week issue_date: '2026-05-14' dated_date: null maturity_date: '2026-11-12' days_to_maturity: 1 outstanding: true coupon: null interest_payment_frequency: null first_interest_payment_date: null reopenings: 2 auction: auction_date: null announcement_date: '2026-05-07' price_per_100: null high_discount_rate: null high_investment_rate: null last_auction: issue_date: '2026-10-01' security_term: 6-Week reopening: true cash_management_bill: false price_per_100: null high_discount_rate: null high_investment_rate: null auction_date: null announcement_date: '2026-09-24' '401': description: Autenticación requerida content: application/json: schema: $ref: '#/components/schemas/TreasuryError' example: type: /errors/authentication-required title: Authorization header missing status: 401 detail: Authorization header missing '403': description: 'Permisos insuficientes: requiere el scope treasuries:read' content: application/json: schema: $ref: '#/components/schemas/TreasuryError' example: type: /errors/insufficient-permissions title: 'Insufficient permissions. Required scope: treasuries:read' status: 403 detail: 'Insufficient permissions. Required scope: treasuries:read' '422': description: Parámetro inválido; details.code indica la regla content: application/json: schema: $ref: '#/components/schemas/TreasuryError' example: type: /errors/validation-error title: Validation Error status: 422 detail: >- 'type' accepts ['bill', 'cmb', 'note', 'bond', 'tips', 'frn'] separated by dots, got ['foo'] details: code: invalid_type '429': description: Límite de requests de tu plan superado content: application/json: schema: $ref: '#/components/schemas/TreasuryError' security: - bearerAuth: [] components: schemas: TreasuryCatalogResponse: type: object properties: as_of: type: string description: Fecha de referencia format: date filters: type: object properties: type: type: - array - 'null' description: Tipos items: type: string outstanding: type: boolean description: Filtro de vigencia maturity_from: type: - string - 'null' format: date maturity_to: type: - string - 'null' format: date term: type: - string - 'null' q: type: - string - 'null' description: En mayúscula include: type: - array - 'null' items: type: string description: Filtros aplicados, normalizados total: type: integer description: Títulos que cumplen los filtros returned: type: integer description: Filas devueltas data: type: array items: $ref: '#/components/schemas/TreasuryCatalogItem' required: - as_of - filters - total - returned - data TreasuryError: type: object properties: type: type: string description: Tipo de error example: /errors/not-found title: type: string description: Título del error example: Resource not found status: type: integer description: Status HTTP example: 404 detail: type: string description: 'Mensaje legible, en inglés. Puede cambiar: no lo parsees.' details: type: object properties: code: type: string description: Código estable del error. Es lo que distingue cada caso. enum: - invalid_id - invalid_date - invalid_type - invalid_include - invalid_parameter - invalid_curve - invalid_tenor - invalid_spread - invalid_range - invalid_currency - missing_parameter - invalid_input - invalid_value - invalid_settlement_entry - invalid_fx_value - no_rates_on_or_before - no_rates - no_fx - did_not_converge - not_in_catalog - excluded_strips - excluded_tips - excluded_frn - excluded_other - matured - not_issued isin: type: string description: ISIN del título, en los 404 y en did_not_converge maturity_date: type: string description: Vencimiento, en matured format: date issue_date: type: string description: Emisión, en not_issued format: date first_rate_date: type: string description: Primera fecha con tasas, en no_rates_on_or_before y no_rates format: date fx_used: type: string description: ccl o mep, en no_fx required: - code description: Solo en los errores del dominio (404 y 422 de Treasuries) required: - type - title - status - detail TreasuryCatalogItem: type: object properties: isin: type: string description: ISIN de 12 caracteres cusip: type: string description: CUSIP de 9 caracteres kind: type: string description: Tipo de título enum: - BILL - CMB - NOTE - BOND - TIPS - FRN security_type: type: string description: 'Tipo según el Tesoro: Bill, Note o Bond' security_term: type: string description: Plazo de la subasta original issue_date: type: string description: Emisión de la subasta original format: date dated_date: type: - string - 'null' description: Inicio del devengamiento del primer cupón format: date maturity_date: type: string description: Vencimiento format: date days_to_maturity: type: integer description: Días de as_of al vencimiento; negativo si venció outstanding: type: boolean description: Vigente en as_of coupon: type: - number - 'null' description: Cupón anual en porcentaje; null en letras y FRN interest_payment_frequency: type: - string - 'null' description: Frecuencia de pago de intereses first_interest_payment_date: type: - string - 'null' description: Primer pago de intereses format: date reopenings: type: integer description: Cantidad de reaperturas auction: type: object properties: price_per_100: type: - number - 'null' description: Precio de la subasta por 100 high_discount_rate: type: - number - 'null' description: Tasa de descuento de corte high_investment_rate: type: - number - 'null' description: Tasa de inversión de corte auction_date: type: - string - 'null' description: Fecha de la subasta format: date announcement_date: type: - string - 'null' description: Fecha de anuncio format: date description: Subasta original last_auction: type: - object - 'null' properties: issue_date: type: string description: Fecha de emisión de esa subasta format: date security_term: type: string description: Plazo de esa subasta reopening: type: boolean description: true si es una reapertura cash_management_bill: type: boolean description: Si es letra de caja price_per_100: type: - number - 'null' description: Precio de la subasta por 100 high_discount_rate: type: - number - 'null' description: Tasa de descuento de corte high_investment_rate: type: - number - 'null' description: Tasa de inversión de corte auction_date: type: - string - 'null' description: Fecha de la subasta format: date announcement_date: type: - string - 'null' description: Fecha de anuncio format: date description: Última subasta en o antes de as_of auctions: type: array items: type: object properties: issue_date: type: string description: Fecha de emisión de esa subasta format: date security_term: type: string description: Plazo de esa subasta reopening: type: boolean description: true si es una reapertura cash_management_bill: type: boolean description: Si es letra de caja price_per_100: type: - number - 'null' description: Precio de la subasta por 100 high_discount_rate: type: - number - 'null' description: Tasa de descuento de corte high_investment_rate: type: - number - 'null' description: Tasa de inversión de corte auction_date: type: - string - 'null' description: Fecha de la subasta format: date announcement_date: type: - string - 'null' description: Fecha de anuncio format: date description: 'Solo con include=reopenings: todas las subastas' securitySchemes: bearerAuth: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.