> ## 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.

# Calculadora de US Treasuries

> Métricas de una letra, nota o bono a partir de un precio o una tasa. Tasas como fracción, en value y en la respuesta (0.042 = 4,2%, units: fraction), a diferencia de /curve y /price, que responden en porcentaje; coupon sigue en porcentaje. Precios por 100 de valor nominal: value de un input de precio, market_price, principal, accrued_amount y total van en currency; dirty_price, clean_price y accrued_interest siempre en dólares. Notas y bonos con convención street.

> [!NOTE]
>
> Calcula las métricas de una letra, nota o bono del Tesoro de Estados Unidos a partir de un precio o una tasa: precios limpio y sucio, interés corrido, rendimientos, duration, convexidad, DV01 y, con `face`, los montos de la operación. Las tasas, de entrada y de salida, van como fracción (`0.042` es 4,2%). Requiere el scope `treasuries:read`.

> [!WARNING]
>
> Esta es la única ruta del dominio que responde tasas como fracción (`units: "fraction"`). La curva, su historia y `/price` responden en porcentaje. `discount_rate` de la letra `US912797VR56` vale `4.297802197802198` en `/price` y `0.0375` acá. El cupón (`coupon`) sigue en porcentaje: `4.625`.

## Convenciones

* Notas y bonos usan la convención street: `yield_to_maturity` es el rendimiento nominal anual con capitalización semestral, con interés compuesto en cada período salvo el último, que es simple. No es una tasa efectiva: la efectiva anual es `annual_equivalent_yield`. El interés corrido se devenga ACT/ACT.
* Letras: precio `100 × (1 − discount_rate × días / 360)`. `yield_to_maturity` es el rendimiento equivalente de cupón con la fórmula del Tesoro, en base 365 o 366 según la liquidación.
* La liquidación sigue el calendario de feriados de la Reserva Federal. `24hs` liquida el primer día hábil posterior a `as_of` y `CI` el mismo `as_of`, o el siguiente hábil si no lo es. El 11 de noviembre de 2026 es feriado: una operación del 10 con `24hs` liquida el 12.
* Ningún valor se redondea. Los campos que no aplican al título no vienen en la respuesta: no hay `null`.

## Parámetros de consulta

**id** `string` *required*

ISIN de 12 caracteres (`US91282CMM00`), ISIN sin dígito verificador de 11 o CUSIP de 9 (`912797VR5`). No distingue mayúsculas. Sin `id` la respuesta es 422.

**input** `string` *required*

Qué es `value`. Sin `input` la respuesta es 422 `missing_parameter`. Los valores válidos dependen del título, ver la tabla de abajo.

**value** `string` *required*

Un precio por 100 de valor nominal, en la moneda de `currency`, o una tasa como fracción (`0.042` es 4,2%). Un precio tiene que ser mayor que 0 y un rendimiento tiene que estar entre `-0.5` y `2.0`. Sin `value` la respuesta es 422 `missing_parameter`.

**as\_of** `string`

Fecha de la operación, `YYYY-MM-DD`. Predeterminado: la fecha del día del servidor. Acepta fechas futuras para valuar una operación a futuro. Tiene que haber tasas en o antes de esa fecha (desde el 2025-01-02).

**settlement\_entry** `string` (default: 24hs)

`24hs` (primer día hábil de Estados Unidos posterior a `as_of`) o `CI` (`as_of`, o el siguiente hábil si no lo es).

**currency** `string` (default: usd)

Moneda del precio que mandás en `value` y de `market_price`, `principal`, `accrued_amount` y `total`: `usd`, `ars_ccl` o `ars_mep`. En pesos, la API convierte con el dólar CCL o MEP de `as_of`, o el último publicado antes. No afecta a las tasas.

**fx\_value** `string`

Pesos por dólar que reemplazan al CCL o MEP del día. Solo con `currency=ars_ccl` o `ars_mep`, y mayor que 0.

**face** `string`

Valor nominal de la operación, mayor que 0. Suma `face`, `principal`, `accrued_amount` y `total`.

## Valores de `input`

