> ## 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. # Ficha de un US Treasury > Ficha de un título: subasta original (title), todas las subastas (reopenings) y calendario de cupones en as_of. Responde también títulos vencidos, TIPS y FRN. Tasas en porcentaje. > [!NOTE] > > 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`](https://docs.docta.com.ar/api-reference/endpoint/treasuries-instruments-price). Requiere el scope `treasuries:read`. ## Parámetros de ruta **id** `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 **as\_of** `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 ```bash cURL theme={null} curl "https://api.doctacapital.com.ar/api/v1/treasuries/instruments/US91282CMM00" \ -H "Authorization: Bearer $DOCTA_TOKEN" ``` ## Respuesta exitosa **isin** `string` ISIN de 12 caracteres, cualquiera sea la forma del `id` que mandaste. **cusip** `string` CUSIP de 9 caracteres. **kind** `string` Tipo de título: `BILL`, `CMB`, `NOTE`, `BOND`, `TIPS` o `FRN`. **title** `object` La subasta original del título, con los datos que publica el Tesoro. **title.cusip** `string` CUSIP. **title.isin** `string` ISIN. **title.issue\_date** `string` Fecha de emisión de la subasta original. **title.security\_type** `string` Tipo según el Tesoro: `Bill`, `Note` o `Bond`. Un TIPS o un FRN vienen como `Note` o `Bond`. **title.security\_term** `string` Plazo de la subasta original (ej., `10-Year`). **title.maturity\_date** `string` Fecha de vencimiento. **title.dated\_date** `string | null` Fecha desde la que devenga el primer cupón. `null` en letras. **title.interest\_rate** `number | null` Tasa de cupón anual, en porcentaje (`4.625` es 4,625%). `null` en letras y FRN. **title.interest\_payment\_frequency** `string | null` Frecuencia de pago de intereses. Puede venir en `null`. **title.first\_interest\_payment\_date** `string | null` Fecha del primer pago de intereses. Puede venir en `null`. **title.price\_per\_100** `number | null` Precio de la subasta por 100 de valor nominal. Puede venir en `null`. **title.high\_discount\_rate** `number | null` Tasa de descuento de corte de la subasta. Puede venir en `null`. **title.high\_investment\_rate** `number | null` Tasa de inversión de corte de la subasta. Puede venir en `null`. **title.tips** `boolean` Si es un TIPS. **title.floating\_rate** `boolean` Si es un FRN. **title.cash\_management\_bill** `boolean` Si es una letra de caja (CMB). **title.reopening** `boolean` Si esta subasta es una reapertura. En `title` es `false` salvo que el catálogo no tenga la subasta original. **title.auction\_date** `string | null` Fecha de la subasta. Puede venir en `null`. **title.announcement\_date** `string | null` Fecha de anuncio de la subasta. **as\_of** `string` Fecha de referencia usada. **days\_to\_maturity** `integer` Días corridos de `as_of` al vencimiento. Negativo en un título vencido. **outstanding** `boolean` Si el título está vigente en `as_of`: emitido en o antes de esa fecha y con vencimiento posterior. **pay\_date** `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. **coupon** `object | null` Calendario de cupones en `as_of`. `null` en letras y letras de caja. **coupon.rate** `number | null` Tasa de cupón anual, en porcentaje. `null` en un FRN. **coupon.frequency** `string | null` Frecuencia de pago. Puede venir en `null`. **coupon.first\_payment\_date** `string | null` Fecha del primer pago. Puede venir en `null`. **coupon.previous\_date** `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. **coupon.next\_date** `string | null` Próximo cupón después de `as_of`. `null` en un título vencido y en un FRN. **coupon.remaining\_payments** `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. **reopenings** `array` Todas las subastas del título, la original incluida, ordenadas por `issue_date`. **reopenings\[].issue\_date** `string` Fecha de emisión de esa subasta. **reopenings\[].security\_term** `string` Plazo de esa subasta (ej., `9-Year 11-Month` en una reapertura de una nota a 10 años). **reopenings\[].reopening** `boolean` `false` en la subasta original, `true` en una reapertura. **reopenings\[].cash\_management\_bill** `boolean` Si esa subasta fue de letra de caja. **reopenings\[].price\_per\_100** `number | null` Precio de esa subasta por 100. Puede venir en `null`. **reopenings\[].high\_discount\_rate** `number | null` Tasa de descuento de corte. Puede venir en `null`. **reopenings\[].high\_investment\_rate** `number | null` Tasa de inversión de corte. Puede venir en `null`. **reopenings\[].auction\_date** `string | null` Fecha de esa subasta. Puede venir en `null`. **reopenings\[].announcement\_date** `string | null` Fecha de anuncio de esa subasta. > [!NOTE] > > 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`](https://docs.docta.com.ar/api-reference/endpoint/treasuries-instruments-price). ## Ejemplo de respuesta exitosa La nota tiene tres subastas. `reopenings` está recortado a la original y la primera reapertura. ```json 200 theme={null} { "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" } ] } ``` ```json 200 letra theme={null} { "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" } ] } ``` ```json 404 theme={null} { "type": "/errors/not-found", "title": "Resource not found", "status": 404, "detail": "Title not in the Treasury catalog", "details": { "code": "not_in_catalog", "isin": "US0378331005" } } ``` ```json 422 theme={null} { "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](https://docs.docta.com.ar/api-reference/treasuries-guia.md#errores). ## OpenAPI ````yaml GET /api/v1/treasuries/instruments/{id} 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/{id}: get: tags: - US Treasuries description: >- Ficha de un título: subasta original (title), todas las subastas (reopenings) y calendario de cupones en as_of. Responde también títulos vencidos, TIPS y FRN. Tasas en porcentaje. parameters: - name: id in: path required: true description: >- ISIN de 12 caracteres (US91282CMM00), ISIN sin dígito verificador de 11 (US91282CMM0) o CUSIP de 9 (91282CMM0). No distingue mayúsculas. schema: type: string pattern: ^([A-Za-z0-9]{9}|[Uu][Ss][A-Za-z0-9]{9,10})$ example: US91282CMM00 - name: as_of in: query required: false description: >- Fecha de referencia para el calendario de cupones, days_to_maturity y outstanding, YYYY-MM-DD. Predeterminado: hoy. schema: type: string format: date responses: '200': description: Ficha del título content: application/json: schema: $ref: '#/components/schemas/TreasuryDetailResponse' example: 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' '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' '404': description: >- Título fuera del catálogo (not_in_catalog) o STRIPS (excluded_strips) content: application/json: schema: $ref: '#/components/schemas/TreasuryError' example: type: /errors/not-found title: Resource not found status: 404 detail: Title not in the Treasury catalog details: code: not_in_catalog isin: US0378331005 '422': description: Identificador o fecha inválidos (invalid_id, invalid_date) content: application/json: schema: $ref: '#/components/schemas/TreasuryError' example: type: /errors/validation-error title: Validation Error status: 422 detail: '''US91282CMM01'' fails the ISIN check digit' details: code: invalid_id '429': description: Límite de requests de tu plan superado content: application/json: schema: $ref: '#/components/schemas/TreasuryError' security: - bearerAuth: [] components: schemas: TreasuryDetailResponse: type: object properties: isin: type: string description: ISIN cusip: type: string description: CUSIP kind: type: string description: Tipo de título enum: - BILL - CMB - NOTE - BOND - TIPS - FRN title: type: object properties: cusip: type: string isin: type: string issue_date: type: string format: date security_type: type: string security_term: type: string maturity_date: type: string format: date dated_date: type: - string - 'null' format: date interest_rate: type: - number - 'null' description: Cupón anual en porcentaje interest_payment_frequency: type: - string - 'null' first_interest_payment_date: type: - string - 'null' format: date price_per_100: type: - number - 'null' high_discount_rate: type: - number - 'null' high_investment_rate: type: - number - 'null' tips: type: boolean floating_rate: type: boolean cash_management_bill: type: boolean reopening: type: boolean auction_date: type: - string - 'null' format: date announcement_date: type: - string - 'null' format: date description: Subasta original as_of: type: string description: Fecha de referencia format: date days_to_maturity: type: integer description: Días de as_of al vencimiento outstanding: type: boolean description: Vigente en as_of pay_date: type: string description: Vencimiento o el siguiente día hábil de la Reserva Federal format: date coupon: type: - object - 'null' properties: rate: type: - number - 'null' description: Cupón anual en porcentaje frequency: type: - string - 'null' first_payment_date: type: - string - 'null' format: date previous_date: type: - string - 'null' format: date next_date: type: - string - 'null' format: date remaining_payments: type: - integer - 'null' description: Calendario de cupones; null en letras reopenings: 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: Todas las subastas, la original incluida 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 securitySchemes: bearerAuth: type: http scheme: bearer ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.