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

# Detalle de dólar futuro

> Detalle de un contrato de dólar futuro por ticker exacto: los campos del screener más apertura, máximo y mínimo de la rueda, y el spot A3500. 404 si el ticker no cumple ^DLR/[A-Z]{3}\d{2}$ o no existe.

> [!NOTE]
>
> Devuelve un contrato de dólar futuro de A3 por ticker exacto: los mismos campos del [listado](https://docs.docta.com.ar/api-reference/endpoint/futures-instruments.md) más apertura, máximo y mínimo de la rueda, y el dólar mayorista A3500 de referencia. Datos en tiempo real, sin demora. Requiere el scope `futures:read`.

## Parámetros de ruta

**ticker** `string` *required*

Ticker del contrato. Lleva la barra: `/futures/instruments/DLR/NOV26`. También se acepta URL-encodeado: `/futures/instruments/DLR%2FNOV26`.

> [!NOTE]
>
> La coincidencia es exacta y no normaliza mayúsculas: `dlr/nov26` da 404. `DLR/DIC26` devuelve ese contrato y nunca su gemelo `DLR/DIC26M`. Solo se aceptan tickers que cumplen `^DLR/[A-Z]3\d2$`: los gemelos `M` y `DLR/PF0` responden 404, igual que un contrato que no existe.

## Ejemplo de Solicitud

```bash cURL theme={null}
curl -X GET "https://api.doctacapital.com.ar/api/v1/futures/instruments/DLR/NOV26" \
  -H "Authorization: Bearer $DOCTA_TOKEN"
```

## Respuesta Exitosa

**spot** `object`

Dólar mayorista de referencia: `ticker` (`TC_OFICIAL_MAYORISTA`), `price` (cotización A3500 en ARS) y `date` (YYYY-MM-DD).

**instrument** `object`

El contrato. Trae todos los campos del listado y además `opening_price`, `high_price` y `low_price`. Un campo sin dato vuelve en `null`.

**instrument.ticker** `string`

Ticker del contrato.

**instrument.maturity\_date** `string`

Vencimiento del contrato (YYYY-MM-DD).

**instrument.days\_to\_maturity** `integer | null`

Días al vencimiento.

**instrument.last\_price** `number | null`

Último precio operado.

**instrument.closing\_price** `number | null`

Último precio operado de la última rueda completa.

**instrument.variation** `number | null`

`last_price / closing_price - 1`, en decimal.

**instrument.opening\_price** `number | null`

Precio de apertura de la rueda.

**instrument.high\_price** `number | null`

Precio máximo de la rueda.

**instrument.low\_price** `number | null`

Precio mínimo de la rueda.

**instrument.trade\_volume** `number | null`

Contratos operados en la rueda.

**instrument.bid\_price** `number | null`

Mejor compra. `bid_size` es la cantidad de contratos a ese precio.

**instrument.offer\_price** `number | null`

Mejor venta. `offer_size` es la cantidad de contratos a ese precio.

**instrument.open\_interest** `number | null`

Interés abierto.

**instrument.implied\_rate** `number | null`

Tasa directa: `precio del contrato / dólar mayorista (A3500) - 1`, en decimal.

**instrument.tna** `number | null`

Tasa nominal anual, en decimal.

**instrument.tea** `number | null`

Tasa efectiva anual, en decimal.

**instrument.forward\_tem** `number | null`

Tasa forward entre este contrato y el anterior, efectiva mensual, en decimal. Para el primer vencimiento se calcula contra el A3500.

**instrument.operation\_date** `string | null`

Fecha y hora del último tick, en ISO 8601 con offset.

## Ejemplo de Respuesta Exitosa

```json Success theme={null}
{
  "spot": {
    "ticker": "TC_OFICIAL_MAYORISTA",
    "price": 1541.0,
    "date": "2026-10-29"
  },
  "instrument": {
    "ticker": "DLR/NOV26",
    "maturity_date": "2026-11-30",
    "days_to_maturity": 32,
    "last_price": 1568.0,
    "closing_price": 1570.5,
    "variation": -0.0015918497293855305,
    "trade_volume": 142615.0,
    "bid_price": 1567.5,
    "bid_size": 11170.0,
    "offer_price": 1568.0,
    "offer_size": 1060.0,
    "open_interest": 1125435,
    "implied_rate": 0.01752109020116807,
    "tna": 0.1998499351070733,
    "tea": 0.21921110908860508,
    "forward_tem": 0.0172,
    "operation_date": "2026-10-29T14:41:44.647000-03:00",
    "opening_price": 1568.5,
    "high_price": 1570.0,
    "low_price": 1567.5
  }
}
```


## OpenAPI

````yaml GET /api/v1/futures/instruments/{ticker}
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/instruments/{ticker}:
    get:
      tags:
        - Dólar futuro
      description: >-
        Detalle de un contrato de dólar futuro por ticker exacto: los campos del
        screener más apertura, máximo y mínimo de la rueda, y el spot A3500. 404
        si el ticker no cumple ^DLR/[A-Z]{3}\d{2}$ o no existe.
      parameters:
        - name: ticker
          in: path
          required: true
          schema:
            type: string
            pattern: ^DLR/[A-Z]{3}\d{2}$
            description: >-
              Ticker exacto del contrato, con la barra (DLR/NOV26) o
              URL-encodeado (DLR%2FNOV26). No se normalizan mayúsculas:
              dlr/nov26 da 404.
            example: DLR/NOV26
      responses:
        '200':
          description: Detalle del contrato
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FuturesInstrumentDetailResponse'
              example:
                spot:
                  ticker: TC_OFICIAL_MAYORISTA
                  price: 1541
                  date: '2026-10-29'
                instrument:
                  ticker: DLR/NOV26
                  maturity_date: '2026-11-30'
                  days_to_maturity: 32
                  last_price: 1568
                  closing_price: 1570.5
                  variation: -0.0015918497293855305
                  trade_volume: 142615
                  bid_price: 1567.5
                  bid_size: 11170
                  offer_price: 1568
                  offer_size: 1060
                  open_interest: 1125435
                  implied_rate: 0.01752109020116807
                  tna: 0.1998499351070733
                  tea: 0.21921110908860508
                  forward_tem: 0.0172
                  operation_date: '2026-10-29T14:41:44.647000-03:00'
                  opening_price: 1568.5
                  high_price: 1570
                  low_price: 1567.5
        '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'
        '404':
          description: Contrato no encontrado o ticker fuera del patrón ^DLR/[A-Z]{3}\d{2}$
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '422':
          description: Parámetros inválidos
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - bearerAuth: []
components:
  schemas:
    FuturesInstrumentDetailResponse:
      type: object
      properties:
        spot:
          $ref: '#/components/schemas/FuturesSpot'
        instrument:
          $ref: '#/components/schemas/FutureContractDetail'
      required:
        - spot
        - instrument
    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
    FuturesSpot:
      type: object
      description: >-
        Dólar mayorista de referencia (A3500) contra el que se calculan
        implied_rate y el primer forward_tem.
      properties:
        ticker:
          type: string
          description: Identificador del spot.
          example: TC_OFICIAL_MAYORISTA
        price:
          type:
            - number
            - 'null'
          description: Cotización del dólar mayorista A3500, en ARS.
        date:
          type:
            - string
            - 'null'
          format: date
          description: Fecha de la cotización (YYYY-MM-DD).
      required:
        - ticker
        - price
        - date
    FutureContractDetail:
      allOf:
        - $ref: '#/components/schemas/FutureContract'
        - type: object
          properties:
            opening_price:
              type:
                - number
                - 'null'
              description: Precio de apertura de la rueda, en ARS.
            high_price:
              type:
                - number
                - 'null'
              description: Precio máximo de la rueda, en ARS.
            low_price:
              type:
                - number
                - 'null'
              description: Precio mínimo de la rueda, en ARS.
          required:
            - opening_price
            - high_price
            - low_price
    FutureContract:
      type: object
      description: >-
        Contrato de dólar futuro de A3. Los campos sin dato vuelven en null,
        nunca se omiten.
      properties:
        ticker:
          type: string
          description: Ticker del contrato en A3 (Matba Rofex). Cumple ^DLR/[A-Z]{3}\d{2}$.
          example: DLR/NOV26
        maturity_date:
          type: string
          format: date
          description: Vencimiento del contrato (YYYY-MM-DD).
        days_to_maturity:
          type:
            - integer
            - 'null'
          description: Días al vencimiento.
        last_price:
          type:
            - number
            - 'null'
          description: Último precio operado, en ARS.
        closing_price:
          type:
            - number
            - 'null'
          description: Último precio operado de la última rueda completa, en ARS.
        variation:
          type:
            - number
            - 'null'
          description: last_price / closing_price - 1, en decimal.
        trade_volume:
          type:
            - number
            - 'null'
          description: Contratos operados en la rueda.
        bid_price:
          type:
            - number
            - 'null'
          description: Mejor precio de compra, en ARS.
        bid_size:
          type:
            - number
            - 'null'
          description: Cantidad de contratos a la mejor compra.
        offer_price:
          type:
            - number
            - 'null'
          description: Mejor precio de venta, en ARS.
        offer_size:
          type:
            - number
            - 'null'
          description: Cantidad de contratos a la mejor venta.
        open_interest:
          type:
            - number
            - 'null'
          description: Interés abierto.
        implied_rate:
          type:
            - number
            - 'null'
          description: >-
            Tasa directa: precio del contrato / dólar mayorista (A3500) - 1, en
            decimal.
        tna:
          type:
            - number
            - 'null'
          description: Tasa nominal anual, en decimal.
        tea:
          type:
            - number
            - 'null'
          description: Tasa efectiva anual, en decimal.
        forward_tem:
          type:
            - number
            - 'null'
          description: >-
            Tasa forward efectiva mensual entre este contrato y el anterior, en
            decimal. Para el primer contrato se calcula contra el A3500.
        operation_date:
          type:
            - string
            - 'null'
          format: date-time
          description: >-
            Fecha y hora del último tick, ISO 8601 con offset, tal como llega
            del feed.
      required:
        - ticker
        - maturity_date
        - days_to_maturity
        - last_price
        - closing_price
        - variation
        - trade_volume
        - bid_price
        - bid_size
        - offer_price
        - offer_size
        - open_interest
        - implied_rate
        - tna
        - tea
        - forward_tem
        - operation_date
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````

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