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

# Bandas cambiarias

> Bandas cambiarias del BCRA (piso y techo) más su proyección con un supuesto de inflación mensual. La serie arranca dos días antes de hoy. Las filas con is_projected = true son proyección, no dato del BCRA. Se cruza con /futures/instruments para el gráfico Futuros y bandas.

> [!NOTE]
>
> Devuelve el piso y el techo de las bandas cambiarias del BCRA y su proyección con un supuesto de inflación mensual. Cruzado con el [listado de contratos](https://docs.docta.com.ar/api-reference/endpoint/futures-instruments.md), arma el gráfico "Futuros y bandas". Requiere el scope `futures:read`.

> [!WARNING]
>
> Las filas con `is_projected = true` no son dato del BCRA. Son una proyección de Docta con el supuesto de `monthly_inflation`, y cambian si cambiás ese parámetro. Las filas oficiales llegan hasta `last_official_date`.

## Parámetros de consulta

**monthly\_inflation** `number` (default: 0.01)

Supuesto de inflación mensual para la proyección, en decimal (0.01 = 1 %). Debe ser mayor o igual a 0.

**date\_to** `string`

Última fecha de la serie, en formato YYYY-MM-DD. Predeterminado: `maturity_date` del último contrato vigente, así las bandas cubren toda la curva de futuros.

## Ejemplo de Solicitud

```bash cURL theme={null}
curl -X GET "https://api.doctacapital.com.ar/api/v1/futures/tc-bands?monthly_inflation=0.01" \
  -H "Authorization: Bearer $DOCTA_TOKEN"
```

## Respuesta Exitosa

**monthly\_inflation** `number`

Supuesto de inflación mensual usado para las filas proyectadas, en decimal.

**last\_official\_date** `string | null`

Última fecha con dato oficial del BCRA (YYYY-MM-DD). Las fechas posteriores son proyección.

**columns** `string[]`

Nombres de columna, siempre en este orden: `date`, `lower_band`, `upper_band`, `is_projected`.

**rows** `array`

Una fila por fecha, con los valores en el orden de `columns`. La serie arranca dos días antes de hoy. `date` va en YYYY-MM-DD, `lower_band` y `upper_band` son números en ARS por dólar, e `is_projected` es `true` si la fila es proyección.

> [!NOTE]
>
> Si nexus todavía no tiene las bandas en caché, la API responde 503. Reintentá más tarde.

## Armar "Futuros y bandas"

**1. Pedí las dos series**

Llamá a este endpoint y a [`GET /api/v1/futures/instruments`](https://docs.docta.com.ar/api-reference/endpoint/futures-instruments). Si no mandás `date_to`, las bandas terminan en el vencimiento del último contrato.

**2. Graficá las bandas**

Con `date` en el eje X, dibujá `lower_band` y `upper_band` como dos líneas. Distinguí visualmente el tramo con `is_projected = true` del tramo oficial.

**3. Superponé los contratos**

Cada contrato de `instruments` es un punto con `maturity_date` en X y `last_price` en Y. Así ves dónde opera cada vencimiento respecto del piso y el techo.

## Ejemplo de Respuesta Exitosa

```json Success theme={null}
{
  "monthly_inflation": 0.01,
  "last_official_date": "2026-11-30",
  "columns": ["date", "lower_band", "upper_band", "is_projected"],
  "rows": [
    ["2026-10-27", 713.54, 1947.79, false],
    ["2026-12-01", 698.21, 1989.78, true]
  ]
}
```


## OpenAPI

````yaml GET /api/v1/futures/tc-bands
openapi: 3.1.0
info:
  title: API de Docta
  description: >-
    API de mercado argentino: bonos (instrumentos, cashflows, curvas/yields),
    FCI (screener, series, performance, comparaciones y analytics de industria)
    y dólar futuro de A3 (contratos en tiempo real, velas diarias y bandas
    cambiarias).
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.doctacapital.com.ar
security: []
paths:
  /api/v1/futures/tc-bands:
    get:
      tags:
        - Dólar futuro
      description: >-
        Bandas cambiarias del BCRA (piso y techo) más su proyección con un
        supuesto de inflación mensual. La serie arranca dos días antes de hoy.
        Las filas con is_projected = true son proyección, no dato del BCRA. Se
        cruza con /futures/instruments para el gráfico Futuros y bandas.
      parameters:
        - name: monthly_inflation
          in: query
          required: false
          schema:
            type: number
            minimum: 0
            default: 0.01
            description: >-
              Supuesto de inflación mensual para la proyección, en decimal (0.01
              = 1 %).
        - name: date_to
          in: query
          required: false
          schema:
            type: string
            pattern: ^\d{4}-\d{2}-\d{2}$
            description: >-
              Última fecha de la serie YYYY-MM-DD. Predeterminado: maturity_date
              del último contrato vigente.
      responses:
        '200':
          description: Bandas cambiarias oficiales y proyectadas
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FuturesTcBandsResponse'
              example:
                monthly_inflation: 0.01
                last_official_date: '2026-11-30'
                columns:
                  - date
                  - lower_band
                  - upper_band
                  - is_projected
                rows:
                  - - '2026-10-27'
                    - 713.54
                    - 1947.79
                    - false
                  - - '2026-12-01'
                    - 698.21
                    - 1989.78
                    - true
        '401':
          description: Autenticación requerida
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: 'Permisos insuficientes: requiere el scope futures:read'
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Parámetros inválidos
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '503':
          description: >-
            Bandas no disponibles: nexus todavía no tiene las bandas cambiarias
            en caché
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - bearerAuth: []
components:
  schemas:
    FuturesTcBandsResponse:
      type: object
      properties:
        monthly_inflation:
          type: number
          description: Supuesto de inflación mensual usado para la proyección, en decimal.
        last_official_date:
          type:
            - string
            - 'null'
          format: date
          description: Última fecha con dato oficial del BCRA (YYYY-MM-DD).
        columns:
          type: array
          description: Nombres de columna, siempre en este orden.
          items:
            type: string
            enum:
              - date
              - lower_band
              - upper_band
              - is_projected
        rows:
          type: array
          description: >-
            Una fila por fecha: [date, lower_band, upper_band, is_projected].
            Las filas con is_projected = true son proyección con
            monthly_inflation, no dato del BCRA.
          items:
            type: array
            items:
              type:
                - string
                - number
                - boolean
                - 'null'
      required:
        - monthly_inflation
        - last_official_date
        - columns
        - rows
    Error:
      required:
        - type
        - title
        - status
        - detail
        - correlation_id
      type: object
      properties:
        type:
          description: El identificador del tipo de error
          type: string
          example: /errors/authentication-required
        title:
          description: Una breve descripción del error
          type: string
          example: Invalid client credentials
        status:
          description: El código de estado HTTP
          type: integer
          example: 401
        detail:
          description: Una descripción detallada del error
          type: string
          example: Invalid client credentials
        correlation_id:
          description: Un identificador único para rastrear esta solicitud de error
          type: string
          format: uuid
          example: 2eb07802-94de-468a-b70f-75a49f3e9516
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.