| `input` | Qué es `value` | Notas y bonos | Letras |
| - | - | - | - |
| `price` | Precio por 100 | Precio limpio (`input_used: "clean"`) | Precio (`input_used: "price"`) |
| `clean` | Precio limpio por 100 | Sí | Igual que `price` |
| `dirty` | Precio sucio por 100 | Sí (`input_used: "dirty"`) | Igual que `price` |
| `yield` | Rendimiento al vencimiento, fracción | Rendimiento street semestral | Rendimiento equivalente de cupón |
| `annual_equivalent` | Rendimiento efectivo anual, fracción | Sí | No: 422 `invalid_input` |
| `discount_rate` | Tasa de descuento bancario, fracción | No: 422 `invalid_input` | Sí |
| `leap_year_yield` | Rendimiento equivalente de cupón en base 366, fracción | No: 422 `invalid_input` | Sí |
| `govt_equivalent` | Rendimiento equivalente de bono, street semestral, fracción | No: 422 `invalid_input` | Sí |
| `simple_act360` | Interés simple Act/360, fracción | No: 422 `invalid_input` | Sí |

> [!WARNING]
>
> En una nota o un bono, `price` es precio limpio. El `price_usd_per_100` de [`/price`](https://docs.docta.com.ar/api-reference/endpoint/treasuries-instruments-price) de una nota o un bono es sucio: pasalo con `input=dirty`.

## Ejemplo de solicitud

```bash cURL theme={null}
curl "https://api.doctacapital.com.ar/api/v1/treasuries/calculator?id=US91282CMM00&input=clean&value=101.5&face=100000" \
  -H "Authorization: Bearer $DOCTA_TOKEN"
```

## Respuesta exitosa

### Campos comunes

**isin** `string`

ISIN de 12 caracteres.

**family** `string`

`BILL` (letras y letras de caja), `NOTE` o `BOND`.

**maturity\_date** `string`

Fecha de vencimiento.

**operation\_date** `string`

Fecha de la operación (`as_of`).

**settlement\_date** `string`

Fecha de liquidación. Todas las métricas se calculan a esta fecha.

**settlement\_entry** `string`

`24hs` o `CI`.

**input\_used** `string`

Cómo se leyó `value`: `clean`, `dirty`, `price` (letras), `yield`, `annual_equivalent`, `discount_rate`, `leap_year_yield`, `govt_equivalent` o `simple_act360`.

**units** `string`

Siempre `fraction`: las tasas de esta respuesta son fracciones.

**currency** `string`

`USD`, o `ARS` con `currency` en pesos. Solo aplica a `market_price`, `principal`, `accrued_amount` y `total`.

**market\_price** `number`

Precio de mercado por 100, en `currency`. En notas y bonos es el precio limpio. En letras es el precio; si lo mandaste en `value`, vuelve tal cual.

**dirty\_price** `number`

Precio sucio en dólares por 100, cualquiera sea `currency`.

**clean\_price** `number`

Precio limpio en dólares por 100. En letras es igual a `dirty_price`.

**accrued\_interest** `number`

Interés corrido a la liquidación, en dólares por 100. `0.0` en letras.

**yield\_to\_maturity** `number`

Rendimiento al vencimiento, fracción. En notas y bonos, el street semestral; en letras, el equivalente de cupón.

**days\_to\_maturity** `integer`

Días corridos de la liquidación al vencimiento.

**duration** `number`

En años. En notas y bonos, duration de Macaulay; en letras, días al vencimiento sobre `year_basis`.

**modified\_duration** `number`

Duration modificada: variación porcentual del precio sucio por unidad de rendimiento.

**warnings** `string[]`

Solo si algo no se pudo calcular: `coupon_missing` (el catálogo no tiene el cupón y se calculó con 0), `true_yield_unavailable` o `cd_equivalent_unavailable`. El campo afectado no viene.

### Solo notas y bonos

**coupon** `number`

Tasa de cupón anual, en porcentaje (`4.625`).

**convention** `string`

Siempre `street`.

**annual\_equivalent\_yield** `number`

Rendimiento efectivo anual, fracción: `(1 + yield_to_maturity / 2)² − 1`.

**true\_yield** `number`

Rendimiento street con cada pago corrido al día hábil en que se cobra, fracción.

**current\_yield** `number`

Rendimiento corriente: cupón anual sobre precio limpio, fracción.

**convexity** `number`

Convexidad, en años al cuadrado.

**risk** `number`

Cambio del precio sucio, en dólares por 100, ante un punto porcentual de rendimiento: `modified_duration × dirty_price / 100`.

**dv01\_per\_1mm** `number`

Cambio en dólares de 1.000.000 de valor nominal ante un punto básico de rendimiento: `risk × 100`.

**prev\_coupon** `string`

Último cupón en o antes de la liquidación.

**next\_coupon** `string`

Próximo cupón.

### Solo letras

**price\_per\_100** `number`

Precio en dólares por 100.

**discount\_rate** `number`

Tasa de descuento bancario, fracción.

**coupon\_equivalent** `number`

Rendimiento equivalente de cupón, fracción. Igual a `yield_to_maturity`.

**yield\_leap\_year** `number`

Rendimiento equivalente de cupón en base 366, fracción.

**govt\_bond\_equivalent** `number`

Rendimiento equivalente de bono: el precio descontado con la convención street sobre períodos semestrales teóricos contados hacia atrás desde el vencimiento, fracción.

**simple\_interest\_act360** `number`

Interés simple Act/360, fracción.

**cd\_equivalent\_act360** `number`

Equivalente de certificado de depósito Act/360, con dos períodos cortados en la próxima fecha semestral teórica, fracción.

**value\_at\_maturity** `number`

Siempre `100.0`.

**year\_basis** `integer`

`365`, o `366` si entre la liquidación y un año después hay un 29 de febrero.

### Con `face`

**face** `number`

El valor nominal pedido.

**principal** `number`

`face × clean_price / 100`, en `currency`. En pesos, multiplicado por `fx_value`.

**accrued\_amount** `number`

`face × accrued_interest / 100`, en `currency`. En pesos, multiplicado por `fx_value`.

**total** `number`

`face × dirty_price / 100`, en `currency`: lo que se paga. En pesos, multiplicado por `fx_value`.

### Con `currency` en pesos

**fx\_used** `string`

`ccl` o `mep`.

**fx\_value** `number`

Pesos por dólar usados.

**fx\_date** `string`

Fecha del dólar usado. No viene si mandaste `fx_value`.

**overrides\_applied** `object`

Solo con `fx_value`: `{"fx_value": <el valor que mandaste>}`.

### En qué moneda viene cada precio

| Campo | Moneda |
| - | - |
| `value` de un input de precio | `currency` |
| `market_price`, `principal`, `accrued_amount`, `total` | `currency` |
| `dirty_price`, `clean_price`, `accrued_interest`, `price_per_100` | Siempre dólares por 100 |

Con `currency=ars_mep&fx_value=1480&input=clean&value=150000`, `market_price` es `150000.0` y `clean_price` es `101.35135135135135`, que es `150000 / 1480`.

## Ejemplo de respuesta exitosa

```json 200 nota, face theme={null}
{
  "isin": "US91282CMM00",
  "family": "NOTE",
  "maturity_date": "2035-02-15",
  "coupon": 4.625,
  "operation_date": "2026-11-11",
  "settlement_date": "2026-11-12",
  "settlement_entry": "24hs",
  "input_used": "clean",
  "units": "fraction",
  "currency": "USD",
  "convention": "street",
  "market_price": 101.5,
  "dirty_price": 102.61854619565217,
  "clean_price": 101.5,
  "accrued_interest": 1.1185461956521738,
  "yield_to_maturity": 0.04405432964586303,
  "annual_equivalent_yield": 0.04453952563599972,
  "true_yield": 0.04405249610847223,
  "current_yield": 0.04556650246305419,
  "duration": 6.894548592276823,
  "modified_duration": 6.745954344052409,
  "convexity": 54.416148325638304,
  "risk": 6.922600274889025,
  "dv01_per_1mm": 692.2600274889026,
  "prev_coupon": "2026-08-15",
  "next_coupon": "2027-02-15",
  "days_to_maturity": 3017,
  "face": 100000.0,
  "principal": 101500.0,
  "accrued_amount": 1118.5461956521738,
  "total": 102618.54619565216
}
```

```json 200 letra theme={null}
{
  "isin": "US912797VR56",
  "family": "BILL",
  "maturity_date": "2027-08-05",
  "operation_date": "2026-11-11",
  "settlement_date": "2026-11-12",
  "settlement_entry": "24hs",
  "input_used": "price",
  "units": "fraction",
  "currency": "USD",
  "market_price": 97.2,
  "dirty_price": 97.2,
  "clean_price": 97.2,
  "accrued_interest": 0.0,
  "price_per_100": 97.2,
  "discount_rate": 0.037894736842105294,
  "yield_to_maturity": 0.03928559435660183,
  "coupon_equivalent": 0.03928559435660183,
  "yield_leap_year": 0.03939400949326707,
  "govt_bond_equivalent": 0.03923113749631968,
  "simple_interest_act360": 0.03898635477582843,
  "cd_equivalent_act360": 0.038745170760189546,
  "days_to_maturity": 266,
  "duration": 0.7287671232876712,
  "modified_duration": 0.7170972531758097,
  "value_at_maturity": 100.0,
  "year_basis": 365
}
```

```json 200 pesos con fx_value theme={null}
{
  "isin": "US91282CMM00",
  "family": "NOTE",
  "maturity_date": "2035-02-15",
  "coupon": 4.625,
  "operation_date": "2026-11-11",
  "settlement_date": "2026-11-12",
  "settlement_entry": "24hs",
  "input_used": "clean",
  "units": "fraction",
  "currency": "ARS",
  "convention": "street",
  "market_price": 150000.0,
  "dirty_price": 102.46989754700353,
  "clean_price": 101.35135135135135,
  "accrued_interest": 1.1185461956521738,
  "yield_to_maturity": 0.04426924531777693,
  "annual_equivalent_yield": 0.044759186838028375,
  "true_yield": 0.044267400327325956,
  "current_yield": 0.04563333333333333,
  "duration": 6.893316381845625,
  "modified_duration": 6.744039609884239,
  "convexity": 54.392291312369686,
  "risk": 6.910610478777715,
  "dv01_per_1mm": 691.0610478777716,
  "prev_coupon": "2026-08-15",
  "next_coupon": "2027-02-15",
  "days_to_maturity": 3017,
  "face": 100000.0,
  "principal": 150000000.0,
  "accrued_amount": 1655448.369565217,
  "total": 151655448.36956525,
  "fx_used": "mep",
  "fx_value": 1480.0,
  "overrides_applied": {
    "fx_value": 1480.0
  }
}
```

```json 422 theme={null}
{
  "type": "/errors/validation-error",
  "title": "Validation Error",
  "status": 422,
  "detail": "'value' of a yield must be in [-0.5, 2.0], got 50.0",
  "details": {
    "code": "invalid_value"
  }
}
```

Con `currency=ars_ccl` y sin `fx_value`, la respuesta trae `fx_used: "ccl"`, `fx_value: 1678.71900826446` y `fx_date: "2026-11-06"`, el último CCL publicado antes de la operación del 11 de noviembre.

## Errores

| 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. | `'US0000000000' fails the ISIN check digit` |
| 422 | `missing_parameter` | Falta `input` o `value`. | `'value' is required` |
| 422 | `invalid_input` | `input` desconocido, un input de letras en una nota o un bono, o `annual_equivalent` en una letra. | `'discount_rate' applies to bills only` |
| 422 | `invalid_value` | `value`, `face` o `fx_value` no son números; precio menor o igual a 0; rendimiento fuera de -0,5 a 2,0; `annual_equivalent` menor o igual a -1; `face` menor o igual a 0; tasa de letra que da un precio no positivo. | `'value' of a yield must be in [-0.5, 2.0], got 50.0` |
| 422 | `invalid_settlement_entry` | `settlement_entry` distinto de `24hs` o `CI`. | `'settlement_entry' must be one of ['24hs', 'CI'], got '48hs'` |
| 422 | `invalid_currency` | `currency` fuera de `usd`, `ars_ccl`, `ars_mep`. | |
| 422 | `invalid_fx_value` | `fx_value` sin `currency` en pesos, o menor o igual a 0. | `'fx_value' needs 'currency' ars_ccl or ars_mep` |
| 422 | `invalid_date` | `as_of` mal formado o inexistente. | `'as_of' is not a calendar date: '2026-02-30'` |
| 404 | `not_in_catalog`, `excluded_tips`, `excluded_frn`, `excluded_strips`, `excluded_other` | El título no está en el catálogo o no se valúa. Trae `isin`. | `TIPS are not valued: they need the CPI index` |
| 404 | `matured` | El título vence en o antes de la liquidación. Trae `isin` y `maturity_date`. | `US9127933Y02 matured on 1980-04-03` |
| 404 | `not_issued` | La liquidación es anterior a la emisión. Trae `isin` e `issue_date`. | `US91282CMM00 is issued on 2025-02-18` |
| 422 | `no_rates_on_or_before` | `as_of` anterior a la primera curva (2025-01-02). Trae `first_rate_date`. | |
| 422 | `no_rates` | La curva del título 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`. | |
| 422 | `did_not_converge` | El precio implica un rendimiento fuera de -0,5 a 2,0. Trae `isin`. | `dirty price 1.1186461956521738 implies a yield outside [-0.5, 2.0]` |

Sin `id` la respuesta también es 422. La taxonomía completa y el orden en que se evalúan están en la [guía](https://docs.docta.com.ar/api-reference/treasuries-guia.md#errores).


## OpenAPI

````yaml GET /api/v1/treasuries/calculator
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/calculator:
    get:
      tags:
        - US Treasuries
      description: >-
        Métricas de una letra, nota o bono a partir de un precio o una tasa.
        Tasas como fracción, en value y en la respuesta (0.042 = 4,2%, units:
        fraction), a diferencia de /curve y /price, que responden en porcentaje;
        coupon sigue en porcentaje. Precios por 100 de valor nominal: value de
        un input de precio, market_price, principal, accrued_amount y total van
        en currency; dirty_price, clean_price y accrued_interest siempre en
        dólares. Notas y bonos con convención street.
      parameters:
        - name: id
          in: query
          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
          example: US91282CMM00
        - name: input
          in: query
          required: true
          description: >-
            Qué es value. Notas y bonos: price (precio limpio), clean, dirty,
            yield, annual_equivalent. Letras: price, clean, dirty, yield,
            discount_rate, leap_year_yield, govt_equivalent, simple_act360.
          schema:
            type: string
            enum:
              - price
              - dirty
              - clean
              - yield
              - discount_rate
              - leap_year_yield
              - govt_equivalent
              - simple_act360
              - annual_equivalent
          example: yield
        - name: value
          in: query
          required: true
          description: >-
            Precio por 100 en currency (mayor que 0) o tasa como fracción
            (rendimientos entre -0.5 y 2.0).
          schema:
            type: number
          example: 0.042
        - name: as_of
          in: query
          required: false
          description: >-
            Fecha de la operación, YYYY-MM-DD. Predeterminado: hoy. Acepta
            fechas futuras.
          schema:
            type: string
            format: date
        - name: settlement_entry
          in: query
          required: false
          description: >-
            24hs (primer día hábil de EE.UU. posterior a as_of) o CI (as_of, o
            el siguiente hábil).
          schema:
            type: string
            enum:
              - 24hs
              - CI
            default: 24hs
        - name: currency
          in: query
          required: false
          description: >-
            Moneda de un value de precio y de market_price, principal,
            accrued_amount y total.
          schema:
            type: string
            enum:
              - usd
              - ars_ccl
              - ars_mep
            default: usd
        - name: fx_value
          in: query
          required: false
          description: >-
            Pesos por dólar que reemplazan al CCL o MEP del día. Solo con
            currency ars_ccl o ars_mep.
          schema:
            type: number
            exclusiveMinimum: 0
          example: 1480
        - name: face
          in: query
          required: false
          description: Valor nominal. Agrega face, principal, accrued_amount y total.
          schema:
            type: number
            exclusiveMinimum: 0
          example: 100000
      responses:
        '200':
          description: Métricas del título
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TreasuryCalculatorResponse'
              example:
                isin: US91282CMM00
                family: NOTE
                maturity_date: '2035-02-15'
                coupon: 4.625
                operation_date: '2026-11-11'
                settlement_date: '2026-11-12'
                settlement_entry: 24hs
                input_used: clean
                units: fraction
                currency: USD
                convention: street
                market_price: 101.5
                dirty_price: 102.61854619565217
                clean_price: 101.5
                accrued_interest: 1.1185461956521738
                yield_to_maturity: 0.04405432964586303
                annual_equivalent_yield: 0.04453952563599972
                true_yield: 0.04405249610847223
                current_yield: 0.04556650246305419
                duration: 6.894548592276823
                modified_duration: 6.745954344052409
                convexity: 54.416148325638304
                risk: 6.922600274889025
                dv01_per_1mm: 692.2600274889026
                prev_coupon: '2026-08-15'
                next_coupon: '2027-02-15'
                days_to_maturity: 3017
                face: 100000
                principal: 101500
                accrued_amount: 1118.5461956521738
                total: 102618.54619565216
        '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: >-
            not_in_catalog, matured, not_issued, excluded_tips, excluded_frn,
            excluded_strips o excluded_other
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TreasuryError'
              example:
                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
        '422':
          description: >-
            invalid_id, missing_parameter, invalid_input, invalid_value,
            invalid_settlement_entry, invalid_currency, invalid_fx_value,
            invalid_date, no_rates_on_or_before, no_rates, no_fx o
            did_not_converge
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TreasuryError'
              example:
                type: /errors/validation-error
                title: Validation Error
                status: 422
                detail: '''value'' of a yield must be in [-0.5, 2.0], got 50.0'
                details:
                  code: invalid_value
        '429':
          description: Límite de requests de tu plan superado
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TreasuryError'
      security:
        - bearerAuth: []
components:
  schemas:
    TreasuryCalculatorResponse:
      type: object
      properties:
        isin:
          type: string
        family:
          type: string
          enum:
            - BILL
            - NOTE
            - BOND
        maturity_date:
          type: string
          format: date
        coupon:
          type: number
          description: 'Notas y bonos: cupón anual en porcentaje'
        operation_date:
          type: string
          format: date
        settlement_date:
          type: string
          format: date
        settlement_entry:
          type: string
          enum:
            - 24hs
            - CI
        input_used:
          type: string
        units:
          type: string
          enum:
            - fraction
        currency:
          type: string
          enum:
            - USD
            - ARS
        convention:
          type: string
          description: Notas y bonos
          enum:
            - street
        market_price:
          type: number
          description: Precio por 100 en currency
        dirty_price:
          type: number
          description: Dólares por 100
        clean_price:
          type: number
          description: Dólares por 100
        accrued_interest:
          type: number
          description: Dólares por 100
        price_per_100:
          type: number
          description: 'Letras: dólares por 100'
        discount_rate:
          type: number
          description: Letras, fracción
        yield_to_maturity:
          type: number
          description: fracción
        coupon_equivalent:
          type: number
          description: Letras, fracción
        yield_leap_year:
          type: number
          description: Letras, fracción
        govt_bond_equivalent:
          type: number
          description: Letras, fracción
        simple_interest_act360:
          type: number
          description: Letras, fracción
        cd_equivalent_act360:
          type: number
          description: Letras, fracción
        annual_equivalent_yield:
          type: number
          description: Notas y bonos, fracción
        true_yield:
          type: number
          description: Notas y bonos, fracción
        current_yield:
          type: number
          description: Notas y bonos, fracción
        days_to_maturity:
          type: integer
          description: Desde la liquidación
        duration:
          type: number
          description: Años
        modified_duration:
          type: number
        convexity:
          type: number
          description: Notas y bonos
        risk:
          type: number
          description: 'Notas y bonos: dólares por 100 por punto porcentual'
        dv01_per_1mm:
          type: number
          description: 'Notas y bonos: dólares por punto básico por 1.000.000 nominal'
        prev_coupon:
          type: string
          format: date
        next_coupon:
          type: string
          format: date
        value_at_maturity:
          type: number
          description: 'Letras: 100'
        year_basis:
          type: integer
          description: 'Letras: 365 o 366'
        warnings:
          type: array
          items:
            type: string
            enum:
              - coupon_missing
              - true_yield_unavailable
              - cd_equivalent_unavailable
        face:
          type: number
        principal:
          type: number
          description: En currency
        accrued_amount:
          type: number
          description: En currency
        total:
          type: number
          description: En currency
        fx_used:
          type: string
          enum:
            - ccl
            - mep
        fx_value:
          type: number
        fx_date:
          type: string
          format: date
        overrides_applied:
          type: object
          properties:
            fx_value:
              type: number
    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.