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

# KPIs de mercado FCI

> KPIs de la industria a una fecha de referencia: fondos vigentes, AUM total, gestoras activas, tipo de cambio aplicado y última fecha de cierre.

<Note>
  KPIs de la industria de FCI a una fecha de referencia: fondos vigentes, AUM total en la moneda de salida, gestoras activas, tipo de cambio aplicado y último cierre. Requiere el scope `fci:read`.
</Note>

## Parámetros de consulta

<ParamField query="date" type="string">
  Fecha de referencia en formato YYYY-MM-DD (predeterminado: último cierre).
</ParamField>

<ParamField query="target_currency" type="string">
  Moneda de salida: `ARS` o `USD` (predeterminado `ARS`).
</ParamField>

<ParamField query="fx_kind" type="string">
  Tipo de cambio usado para la conversión de moneda (predeterminado `mep`).
</ParamField>

<Info>
  Valores válidos para <code>fx\_kind</code>:

  * <code>mep</code>
  * <code>ccl</code>
  * <code>a3500</code>
  * <code>oficial\_minorista</code>
</Info>

<ParamField query="vigent_days_window" type="integer">
  Días sin cotización antes de que un fondo deje de contarse como vigente (predeterminado 5, rango 1-60).
</ParamField>

## Ejemplo de Solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.doctacapital.com.ar/api/v1/fci/market/kpis?target_currency=ARS&fx_kind=mep" \
    -H "Authorization: Bearer $DOCTA_TOKEN"
  ```
</RequestExample>

## Respuesta Exitosa

<ResponseField name="reference_date" type="string">
  Fecha de referencia efectiva (YYYY-MM-DD).
</ResponseField>

<ResponseField name="data_lag" type="boolean">
  Indica si la fecha de referencia quedó rezagada respecto de la fecha solicitada por falta de datos más recientes.
</ResponseField>

<ResponseField name="target_currency" type="string">
  Moneda de salida aplicada.
</ResponseField>

<ResponseField name="fx_kind" type="string">
  Tipo de cambio aplicado.
</ResponseField>

<ResponseField name="kpis" type="object">
  KPIs de la industria.
</ResponseField>

<ResponseField name="kpis.vigent_funds" type="integer">
  Cantidad de fondos vigentes a la fecha de referencia.
</ResponseField>

<ResponseField name="kpis.total_aum" type="number">
  AUM total de la industria, expresado en `target_currency`.
</ResponseField>

<ResponseField name="kpis.active_managers" type="integer">
  Cantidad de gestoras activas.
</ResponseField>

<ResponseField name="kpis.fx_rate" type="number">
  Tipo de cambio aplicado a la conversión.
</ResponseField>

<ResponseField name="kpis.last_close_date" type="string">
  Fecha del último cierre disponible (YYYY-MM-DD).
</ResponseField>

<ResponseField name="data_quality" type="object">
  Metadatos de calidad: `funds_total`, `funds_with_real_data`, `funds_excluded`, `fx_carried_forward`, `vigent_threshold_days` y `reference_date`.
</ResponseField>

## Ejemplo de Respuesta Exitosa

<ResponseExample>
  ```json Success theme={null}
  {
    "reference_date": "2026-07-30",
    "data_lag": true,
    "target_currency": "ARS",
    "fx_kind": "mep",
    "kpis": {
      "vigent_funds": 2431,
      "total_aum": 105081584883560.12,
      "active_managers": 57,
      "fx_rate": 1508.42945874002,
      "last_close_date": "2026-07-30"
    },
    "data_quality": {
      "funds_total": 4672,
      "funds_with_real_data": 4672,
      "funds_excluded": 0,
      "fx_carried_forward": false,
      "vigent_threshold_days": 5,
      "reference_date": "2026-07-30"
    }
  }
  ```
</ResponseExample>


## OpenAPI

````yaml GET /api/v1/fci/market/kpis
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/fci/market/kpis:
    get:
      tags:
        - FCI
      description: >-
        KPIs de la industria a una fecha de referencia: fondos vigentes, AUM
        total, gestoras activas, tipo de cambio aplicado y última fecha de
        cierre.
      parameters:
        - name: date
          in: query
          required: false
          schema:
            type: string
            pattern: ^\d{4}-\d{2}-\d{2}$
            description: 'Reference date YYYY-MM-DD (default: last close)'
        - name: target_currency
          in: query
          required: false
          schema:
            enum:
              - ARS
              - USD
            type: string
            description: Output currency
            default: ARS
        - name: fx_kind
          in: query
          required: false
          schema:
            enum:
              - mep
              - ccl
              - a3500
              - oficial_minorista
            type: string
            description: FX rate used for currency conversion
            default: mep
        - name: vigent_days_window
          in: query
          required: false
          schema:
            type: integer
            maximum: 60
            minimum: 1
            description: Days without quotes before a fund stops counting as vigent
            default: 5
      responses:
        '200':
          description: KPIs de mercado
          content:
            application/json:
              schema:
                type: object
              example:
                reference_date: '2026-07-30'
                data_lag: true
                target_currency: ARS
                fx_kind: mep
                kpis:
                  vigent_funds: 2431
                  total_aum: 105081584883560.12
                  active_managers: 57
                  fx_rate: 1508.42945874002
                  last_close_date: '2026-07-30'
                data_quality:
                  funds_total: 4672
                  funds_with_real_data: 4672
                  funds_excluded: 0
                  fx_carried_forward: false
                  vigent_threshold_days: 5
                  reference_date: '2026-07-30'
        '401':
          description: Autenticación requerida
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '403':
          description: 'Permisos insuficientes: requiere el scope fci:read'
          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:
    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

````