# Obtener Token de Acceso
Source: https://docs.doctacapital.com.ar/api-reference/endpoint/auth-token

POST /api/v1/auth/token
Obtener un token de acceso usando credenciales de cliente para la autenticación de la API

<Note>
  Este endpoint se utiliza para obtener un token de acceso usando credenciales de cliente para la autenticación de la API.
</Note>

## Cuerpo de la Solicitud

El cuerpo de la solicitud debe contener los siguientes campos requeridos:

<ParamField type="string">
  El tipo de concesión OAuth 2.0. Debe establecerse en `client_credentials`.
</ParamField>

<ParamField type="string">
  Tu identificador de cliente proporcionado por Docta.
</ParamField>

<ParamField type="string">
  Tu secreto de cliente proporcionado por Docta.
</ParamField>

## Ejemplo de Solicitud

```bash theme={null}
curl -X POST https://api.doctacapital.com.ar/api/v1/auth/token/ \
  -H "Content-Type: application/json" \
  -d '{
    "grant_type": "client_credentials",
    "client_id": "your-client-id",
    "client_secret": "your-client-secret",
    "scope": "bonds:read cedears:read stocks:read"
  }'
```

## Respuesta Exitosa

<ResponseField name="access_token" type="string">
  El token de acceso a ser usado para solicitudes posteriores de la API.
</ResponseField>

<ResponseField name="token_type" type="string">
  El tipo de token. Será `Bearer`.
</ResponseField>

<ResponseField name="expires_in" type="integer">
  El número de segundos hasta que el token expire.
</ResponseField>

<ResponseField name="scope" type="string">
  El alcance de acceso otorgado por este token.
</ResponseField>

<ResponseField name="plan" type="string">
  El plan asociado al token. Puede ser `basic`, `professional` o `enterprise`.
</ResponseField>

## Ejemplo de Respuesta Exitosa

```json theme={null}
{
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJwcm9kLWJhc3Rpb24tMDAxIiwiY2xpZW50X2lkIjoicHJvZC1iYXN0aW9uLTAwMSIsInNjb3BlcyI6WyJtYXJrZXRfZGF0YTpyZWFkIl0sInBsYW4iOiJlbnRlcnByaXNlIiwidG9rZW5fdHlwZSI6ImJlYXJlciIsImV4cCI6MTc1NzQ1Njg5OSwiaWF0IjoxNzU3NDUzMjk5fQ.zbvaoJLRwXFgW0aYG3DiZQM3p_4BZ3SNWj1mZEtN9wU",
    "token_type": "bearer",
    "expires_in": 3600,
    "scope": "bonds:read cedears:read stocks:read",
    "plan": "enterprise"
}
```

## Respuesta de Error

<ResponseField name="type" type="string">
  El identificador del tipo de error.
</ResponseField>

<ResponseField name="title" type="string">
  Una breve descripción del error.
</ResponseField>

<ResponseField name="status" type="integer">
  El código de estado HTTP.
</ResponseField>

<ResponseField name="detail" type="string">
  Una descripción detallada del error.
</ResponseField>

<ResponseField name="correlation_id" type="string">
  Un identificador único para rastrear esta solicitud de error.
</ResponseField>

## Ejemplo de Respuesta de Error

```json theme={null}
{
  "type": "/errors/authentication-required",
  "title": "Invalid client credentials",
  "status": 401,
  "detail": "Invalid client credentials",
  "correlation_id": "2eb07802-94de-468a-b70f-75a49f3e9516"
}
```


# Calculadora
Source: https://docs.doctacapital.com.ar/api-reference/endpoint/bonds-calculadora

POST /api/v1/analytics/bonds/pricer
Calcula TIR, TNA, TEM, TNA_30_360, VT, VR, Precio Dirty, Intereses Corridos, de un bono en función de un precio  dirty objetivo, una fecha de concertación y un plazo de liquidación (CI, 24hs, 48hs)

<Note>
  Este endpoint calcula métricas de pricing y análisis de un bono específico basado en parámetros de precio objetivo.
</Note>

## Cuerpo de la Solicitud

<ParamField type="string">
  El símbolo del bono (ej., "AL30", "GD30").
</ParamField>

<ParamField type="string">
  El objetivo del cálculo. Debe ser `"price"` para calcular métricas basadas en un precio objetivo.
</ParamField>

<ParamField type="number">
  El precio objetivo del bono.
</ParamField>

<ParamField type="string">
  El tipo de liquidación. Puede ser `"24hs"` para liquidación en 24 horas, `"48hs"` para liquidación en 48 horas o `"C.I"` para contado inmediato.
</ParamField>

<ParamField type="string">
  La fecha de operación en formato YYYY-MM-DD (ej., "2025-11-16").
</ParamField>

## Ejemplo de Solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.doctacapital.com.ar/api/v1/analytics/bonds/pricer" \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
    -H "Content-Type: application/json" \
    -d '{
      "ticker": "AL30D",
      "target": "price",
      "value": 65,
      "settlement_entry": "24hs",
      "operation_date": "2025-11-19"
    }'
  ```
</RequestExample>

## Respuesta Exitosa

<ResponseField name="clean_price" type="number">
  Precio limpio del bono (sin intereses devengados).
</ResponseField>

<ResponseField name="dirty_price" type="number">
  Precio sucio del bono (incluyendo intereses devengados).
</ResponseField>

<ResponseField name="residual_value" type="number">
  Valor residual del bono.
</ResponseField>

<ResponseField name="tv" type="number">
  Valor técnico del bono.
</ResponseField>

<ResponseField name="accured_interest" type="number">
  Interés devengado.
</ResponseField>

<ResponseField name="days_to_maturity" type="integer">
  Días hasta el vencimiento del bono.
</ResponseField>

<ResponseField name="settlment_date" type="string">
  Fecha de liquidación en formato YYYY-MM-DD.
</ResponseField>

<ResponseField name="parity_price" type="number">
  Paridad del bono.
</ResponseField>

<ResponseField name="tir" type="number">
  Tasa Interna de Retorno (TIR) del bono.
</ResponseField>

<ResponseField name="tea" type="number">
  Tasa Efectiva Anual (TEA) del bono.
</ResponseField>

<ResponseField name="tem" type="number">
  Tasa Efectiva Mensual (TEM) del bono.
</ResponseField>

<ResponseField name="tna" type="number">
  Tasa Nominal Anual (TNA) del bono.
</ResponseField>

<ResponseField name="tna_30_360" type="number">
  Tasa Nominal Anual calculada con base 30/360.
</ResponseField>

<ResponseField name="margen" type="number">
  Margen del bono.
</ResponseField>

<ResponseField name="duration" type="number">
  Duración del bono.
</ResponseField>

<ResponseField name="badlar_last5" type="number">
  Promedio de la tasa BADLAR de los últimos 5 días.
</ResponseField>

<ResponseField name="price_variation" type="number">
  Variación de precio.
</ResponseField>

<ResponseField name="market_price" type="number">
  Precio sucio implícito. Se devuelve **en lugar de** `clean_price`, `dirty_price` y `tir`
  cuando se consulta con `target: "tir"`.
</ResponseField>

<ResponseField name="cer_settlment_date" type="number | null">
  Valor del índice CER a la fecha de liquidación. Solo en bonos ajustados por CER.
</ResponseField>

<ResponseField name="cer_issue_date" type="number | null">
  Valor del índice CER a la fecha de emisión. Solo en bonos ajustados por CER.
</ResponseField>

<ResponseField name="uva_settlment_date" type="number | null">
  Valor UVA a la fecha de liquidación. Solo en bonos ajustados por UVA.
</ResponseField>

<ResponseField name="uva_issue_date" type="number | null">
  Valor UVA a la fecha de emisión. Solo en bonos ajustados por UVA.
</ResponseField>

<ResponseField name="tc_oficial" type="number | null">
  Tipo de cambio oficial aplicado. Solo en bonos dollar-linked.
</ResponseField>

<ResponseField name="dolar_mep" type="number | null">
  Dólar MEP aplicado. Solo en bonos en dólares.
</ResponseField>

<Note>
  La forma de la respuesta depende de `target`: con `target: "price"` se devuelven
  `clean_price`, `dirty_price` y `tir`; con `target: "tir"` se devuelve `market_price` en su
  lugar. Los campos `margen` y `badlar_last5` solo aparecen en bonos de tasa variable
  (BADLAR/TAMAR), y los campos CER, UVA, `tc_oficial` y `dolar_mep` solo cuando aplica el
  ajuste correspondiente al bono.
</Note>

## Ejemplo de Respuesta Exitosa

<ResponseExample>
  ```json Success theme={null}
  {
    "clean_price": 80.98082191780821,
    "dirty_price": 65,
    "residual_value": 80,
    "tv": 80.21534246575342,
    "accured_interest": 0.2153424657534247,
    "days_to_maturity": 1692,
    "settlment_date": "2025-11-20",
    "parity_price": 0.810318799396146,
    "tir": 0.11069396742091445,
    "tea": 0.11069396742091445,
    "tem": 0.00878713349566751,
    "tna": 0.13523337986308834,
    "tna_30_360": 0.10544560194801011,
    "duration": 2.1655192047684135,
    "cer_settlment_date": null,
    "cer_issue_date": null,
    "tc_oficial": null,
    "dolar_mep": null,
    "margen": null,
    "badlar_last5": null
  }
  ```
</ResponseExample>

## Respuestas de Error

### 400 Solicitud Incorrecta

Parámetros inválidos o faltantes en el cuerpo de la solicitud.

```json theme={null}
{
  "type": "/errors/bad-request",
  "title": "Bad request",
  "status": 400,
  "detail": "Invalid request parameters",
  "correlation_id": "6cd1fd05-63e9-4863-832f-d873e58e9d67"
}
```

### 401 No Autorizado

Token de acceso inválido o faltante.

```json theme={null}
{
  "type": "/errors/authentication-required",
  "title": "Authorization header missing",
  "status": 401,
  "detail": "Authorization header missing",
  "correlation_id": "d6e20e07-0580-4e2d-9480-00a68c1ae493"
}
```

### 404 No Encontrado

Ticker no encontrado.

```json theme={null}
{
  "type": "/errors/not-found",
  "title": "Resource not found",
  "status": 404,
  "detail": "Ticker not found"
}
```

### 500 Error Interno del Servidor

Error interno del servidor.

```json theme={null}
{
  "type": "/errors/internal-server-error",
  "title": "Internal server error",
  "status": 500,
  "detail": "Internal server error",
  "correlation_id": "6cd1fd05-63e9-4863-832f-d873e58e9d67"
}
```

## Notas

* El campo `target` debe ser `"price"` para calcular métricas basadas en un precio objetivo
* El campo `value` representa el precio objetivo del bono
* La fecha de liquidación se calcula automáticamente basándose en `settlement_entry` y `operation_date`
* Todas las tasas están expresadas en formato decimal (ej., 0.573 = 57.3%)


# Flujo de Caja de Bonos
Source: https://docs.doctacapital.com.ar/api-reference/endpoint/bonds-cashflow

GET /api/v1/bonds/analytics/{symbol}/cashflow
Obtener el flujo de caja de un bono específico, incluyendo todos los pagos de capital e intereses

<Note>
  Este endpoint obtiene el flujo de caja de un bono específico, incluyendo todos los pagos de capital e intereses.
</Note>

## Parámetros de Ruta

<ParamField type="string">
  El símbolo del bono (ej., "AL30", "GD30").
</ParamField>

## Parámetros de Consulta

<ParamField type="integer">
  Unidades nominales para el cálculo. Esto determina el valor nominal de la posición del bono para la cual calcular el flujo de caja.
</ParamField>

## Ejemplo de Solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.doctacapital.com.ar/api/v1/bonds/analytics/AL30/cashflow?nominal_units=100" \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```
</RequestExample>

## Respuesta Exitosa

<ResponseField name="ticker" type="string">
  El símbolo del bono solicitado.
</ResponseField>

<ResponseField name="data" type="array">
  Serie de eventos de flujo de caja del bono.
</ResponseField>

<ResponseField name="data[].issue_date" type="string">
  Fecha de emisión del bono (YYYY-MM-DD).
</ResponseField>

<ResponseField name="data[].payment_date" type="string">
  Fecha de pago (YYYY-MM-DD).
</ResponseField>

<ResponseField name="data[].capital" type="number">
  Capital pagado en la fecha.
</ResponseField>

<ResponseField name="data[].interest_rate" type="number">
  Tasa de interés del período (decimal).
</ResponseField>

<ResponseField name="data[].interest_amount" type="number">
  Interés pagado en la fecha.
</ResponseField>

<ResponseField name="data[].residual_value" type="number">
  Capital remanente luego del pago.
</ResponseField>

<ResponseField name="data[].cash_flow" type="number">
  Flujo total (capital + interés) en la fecha.
</ResponseField>

<ResponseField name="data[].adj_interest_amount" type="number">
  Interés ajustado en la fecha.
</ResponseField>

<ResponseField name="data[].adj_capital" type="number">
  Capital ajustado en la fecha.
</ResponseField>

<ResponseField name="metadata" type="object">
  Metadatos de la respuesta.
</ResponseField>

<ResponseField name="metadata.subasset_class" type="string">
  Sub-clase de activo del bono.
</ResponseField>

<ResponseField name="metadata.nominal_units" type="number">
  Unidades nominales usadas para el cálculo.
</ResponseField>

<ResponseField name="metadata.total_records" type="number">
  Cantidad total de registros.
</ResponseField>

## Ejemplo de Respuesta Exitosa

<ResponseExample>
  ```json Success theme={null}
  {
    "ticker": "AL30",
    "data": [
      {
        "issue_date": "2020-09-04",
        "payment_date": "2021-07-09",
        "capital": 0.0,
        "interest_rate": 0.13,
        "interest_amount": 0.1101388888888889,
        "residual_value": 100.0,
        "cash_flow": 0.1101388888888889,
        "adj_interest_amount": 0.1101388888888889,
        "adj_capital": 0.0
      },
      {
        "issue_date": "2020-09-04",
        "payment_date": "2025-01-09",
        "capital": 8.0,
        "interest_rate": 0.75,
        "interest_amount": 0.375,
        "residual_value": 88.0,
        "cash_flow": 8.36,
        "adj_interest_amount": 0.36,
        "adj_capital": 8.0
      }
    ],
    "metadata": {
      "subasset_class": "HARD_DOLLAR",
      "nominal_units": 100.0,
      "total_records": 19
    }
  }
  ```
</ResponseExample>

## Respuestas de Error

### 500 Error Interno del Servidor

Error interno del servidor.

```json theme={null}
{
  "type": "/errors/internal-server-error",
  "title": "Internal server error",
  "status": 500,
  "detail": "Internal server error",
  "correlation_id": "6cd1fd05-63e9-4863-832f-d873e58e9d67"
}
```

### 401 No Autorizado

Token de acceso inválido o faltante.

```json theme={null}
{
  "type": "/errors/authentication-required",
  "title": "Authorization header missing",
  "status": 401,
  "detail": "Authorization header missing",
  "correlation_id": "d6e20e07-0580-4e2d-9480-00a68c1ae493"
}
```

### 404 No Encontrado

Ticker no encontrado.

```json theme={null}
{
  "type": "/errors/not-found",
  "title": "Resource not found",
  "status": 404,
  "detail": "Ticker not found"
}
```

## Notas

* Los datos de flujo de caja incluyen todos los pagos hasta el vencimiento del bono
* Los montos se calculan basándose en `metadata.nominal_units`


# Valor Residual Histórico
Source: https://docs.doctacapital.com.ar/api-reference/endpoint/bonds-cashflow-residual-value

GET /api/v1/bonds/analytics/{symbol}/cashflows/residual-value
Obtener la serie histórica de valor residual de un bono específico, filtrada por rango de fechas y plazo de liquidación

<Note>
  Este endpoint obtiene la serie histórica de valor residual de un bono específico, filtrada por rango de fechas y plazo de liquidación.
</Note>

## Parámetros de Ruta

<ParamField type="string">
  El símbolo del bono (ej., "AL30", "GD30").
</ParamField>

## Parámetros de Consulta

<ParamField type="string">
  Fecha de inicio del rango en formato YYYY-MM-DD.
</ParamField>

<ParamField type="string">
  Fecha de fin del rango en formato YYYY-MM-DD.
</ParamField>

<ParamField type="string">
  Plazo de liquidación. Valores posibles: `CI` (contado inmediato), `24hs` (24 horas), `48hs` (48 horas), `72hs` (72 horas).
</ParamField>

## Ejemplo de Solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.doctacapital.com.ar/api/v1/bonds/analytics/AL30/cashflows/residual-value?from_date=2025-01-01&to_date=2025-01-10&settlement_entry=24hs" \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```
</RequestExample>

## Respuesta Exitosa

La respuesta es un array de objetos con los valores residuales para cada día hábil del rango solicitado.

<ResponseField name="[].operation_date" type="string">
  Fecha de operación en formato YYYY-MM-DD.
</ResponseField>

<ResponseField name="[].settlement_entry" type="string">
  Plazo de liquidación utilizado (ej., "24hs").
</ResponseField>

<ResponseField name="[].settlement_date" type="string">
  Fecha de liquidación correspondiente en formato YYYY-MM-DD.
</ResponseField>

<ResponseField name="[].residual_value" type="number">
  Valor residual del bono en la fecha de liquidación.
</ResponseField>

## Ejemplo de Respuesta Exitosa

<ResponseExample>
  ```json Success theme={null}
  [
    {
      "operation_date": "2025-01-02",
      "settlement_entry": "24hs",
      "settlement_date": "2025-01-03",
      "residual_value": 96.0
    },
    {
      "operation_date": "2025-01-03",
      "settlement_entry": "24hs",
      "settlement_date": "2025-01-06",
      "residual_value": 96.0
    },
    {
      "operation_date": "2025-01-06",
      "settlement_entry": "24hs",
      "settlement_date": "2025-01-07",
      "residual_value": 96.0
    },
    {
      "operation_date": "2025-01-07",
      "settlement_entry": "24hs",
      "settlement_date": "2025-01-08",
      "residual_value": 96.0
    },
    {
      "operation_date": "2025-01-08",
      "settlement_entry": "24hs",
      "settlement_date": "2025-01-09",
      "residual_value": 96.0
    },
    {
      "operation_date": "2025-01-09",
      "settlement_entry": "24hs",
      "settlement_date": "2025-01-10",
      "residual_value": 88.0
    },
    {
      "operation_date": "2025-01-10",
      "settlement_entry": "24hs",
      "settlement_date": "2025-01-13",
      "residual_value": 88.0
    }
  ]
  ```
</ResponseExample>

## Respuestas de Error

### 500 Error Interno del Servidor

Error interno del servidor.

```json theme={null}
{
  "type": "/errors/internal-server-error",
  "title": "Internal server error",
  "status": 500,
  "detail": "Internal server error",
  "correlation_id": "6cd1fd05-63e9-4863-832f-d873e58e9d67"
}
```

### 401 No Autorizado

Token de acceso inválido o faltante.

```json theme={null}
{
  "type": "/errors/authentication-required",
  "title": "Authorization header missing",
  "status": 401,
  "detail": "Authorization header missing",
  "correlation_id": "d6e20e07-0580-4e2d-9480-00a68c1ae493"
}
```

### 404 No Encontrado

Ticker no encontrado.

```json theme={null}
{
  "type": "/errors/not-found",
  "title": "Resource not found",
  "status": 404,
  "detail": "Ticker not found"
}
```

## Notas

* Los datos están disponibles solo para días hábiles (excluyendo fines de semana y feriados)
* El valor residual refleja el capital remanente del bono luego de cada amortización
* La fecha de liquidación (`settlement_date`) se calcula automáticamente según el plazo de liquidación y el calendario de días hábiles


# Comparar bonos
Source: https://docs.doctacapital.com.ar/api-reference/endpoint/bonds-compare

GET /api/v1/bonds/compare
Comparar métricas de rendimiento intradiario de 2 a 20 bonos en una sola solicitud: TIR, TNA, TNA 30/360, TEM, duration, DTM y margen (solo bonos TAMAR/BADLAR) por bono. Los tickers no encontrados se informan por ticker en errors sin fallar la comparación.

<Note>
  Compará las métricas de rendimiento intradiario de 2 a 20 bonos en una sola solicitud: una fila por bono con TIR, TNA, TEM, duration y días al vencimiento. Requiere el scope `bonds:read`.
</Note>

## Parámetros de consulta

<ParamField type="string[]">
  Tickers de los bonos a comparar (2 a 20). Repetí el parámetro: `?tickers=AL30&tickers=GD30`.
</ParamField>

<Info>
  Los tickers que no existen se informan por ticker en `errors` sin hacer fallar la comparación. Un bono sin datos de pricing en la rueda actual vuelve con `no_data: true` y métricas en null.
</Info>

## Ejemplo de Solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -G 'https://api.doctacapital.com.ar/api/v1/bonds/compare' \
    --header 'Authorization: Bearer $DOCTA_TOKEN' \
    --data-urlencode 'tickers=AL30' \
    --data-urlencode 'tickers=GD30' \
    --data-urlencode 'tickers=AL35'
  ```
</RequestExample>

## Respuesta Exitosa

<ResponseField name="tickers_requested" type="string[]">
  Tickers solicitados, normalizados a mayúsculas.
</ResponseField>

<ResponseField name="rows" type="object[]">
  Una fila por bono resuelto: `ticker`, `sub_asset_class`, `no_data` y las métricas intradiarias `tir`, `tna`, `tna_30_360`, `tem` (todas decimales, 0.0742 = 7,42%), `duration` (años), `dtm` (días al vencimiento) y `margen` (solo bonos TAMAR/BADLAR; null en el resto).
</ResponseField>

<ResponseField name="errors" type="object[]">
  Tickers que no pudieron resolverse: `ticker` y `detail` con el motivo.
</ResponseField>

<ResponseField name="metadata" type="object">
  `total_records`: cantidad de filas devueltas.
</ResponseField>

## Ejemplo de Respuesta Exitosa

<ResponseExample>
  ```json 200 theme={null}
  {
    "tickers_requested": ["AL30", "GD30", "AL35"],
    "rows": [
      {
        "ticker": "AL30",
        "sub_asset_class": "HARD_DOLLAR",
        "no_data": false,
        "tir": 0.0742,
        "tna": 0.0826,
        "tna_30_360": 0.0718,
        "tem": 0.006,
        "duration": 2.09,
        "dtm": 1436,
        "margen": null
      },
      {
        "ticker": "GD30",
        "sub_asset_class": "HARD_DOLLAR",
        "no_data": false,
        "tir": 0.0591,
        "tna": 0.0644,
        "tna_30_360": 0.0576,
        "tem": 0.0048,
        "duration": 2.1,
        "dtm": 1436,
        "margen": null
      }
    ],
    "errors": [],
    "metadata": { "total_records": 2 }
  }
  ```
</ResponseExample>


# Instrumentos
Source: https://docs.doctacapital.com.ar/api-reference/endpoint/bonds-instruments

GET /api/v1/bonds/instruments
Listar instrumentos de bonos

<Note>
  Lista instrumentos de bonos con soporte de paginación y filtrado opcional por subclase de activo.
</Note>

## Parámetros de consulta

<ParamField type="string">
  Filtra por subclase de activo (ej., "HARD\_DOLLAR").
</ParamField>

<Info>
  Valores válidos para <code>sub\_asset\_class</code>:

  * <code>DOLLAR\_LINKED</code>
  * <code>HARD\_DOLLAR</code>
  * <code>CER</code>
  * <code>BOPREAL</code>
  * <code>FIXED\_RATE</code>
  * <code>SUB\_SOBERANO</code>
  * <code>ON</code>
  * <code>TAMAR</code>
  * <code>BADLAR</code>
  * <code>ON\_FIXED\_RATE</code>
  * <code>ON\_CER</code>
  * <code>ON\_BADLAR</code>
  * <code>ON\_TAMAR</code>
  * <code>ON\_DOLLAR\_LINKED</code>
  * <code>SUB\_SOBERANO\_FIXED\_RATE</code>
  * <code>SUB\_SOBERANO\_CER</code>
  * <code>SUB\_SOBERANO\_BADLAR</code>
  * <code>SUB\_SOBERANO\_TAMAR</code>
</Info>

<ParamField type="integer">
  Límite de elementos por página (predeterminado 50).
</ParamField>

<ParamField type="string">
  Cursor de paginación para obtener la siguiente página.
</ParamField>

## Ejemplo de Solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.doctacapital.com.ar/api/v1/bonds/instruments?limit=50" \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```
</RequestExample>

## Respuesta Exitosa

<ResponseField name="data" type="array">
  Lista de instrumentos de bonos.
</ResponseField>

<ResponseField name="data[].ticker" type="string">
  Ticker del bono (ej., "S30N6").
</ResponseField>

<ResponseField name="data[].asset_class" type="string">
  Clase de activo del bono (ej., "BOND").
</ResponseField>

<ResponseField name="data[].sub_asset_class" type="string">
  Subclase de activo del bono (ej., "FIXED\_RATE").
</ResponseField>

<ResponseField name="pagination" type="object">
  Información de paginación.
</ResponseField>

<ResponseField name="pagination.limit" type="integer">
  Límite de elementos por página.
</ResponseField>

<ResponseField name="pagination.has_next" type="boolean">
  Indica si hay más páginas disponibles.
</ResponseField>

<ResponseField name="pagination.next_cursor" type="string | null">
  Cursor para obtener la siguiente página. Es null si no hay más páginas.
</ResponseField>

<ResponseField name="pagination.total_items" type="integer">
  Número total de elementos disponibles.
</ResponseField>

<ResponseField name="filters" type="object">
  Filtros aplicados en la solicitud.
</ResponseField>

<ResponseField name="filters.sub_asset_class" type="string">
  Subclase de activo utilizada como filtro.
</ResponseField>

<ResponseField name="metadata" type="object">
  Metadatos de la respuesta.
</ResponseField>

<ResponseField name="metadata.total_records" type="integer">
  Número total de registros disponibles.
</ResponseField>

## Ejemplo de Respuesta Exitosa

<ResponseExample>
  ```json Success theme={null}
  {
    "data": [
      {
        "ticker": "S30N6",
        "asset_class": "BOND",
        "sub_asset_class": "FIXED_RATE"
      },
      {
        "ticker": "S16E6",
        "asset_class": "BOND",
        "sub_asset_class": "FIXED_RATE"
      },
      {
        "ticker": "S30O6",
        "asset_class": "BOND",
        "sub_asset_class": "FIXED_RATE"
      }
    ],
    "pagination": {
      "limit": 50,
      "has_next": false,
      "next_cursor": null,
      "total_items": 20
    },
    "filters": {
      "sub_asset_class": "FIXED_RATE"
    },
    "metadata": {
      "total_records": 20
    }
  }
  ```
</ResponseExample>


# Detalle de instrumento
Source: https://docs.doctacapital.com.ar/api-reference/endpoint/bonds-instruments-detail

GET /api/v1/bonds/instruments/{symbol}
Obtener detalle de un instrumento de bono

<Note>
  Devuelve el detalle de un instrumento de bono.
</Note>

## Parámetros de ruta

<ParamField type="string">
  Símbolo del bono (ej., "AL30").
</ParamField>

## Ejemplo de Solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.doctacapital.com.ar/api/v1/bonds/instruments/AL30/" \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```
</RequestExample>

## Respuesta Exitosa

<ResponseField name="data" type="array">
  Lista con el detalle del instrumento solicitado.
</ResponseField>

<ResponseField name="data[].ticker" type="string">
  Ticker del bono (ej., "GD30").
</ResponseField>

<ResponseField name="data[].name" type="string">
  Nombre completo del bono.
</ResponseField>

<ResponseField name="data[].asset_class" type="string">
  Clase de activo del bono (ej., "BOND").
</ResponseField>

<ResponseField name="data[].sub_asset_class" type="string">
  Subclase de activo del bono (ej., "HARD\_DOLLAR").
</ResponseField>

<ResponseField name="data[].sector" type="string | null">
  Sector del bono. Puede ser null.
</ResponseField>

<ResponseField name="data[].issuer" type="string | null">
  Emisor del bono. Puede ser null.
</ResponseField>

<ResponseField name="data[].law" type="string | null">
  Ley aplicable al bono. Puede ser null.
</ResponseField>

<ResponseField name="metadata" type="object">
  Metadatos de la respuesta.
</ResponseField>

## Ejemplo de Respuesta Exitosa

<ResponseExample>
  ```json Success theme={null}
  {
    "data": [
      {
        "ticker": "GD30",
        "name": "Soberano HD 2030 U$S 1.75% (GD30)",
        "asset_class": "BOND",
        "sub_asset_class": "HARD_DOLLAR",
        "sector": null,
        "issuer": null,
        "law": null
      }
    ],
    "metadata": {
      "total_records": 1
    }
  }
  ```
</ResponseExample>


# Buscar instrumentos
Source: https://docs.doctacapital.com.ar/api-reference/endpoint/bonds-instruments-search

GET /api/v1/bonds/instruments/search
Buscar instrumentos de bonos

<Note>
  Busca instrumentos de bonos por texto.
</Note>

## Parámetros de consulta

<ParamField type="string">
  Ticker del bono (ej., "AL30").
</ParamField>

<ParamField type="integer">
  Límite de resultados (predeterminado 10).
</ParamField>

<ParamField type="string">
  Cursor de paginación.
</ParamField>

## Ejemplo de Solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.doctacapital.com.ar/api/v1/bonds/instruments/search?query=AL30&limit=10" \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```
</RequestExample>

## Respuesta Exitosa

<ResponseField name="data" type="array">
  Lista de instrumentos encontrados.
</ResponseField>

<ResponseField name="data[].ticker" type="string">
  Ticker del bono (ej., "AL30").
</ResponseField>

<ResponseField name="data[].asset_class" type="string">
  Clase de activo del bono.
</ResponseField>

<ResponseField name="data[].sub_asset_class" type="string">
  Subclase de activo del bono.
</ResponseField>

<ResponseField name="query" type="string">
  Consulta de búsqueda utilizada.
</ResponseField>

<ResponseField name="pagination" type="object">
  Información de paginación.
</ResponseField>

<ResponseField name="pagination.next_cursor" type="string | null">
  Cursor para obtener la siguiente página. Es null si no hay más páginas.
</ResponseField>

<ResponseField name="pagination.has_next" type="boolean">
  Indica si hay más páginas disponibles.
</ResponseField>

<ResponseField name="metadata" type="object">
  Metadatos de la respuesta.
</ResponseField>

<ResponseField name="metadata.total_records" type="integer">
  Número total de registros encontrados.
</ResponseField>

## Ejemplo de Respuesta Exitosa

<ResponseExample>
  ```json Success theme={null}
  {
    "data": [
      {
        "ticker": "AL30",
        "asset_class": "BONO AL30",
        "sub_asset_class": "HARD_DOLLAR",
      }
    ],
    "pagination": {
      "next_cursor": null,
      "has_next": false
    },
    "metadata": {
      "total_records": 1
    }
  }
  ```
</ResponseExample>


# Yields históricos
Source: https://docs.doctacapital.com.ar/api-reference/endpoint/bonds-yields-historical-curve

GET /api/v1/bonds/yields/{symbol}/historical
Obtener datos intradiarios históricos de rendimiento de un bono específico

<Note>
  Obtiene los datos históricos de rendimiento de un bono específico.
</Note>

## Parámetros

<ParamField type="string">
  Ticker del bono (ej., "AL30").
</ParamField>

## Parámetros de Consulta

<ParamField type="string">
  Fecha histórica específica en formato YYYY-MM-DD.
</ParamField>

<ParamField type="string">
  Fecha histórica específica en formato YYYY-MM-DD.
</ParamField>

## Ejemplo de Solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.doctacapital.com.ar/api/v1/bonds/yields/AL30/historical?from_date=2025-01-01&to_date=2025-01-02" \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```
</RequestExample>

## Respuesta Exitosa

<ResponseField name="ticker" type="string">
  Ticker del bono solicitado (ej., "AL30").
</ResponseField>

<ResponseField name="data" type="array">
  Serie histórica de rendimientos para el bono solicitado.
</ResponseField>

<ResponseField name="data[].date" type="string">
  Fecha del dato en formato YYYY-MM-DD.
</ResponseField>

<ResponseField name="data[].tir" type="number">
  Tasa Interna de Retorno (TIR) expresada como decimal.
</ResponseField>

<ResponseField name="data[].tna" type="number">
  Tasa Nominal Anual (TNA) expresada como decimal.
</ResponseField>

<ResponseField name="data[].tea" type="number">
  Tasa Efectiva Anual (TEA) expresada como decimal.
</ResponseField>

<ResponseField name="data[].tem" type="number">
  Tasa Efectiva Mensual (TEM) expresada como decimal.
</ResponseField>

<ResponseField name="from_date" type="string">
  Fecha inicial del rango solicitado (YYYY-MM-DD).
</ResponseField>

<ResponseField name="to_date" type="string">
  Fecha final del rango solicitado (YYYY-MM-DD).
</ResponseField>

<ResponseField name="metadata" type="object">
  Metadatos de la respuesta.
</ResponseField>

<ResponseField name="metadata.total_records" type="number">
  Cantidad total de registros en el período solicitado.
</ResponseField>

## Ejemplo de Respuesta Exitosa

<ResponseExample>
  ```json Success theme={null}
  {
    "ticker": "AL30",
    "data": [
      {
        "date": "2025-01-02",
        "tir": 0.107148,
        "tna": 0.136547,
        "tea": 0.107148,
        "tem": 0.008518
      },
      {
        "date": "2025-01-03",
        "tir": 0.106576,
        "tna": 0.135581,
        "tea": 0.106576,
        "tem": 0.008475
      }
    ],
    "from_date": "2025-01-01",
    "to_date": "2025-02-01",
    "metadata": {
      "total_records": 2
    }
  }
  ```
</ResponseExample>

## Respuestas de Error

### 500 Error Interno del Servidor

Error interno del servidor.

```json theme={null}
{
  "type": "/errors/internal-server-error",
  "title": "Internal server error",
  "status": 500,
  "detail": "Internal server error",
  "correlation_id": "6cd1fd05-63e9-4863-832f-d873e58e9d67"
}
```

### 401 No Autorizado

Token de acceso inválido o faltante.

```json theme={null}
{
  "type": "/errors/authentication-required",
  "title": "Authorization header missing",
  "status": 401,
  "detail": "Authorization header missing",
  "correlation_id": "d6e20e07-0580-4e2d-9480-00a68c1ae493"
}
```

### 400 Solicitud Incorrecta

Parámetro subasset\_class inválido.

```json theme={null}
{
  "type": "/errors/http-error",
  "title": "subasset_class: Value error, Invalid subasset_class 'FIXED_RATES'. Supported values: BOPREAL, CER, DOLLAR_LINKED, FIXED_RATE, HARD_DOLLAR, ON, ON_BADLAR, ON_DOLLAR_LINKED, ON_TAMAR, SUB_SOBERANO, SUB_SOBERANO_BADLAR, SUB_SOBERANO_CER",
  "status": 400,
  "detail": "subasset_class: Value error, Invalid subasset_class 'FIXED_RATES'. Supported values: BOPREAL, CER, DOLLAR_LINKED, FIXED_RATE, HARD_DOLLAR, ON, ON_BADLAR, ON_DOLLAR_LINKED, ON_TAMAR, SUB_SOBERANO, SUB_SOBERANO_BADLAR, SUB_SOBERANO_CER"
}
```

### 400 Fecha Futura

Fecha histórica no puede ser en el futuro.

```json theme={null}
{
  "type": "/errors/http-error",
  "title": "date: Value error, Historical date must be in the past",
  "status": 400,
  "detail": "date: Value error, Historical date must be in the past"
}
```

### 404 No Encontrado

Símbolo/ticker no encontrado o no hay datos disponibles.

```json theme={null}
{
  "type": "/errors/not-found",
  "title": "Resource not found: /bonds/tir_curve/historical",
  "status": 404,
  "detail": "Resource not found: /bonds/tir_curve/historical",
  "correlation_id": "438caef0-f014-4a80-874c-4d0261ff28a3"
}
```

## Notas

* Los datos están disponibles solo para días hábiles (excluyendo fines de semana y feriados)
* Las TIR (Tasas Internas de Retorno) se expresan como decimales (ej., 0.104657 = 10.4657%)
* La disponibilidad de datos históricos puede variar según la clase de subactivo y el rango de fechas
* Los datos incluyen instrumentos específicos con sus respectivos tickers y características financieras


# Yields intradiarios
Source: https://docs.doctacapital.com.ar/api-reference/endpoint/bonds-yields-intraday

GET /api/v1/bonds/yields/{symbol}/intraday
Obtener datos intradiarios de rendimiento de un bono específico

<Note>
  Obtiene los datos yields intradiarios de un bono específico.
</Note>

## Parámetros

<ParamField type="string">
  Ticker del bono (ej., "AL30").
</ParamField>

## Ejemplo de Solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.doctacapital.com.ar/api/v1/bonds/yields/AL30/intraday" \
    -H "Authorization: Bearer YOUR_ACCESS_TOKEN"
  ```
</RequestExample>

## Respuesta Exitosa

<ResponseField name="ticker" type="string">
  Ticker del bono solicitado (ej., "AL30").
</ResponseField>

<ResponseField name="data" type="array">
  Serie de datos intradiarios de rendimiento.
</ResponseField>

<ResponseField name="data[].tir" type="number">
  Tasa Interna de Retorno (TIR) expresada como decimal.
</ResponseField>

<ResponseField name="data[].tna" type="number">
  Tasa Nominal Anual (TNA) expresada como decimal.
</ResponseField>

<ResponseField name="data[].tna_30_360" type="number">
  Tasa Nominal Anual calculada con base 30/360 expresada como decimal.
</ResponseField>

<ResponseField name="data[].tem" type="number">
  Tasa Efectiva Mensual (TEM) expresada como decimal.
</ResponseField>

<ResponseField name="data[].duration" type="number">
  Duración del bono en años.
</ResponseField>

<ResponseField name="data[].dtm" type="integer">
  Días hasta el vencimiento (Days to Maturity).
</ResponseField>

<ResponseField name="data[].margen" type="number | null">
  Margen del bono. Puede ser null.
</ResponseField>

<ResponseField name="metadata" type="object">
  Metadatos de la respuesta.
</ResponseField>

<ResponseField name="metadata.total_records" type="integer">
  Número total de registros intradiarios disponibles.
</ResponseField>

<ResponseField name="metadata.sub_asset_class" type="string">
  Subclase de activo del bono (ej., "HARD\_DOLLAR").
</ResponseField>

## Ejemplo de Respuesta Exitosa

<ResponseExample>
  ```json Success theme={null}
  {
    "ticker": "AL30",
    "data": [
      {
        "tir": 0.09887070513854544,
        "tna": 0.1177734104315629,
        "tna_30_360": 0.09465437970685375,
        "tem": 0.007887864975571146,
        "duration": 2.107751399163522,
        "dtm": 1663,
        "margen": null
      }
    ],
    "metadata": {
      "total_records": 1,
      "sub_asset_class": "HARD_DOLLAR"
    }
  }
  ```
</ResponseExample>


# Serie de benchmark
Source: https://docs.doctacapital.com.ar/api-reference/endpoint/fci-benchmark-series

GET /api/v1/fci/benchmarks/{name}/series
Serie de retorno acumulado de un benchmark. Los benchmarks de tasa (BADLAR, TAMAR) capitalizan diariamente sobre TNA/365; los de cotización (CER, MEP, CCL, A3500) usan variación simple.

<Note>
  Devuelve la serie de retorno acumulado de un benchmark sobre un rango. Los benchmarks de tasa (BADLAR, TAMAR) capitalizan diariamente sobre TNA/365; los de cotización (CER, MEP, CCL, A3500) usan la variación simple de precio. Requiere el scope `fci:read`.
</Note>

## Parámetros de ruta

<ParamField type="string">
  Nombre del benchmark (ej., "CER", "BADLAR", "MEP"). Consultá los disponibles en `GET /api/v1/fci/benchmarks`.
</ParamField>

## Parámetros de consulta

<ParamField type="string">
  Intervalo de fechas, mutuamente excluyente con `date_from`/`date_to`. Ejemplos: `1 week`, `1 month`, `3 months`, `ytd`, `1 year`, `max` (también se aceptan los alias cortos `1W`, `1M`, `3M`, `YTD`, `1Y`).
</ParamField>

<ParamField type="string">
  Fecha de inicio en formato YYYY-MM-DD. Mutuamente excluyente con `interval`.
</ParamField>

<ParamField type="string">
  Fecha de fin en formato YYYY-MM-DD. Predeterminado: hoy. Mutuamente excluyente con `interval`.
</ParamField>

## Ejemplo de Solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.doctacapital.com.ar/api/v1/fci/benchmarks/CER/series?interval=1%20week" \
    -H "Authorization: Bearer $DOCTA_TOKEN"
  ```
</RequestExample>

## Respuesta Exitosa

<ResponseField name="name" type="string">
  Nombre del benchmark.
</ResponseField>

<ResponseField name="type" type="string">
  Tipo de benchmark: `rate` o `quote`.
</ResponseField>

<ResponseField name="source" type="string">
  Fuente de los datos.
</ResponseField>

<ResponseField name="rate_unit" type="string | null">
  Unidad de la tasa para benchmarks de tipo `rate`. Es null en los de tipo `quote`.
</ResponseField>

<ResponseField name="requested_range" type="object">
  Rango solicitado, con `from` y `to`.
</ResponseField>

<ResponseField name="effective_range" type="object">
  Rango efectivo con datos disponibles, con `from` y `to`.
</ResponseField>

<ResponseField name="series" type="array">
  Puntos diarios de la serie.
</ResponseField>

<ResponseField name="series[].date" type="string">
  Fecha del punto (YYYY-MM-DD).
</ResponseField>

<ResponseField name="series[].quote" type="number">
  Cotización del benchmark en la fecha. Presente solo en benchmarks de tipo `quote`; en los de tipo `rate` el punto trae el campo `rate` (la tasa, en la unidad de `rate_unit`) en lugar de `quote`.
</ResponseField>

<ResponseField name="series[].cumulative_return" type="number">
  Retorno acumulado desde el inicio del rango, en decimal.
</ResponseField>

## Ejemplo de Respuesta Exitosa

<ResponseExample>
  ```json Success theme={null}
  {
    "name": "CER",
    "type": "quote",
    "source": "BCRA",
    "rate_unit": null,
    "requested_range": {
      "from": "2026-07-26",
      "to": "2026-08-02"
    },
    "effective_range": {
      "from": "2026-07-27",
      "to": "2026-08-02"
    },
    "series": [
      {
        "date": "2026-07-27",
        "quote": 813.45653848551,
        "cumulative_return": 0.0
      },
      {
        "date": "2026-07-28",
        "quote": 813.95058132289,
        "cumulative_return": 0.0006073377175133121
      },
      {
        "date": "2026-07-29",
        "quote": 814.44492421112,
        "cumulative_return": 0.0012150442941305517
      }
    ]
  }
  ```
</ResponseExample>


# Benchmarks de FCI
Source: https://docs.doctacapital.com.ar/api-reference/endpoint/fci-benchmarks

GET /api/v1/fci/benchmarks
Catálogo de benchmarks disponibles para comparaciones: BADLAR, TAMAR, CER, A3500, MEP, CCL y OFICIAL_MINORISTA, con su tipo (rate/quote) y fuente.

<Note>
  Lista los benchmarks disponibles para comparar contra fondos: BADLAR, TAMAR, CER, A3500, MEP, CCL y OFICIAL\_MINORISTA. Cada entrada informa su tipo (`rate` o `quote`), su fuente y la unidad de tasa cuando aplica. Requiere el scope `fci:read`.
</Note>

Este endpoint no recibe parámetros.

## Ejemplo de Solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.doctacapital.com.ar/api/v1/fci/benchmarks" \
    -H "Authorization: Bearer $DOCTA_TOKEN"
  ```
</RequestExample>

## Respuesta Exitosa

<ResponseField name="benchmarks" type="array">
  Lista de benchmarks disponibles.
</ResponseField>

<ResponseField name="benchmarks[].name" type="string">
  Nombre del benchmark (ej., "CER", "BADLAR").
</ResponseField>

<ResponseField name="benchmarks[].type" type="string">
  Tipo de benchmark: `rate` (tasa) o `quote` (cotización).
</ResponseField>

<ResponseField name="benchmarks[].source" type="string">
  Fuente de los datos (ej., "BCRA").
</ResponseField>

<ResponseField name="benchmarks[].rate_unit" type="string">
  Unidad de la tasa para benchmarks de tipo `rate` (ej., "annual\_pct"). Ausente en los de tipo `quote`.
</ResponseField>

<ResponseField name="total" type="integer">
  Cantidad total de benchmarks.
</ResponseField>

## Ejemplo de Respuesta Exitosa

<ResponseExample>
  ```json Success theme={null}
  {
    "benchmarks": [
      {
        "name": "BADLAR",
        "type": "rate",
        "source": "BCRA",
        "rate_unit": "annual_pct"
      },
      {
        "name": "CER",
        "type": "quote",
        "source": "BCRA"
      },
      {
        "name": "MEP",
        "type": "quote",
        "source": "DB"
      }
    ],
    "total": 7
  }
  ```
</ResponseExample>


# Catálogo de FCI
Source: https://docs.doctacapital.com.ar/api-reference/endpoint/fci-catalog

GET /api/v1/fci/catalog
Catálogo de facetas del universo FCI: los valores válidos de cada filtro categórico del screener (rent_type, class_type, fund_type, manager_name, depositary_name, region, horizon, native_currency). El matching de filtros es exacto.

<Note>
  Devuelve el catálogo de facetas del universo FCI: los valores válidos de cada filtro categórico del screener. Usá estos valores textualmente en `GET /api/v1/fci/instruments`, ya que el matching es exacto (ej., money market es `Mercado de Dinero`). Requiere el scope `fci:read`.
</Note>

Este endpoint no recibe parámetros.

## Ejemplo de Solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.doctacapital.com.ar/api/v1/fci/catalog" \
    -H "Authorization: Bearer $DOCTA_TOKEN"
  ```
</RequestExample>

## Respuesta Exitosa

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

<ResponseField name="total_funds" type="integer">
  Cantidad total de fondos en el universo.
</ResponseField>

<ResponseField name="facets" type="object">
  Valores válidos por filtro categórico. Cada clave es una lista de strings.
</ResponseField>

<ResponseField name="facets.rent_type" type="string[]">
  Tipos de renta / categorías (ej., "Mercado de Dinero", "Renta Fija").
</ResponseField>

<ResponseField name="facets.class_type" type="string[]">
  Clases de cuotaparte (ej., "Mayorista", "Minorista").
</ResponseField>

<ResponseField name="facets.fund_type" type="string[]">
  Tipos de fondo ("Abierto", "Cerrado").
</ResponseField>

<ResponseField name="facets.manager_name" type="string[]">
  Sociedades gerentes.
</ResponseField>

<ResponseField name="facets.depositary_name" type="string[]">
  Sociedades depositarias.
</ResponseField>

<ResponseField name="facets.region" type="string[]">
  Regiones.
</ResponseField>

<ResponseField name="facets.horizon" type="string[]">
  Horizontes de inversión.
</ResponseField>

<ResponseField name="facets.native_currency" type="string[]">
  Monedas nativas ("ARS", "USD").
</ResponseField>

## Ejemplo de Respuesta Exitosa

<ResponseExample>
  ```json Success theme={null}
  {
    "reference_date": "2026-08-02",
    "total_funds": 4570,
    "facets": {
      "rent_type": [
        "ASG",
        "Mercado de Dinero",
        "Renta Fija"
      ],
      "class_type": [
        "General",
        "Mayorista",
        "Minorista"
      ],
      "fund_type": [
        "Abierto",
        "Cerrado"
      ],
      "manager_name": [
        "Galicia Asset Management S.A.U.",
        "Mercado Pago Asset Managemet S.A.",
        "Supervielle Asset Management S.A."
      ],
      "depositary_name": [
        "Banco Industrial S.A.",
        "Banco Supervielle S.A.",
        "Banco de Galicia y Buenos Aires S.A."
      ],
      "region": [
        "Argentina",
        "Global",
        "Latinoamerica"
      ],
      "horizon": [
        "Corto Plazo",
        "Largo Plazo",
        "Mediano Plazo"
      ],
      "native_currency": [
        "ARS",
        "USD"
      ]
    }
  }
  ```
</ResponseExample>


# Comparar FCI (series)
Source: https://docs.doctacapital.com.ar/api-reference/endpoint/fci-compare-series

GET /api/v1/fci/compare/series
Series de retorno acumulado de hasta 10 fondos alineadas a la primera fecha común, con overlays opcionales de benchmarks. Devuelve 400 si algún fondo no tiene datos en el rango.

<Note>
  Series de retorno acumulado para hasta 10 fondos, alineadas a la primera fecha común, con benchmarks opcionales superpuestos. Las series de fondos comparten un calendario común; los benchmarks conservan sus propios días de negociación. Requiere el scope `fci:read`.
</Note>

## Parámetros de consulta

<ParamField type="string[]">
  Nombres exactos de los fondos a comparar. Se repite el parámetro por cada fondo (`?fund_names=A&fund_names=B`). Máximo 10 fondos.
</ParamField>

<ParamField type="string[]">
  Benchmarks a superponer. Se repite el parámetro por cada benchmark. Los benchmarks disponibles se obtienen con `GET /api/v1/fci/benchmarks`.
</ParamField>

<ParamField type="string">
  Intervalo de fechas, mutuamente excluyente con `date_from`/`date_to`. Ejemplos: `1 week`, `1 month`, `3 months`, `ytd`, `1 year`, `max` (también acepta los alias cortos `1W`, `1M`, `3M`, `YTD`, `1Y`).
</ParamField>

<ParamField type="string">
  Inicio del rango en formato YYYY-MM-DD. Mutuamente excluyente con `interval`.
</ParamField>

<ParamField type="string">
  Fin del rango en formato YYYY-MM-DD. Mutuamente excluyente con `interval`.
</ParamField>

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

<ParamField 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>

<Note>
  El endpoint devuelve 400 si alguno de los fondos solicitados no tiene datos en el rango.
</Note>

## Ejemplo de Solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -G "https://api.doctacapital.com.ar/api/v1/fci/compare/series" \
    -H "Authorization: Bearer $DOCTA_TOKEN" \
    --data-urlencode "fund_names=Premier Abierto Pymes - Clase A" \
    --data-urlencode "fund_names=Mercado Fondo - Clase A" \
    --data-urlencode "benchmarks=CER" \
    --data-urlencode "interval=1 week"
  ```
</RequestExample>

## Respuesta Exitosa

<ResponseField name="requested_range" type="object">
  Rango solicitado, con `from` y `to` en formato YYYY-MM-DD (null si se usó `interval` sin fechas explícitas).
</ResponseField>

<ResponseField name="effective_range" type="object">
  Rango efectivo con datos disponibles, con `from` y `to` en formato YYYY-MM-DD.
</ResponseField>

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

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

<ResponseField name="fund_count" type="integer">
  Cantidad de fondos incluidos.
</ResponseField>

<ResponseField name="benchmark_count" type="integer">
  Cantidad de benchmarks incluidos.
</ResponseField>

<ResponseField name="funds" type="array">
  Una serie por fondo.
</ResponseField>

<ResponseField name="funds[].fund_name" type="string">
  Nombre del fondo.
</ResponseField>

<ResponseField name="funds[].native_currency" type="string">
  Moneda nativa del fondo.
</ResponseField>

<ResponseField name="funds[].series" type="array">
  Puntos de la serie: `date` (YYYY-MM-DD) y `cumulative_return` (retorno acumulado como decimal, 0.0 en la fecha ancla).
</ResponseField>

<ResponseField name="benchmarks" type="array">
  Una serie por benchmark, con `name`, `type` y sus propios puntos `date`/`cumulative_return`.
</ResponseField>

<ResponseField name="data_quality" type="object">
  Metadatos de calidad: `common_dates_count` (fechas comunes entre fondos) y `anchor_date` (fecha ancla de la alineación).
</ResponseField>

## Ejemplo de Respuesta Exitosa

<ResponseExample>
  ```json Success theme={null}
  {
    "requested_range": {
      "from": null,
      "to": null
    },
    "effective_range": {
      "from": "2026-07-23",
      "to": "2026-07-30"
    },
    "target_currency": "ARS",
    "fx_kind": "mep",
    "fund_count": 2,
    "benchmark_count": 1,
    "funds": [
      {
        "fund_name": "Premier Abierto Pymes - Clase A",
        "native_currency": "ARS",
        "series": [
          {
            "date": "2026-07-23",
            "cumulative_return": 0.0
          },
          {
            "date": "2026-07-24",
            "cumulative_return": 0.001611773016768625
          },
          {
            "date": "2026-07-27",
            "cumulative_return": 0.008401386594302673
          }
        ]
      },
      {
        "fund_name": "Mercado Fondo - Clase A",
        "native_currency": "ARS",
        "series": [
          {
            "date": "2026-07-23",
            "cumulative_return": 0.0
          },
          {
            "date": "2026-07-24",
            "cumulative_return": 0.0004792094833239169
          },
          {
            "date": "2026-07-27",
            "cumulative_return": 0.0019162360121554034
          }
        ]
      }
    ],
    "benchmarks": [
      {
        "name": "CER",
        "type": "quote",
        "series": [
          {
            "date": "2026-07-27",
            "cumulative_return": 0.0
          },
          {
            "date": "2026-07-28",
            "cumulative_return": 0.0006073377175133121
          },
          {
            "date": "2026-07-29",
            "cumulative_return": 0.0012150442941305517
          }
        ]
      }
    ],
    "data_quality": {
      "common_dates_count": 6,
      "anchor_date": "2026-07-23"
    }
  }
  ```
</ResponseExample>


# Comparar FCI (tabla)
Source: https://docs.doctacapital.com.ar/api-reference/endpoint/fci-compare-table

GET /api/v1/fci/compare/table
Tabla comparativa de hasta 30 fondos: AUM al cierre del rango, retornos preestablecidos (1D/1W/1M/YTD/1Y como decimales), retorno del rango y TNA proporcional.

<Note>
  Compara hasta 30 fondos lado a lado: AUM al cierre del rango, retornos preestablecidos (1D/1W/1M/YTD/1Y como decimales), retorno del rango y TNA proporcional. Requiere el scope `fci:read`.
</Note>

## Parámetros de consulta

<ParamField type="string[]">
  Nombres exactos de los fondos a comparar. Se repite el parámetro por cada fondo (`?fund_names=A&fund_names=B`). Máximo 30 fondos.
</ParamField>

<ParamField type="string">
  Intervalo de fechas, mutuamente excluyente con `date_from`/`date_to`. Ejemplos: `1 week`, `1 month`, `3 months`, `ytd`, `1 year`, `max` (también acepta los alias cortos `1W`, `1M`, `3M`, `YTD`, `1Y`).
</ParamField>

<ParamField type="string">
  Inicio del rango en formato YYYY-MM-DD. Mutuamente excluyente con `interval`.
</ParamField>

<ParamField type="string">
  Fin del rango en formato YYYY-MM-DD. Mutuamente excluyente con `interval`.
</ParamField>

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

<ParamField 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>

## Ejemplo de Solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -G "https://api.doctacapital.com.ar/api/v1/fci/compare/table" \
    -H "Authorization: Bearer $DOCTA_TOKEN" \
    --data-urlencode "fund_names=Premier Abierto Pymes - Clase A" \
    --data-urlencode "fund_names=Mercado Fondo - Clase A" \
    --data-urlencode "date_from=2026-06-30" \
    --data-urlencode "date_to=2026-07-30"
  ```
</RequestExample>

## Respuesta Exitosa

<ResponseField name="requested_range" type="object">
  Rango solicitado, con `from` y `to` en formato YYYY-MM-DD (null si se usó `interval` sin fechas explícitas).
</ResponseField>

<ResponseField name="effective_range" type="object">
  Rango efectivo con datos disponibles, con `from` y `to` en formato YYYY-MM-DD.
</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="fund_count" type="integer">
  Cantidad de fondos comparados.
</ResponseField>

<ResponseField name="rows" type="array">
  Una fila por fondo comparado.
</ResponseField>

<ResponseField name="rows[].fund_name" type="string">
  Nombre del fondo.
</ResponseField>

<ResponseField name="rows[].native_currency" type="string">
  Moneda nativa del fondo.
</ResponseField>

<ResponseField name="rows[].aum_at_end" type="number">
  AUM al cierre del rango, expresado en `target_currency`.
</ResponseField>

<ResponseField name="rows[].performance" type="object">
  Retornos preestablecidos `1D`, `1W`, `1M`, `YTD` y `1Y`, expresados como decimales (ej., 0.0165 = 1.65%).
</ResponseField>

<ResponseField name="rows[].range_return" type="number">
  Retorno acumulado sobre el rango solicitado, expresado como decimal.
</ResponseField>

<ResponseField name="rows[].tna_range" type="number">
  TNA proporcional sobre el rango solicitado, expresada como decimal.
</ResponseField>

<ResponseField name="rows[].fund_inactive_in_range" type="boolean">
  Indica si el fondo estuvo inactivo dentro del rango.
</ResponseField>

## Ejemplo de Respuesta Exitosa

<ResponseExample>
  ```json Success theme={null}
  {
    "requested_range": {
      "from": "2026-06-30",
      "to": "2026-07-30"
    },
    "effective_range": {
      "from": "2026-06-30",
      "to": "2026-07-30"
    },
    "target_currency": "ARS",
    "fx_kind": "mep",
    "fund_count": 2,
    "rows": [
      {
        "fund_name": "Premier Abierto Pymes - Clase A",
        "native_currency": "ARS",
        "aum_at_end": 17918632369.3,
        "performance": {
          "1D": 0.0008049373324414688,
          "1W": 0.007252803501992311,
          "1M": 0.016567519671488284,
          "YTD": 0.18136974439941578,
          "1Y": 0.4372903452209189
        },
        "range_return": 0.016567519671488284,
        "tna_range": 0.20157148933644078,
        "fund_inactive_in_range": false
      },
      {
        "fund_name": "Mercado Fondo - Clase A",
        "native_currency": "ARS",
        "aum_at_end": 7882693319912.59,
        "performance": {
          "1D": 0.0004767150468019121,
          "1W": 0.003353703949822595,
          "1M": 0.014343980399997402,
          "YTD": 0.12882713824396963,
          "1Y": 0.28174540134475756
        },
        "range_return": 0.014343980399997402,
        "tna_range": 0.17451842819996838,
        "fund_inactive_in_range": false
      }
    ]
  }
  ```
</ResponseExample>


# Screener de FCI
Source: https://docs.doctacapital.com.ar/api-reference/endpoint/fci-instruments

GET /api/v1/fci/instruments
Listar y filtrar el universo de FCI (screener): metadata, AUM y retornos preestablecidos (1D/1W/1M/YTD/1Y), con filtros por gestora, depositaria, categoría, región, horizonte, AUM y retornos. Paginado con limit/offset.

<Note>
  Lista el universo de fondos comunes de inversión con metadatos, AUM y retornos preestablecidos (1D/1W/1M/YTD/1Y), con filtros por gerente, depositaria, categoría, región, horizonte, rango de AUM y umbrales de retorno. Requiere el scope `fci:read`.
</Note>

## Parámetros de consulta

<ParamField type="string">
  Fecha de referencia en formato YYYY-MM-DD. Predeterminado: último cierre disponible.
</ParamField>

<ParamField type="string">
  Devuelve solo fondos cuya moneda nativa coincide. Valores: `ARS`, `USD`.
</ParamField>

<ParamField type="string">
  Moneda de salida para AUM y retornos. Valores: `ARS`, `USD`.
</ParamField>

<ParamField type="string">
  Tipo de cambio usado para la conversión de moneda.
</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 type="string[]">
  Nombres exactos de fondos. Repetí el parámetro para incluir varios (ej., `fund_names=A&fund_names=B`).
</ParamField>

<ParamField type="string">
  Sociedad gerente (coincidencia exacta).
</ParamField>

<ParamField type="string">
  Sociedad depositaria (coincidencia exacta).
</ParamField>

<ParamField type="string">
  Tipo de renta / categoría del fondo (coincidencia exacta). Por ejemplo, money market es `Mercado de Dinero`.
</ParamField>

<ParamField type="string">
  Región (ej., "Argentina", "Latinoamerica").
</ParamField>

<ParamField type="string">
  Benchmark declarado del fondo.
</ParamField>

<ParamField type="string">
  Horizonte de inversión (ej., "Corto Plazo").
</ParamField>

<ParamField type="string">
  Bucket de duration.
</ParamField>

<ParamField type="string">
  Tipo de fondo: `Abierto` o `Cerrado`.
</ParamField>

<ParamField type="string">
  Clase de cuotaparte (ej., "Mayorista", "Minorista").
</ParamField>

<Info>
  Los filtros categóricos (<code>gerente</code>, <code>depositaria</code>, <code>rent\_type</code>, <code>region</code>, <code>horizon</code>, <code>fund\_type</code>, <code>class\_type</code>, etc.) usan coincidencia exacta. Obtené los valores válidos de <code>GET /api/v1/fci/catalog</code> y usalos textualmente.
</Info>

<ParamField type="number">
  AUM mínimo, expresado en `target_currency`.
</ParamField>

<ParamField type="number">
  AUM máximo, expresado en `target_currency`.
</ParamField>

<ParamField type="string">
  Período al que aplican los filtros `min_return`/`max_return`. Valores: `1D`, `1W`, `1M`, `YTD`, `1Y`.
</ParamField>

<ParamField type="number">
  Retorno mínimo para `return_period`, en decimal (ej., 0.05 = 5%).
</ParamField>

<ParamField type="number">
  Retorno máximo para `return_period`, en decimal.
</ParamField>

<ParamField type="boolean">
  Excluye fondos marcados con retornos diarios atípicos (mayores al 20%).
</ParamField>

<ParamField type="string">
  Criterio de ordenamiento.
</ParamField>

<Info>
  Valores válidos para <code>order\_by</code>:

  * <code>aum</code>
  * <code>age\_days</code>
  * <code>return\_1d</code>
  * <code>return\_1w</code>
  * <code>return\_1m</code>
  * <code>return\_ytd</code>
  * <code>return\_1y</code>
</Info>

<ParamField type="string">
  Dirección del ordenamiento: `asc` o `desc`. Los valores nulos van siempre al final.
</ParamField>

<ParamField type="integer">
  Máximo de resultados por página (1-500).
</ParamField>

<ParamField type="integer">
  Desplazamiento de paginación.
</ParamField>

## Ejemplo de Solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.doctacapital.com.ar/api/v1/fci/instruments?rent_type=Mercado%20de%20Dinero&order_by=aum&limit=2" \
    -H "Authorization: Bearer $DOCTA_TOKEN"
  ```
</RequestExample>

## Respuesta Exitosa

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

<ResponseField name="native_currency_filter" type="string | null">
  Filtro de moneda nativa aplicado, si se especificó.
</ResponseField>

<ResponseField name="target_currency" type="string">
  Moneda de salida de AUM y retornos.
</ResponseField>

<ResponseField name="fx_kind" type="string">
  Tipo de cambio usado para la conversión.
</ResponseField>

<ResponseField name="filters_applied" type="object">
  Filtros aplicados en la solicitud.
</ResponseField>

<ResponseField name="ordering" type="object">
  Ordenamiento aplicado, con `by` y `dir`.
</ResponseField>

<ResponseField name="pagination" type="object">
  Paginación aplicada, con `limit` y `offset`.
</ResponseField>

<ResponseField name="total_matches" type="integer">
  Cantidad total de fondos que cumplen los filtros.
</ResponseField>

<ResponseField name="page_size" type="integer">
  Cantidad de fondos en esta página.
</ResponseField>

<ResponseField name="funds" type="array">
  Lista de fondos de la página.
</ResponseField>

<ResponseField name="funds[].fund_name" type="string">
  Nombre del fondo.
</ResponseField>

<ResponseField name="funds[].manager_name" type="string">
  Sociedad gerente.
</ResponseField>

<ResponseField name="funds[].depositary_name" type="string">
  Sociedad depositaria.
</ResponseField>

<ResponseField name="funds[].native_currency" type="string">
  Moneda nativa del fondo.
</ResponseField>

<ResponseField name="funds[].rent_type" type="string">
  Tipo de renta / categoría.
</ResponseField>

<ResponseField name="funds[].class_type" type="string">
  Clase de cuotaparte.
</ResponseField>

<ResponseField name="funds[].fund_type" type="string">
  Tipo de fondo (Abierto / Cerrado).
</ResponseField>

<ResponseField name="funds[].region" type="string">
  Región.
</ResponseField>

<ResponseField name="funds[].horizon" type="string">
  Horizonte de inversión.
</ResponseField>

<ResponseField name="funds[].aum" type="number">
  Patrimonio administrado en `target_currency`.
</ResponseField>

<ResponseField name="funds[].fx_rate_applied" type="number | null">
  Tipo de cambio aplicado en la conversión. Es null si no hubo conversión.
</ResponseField>

<ResponseField name="funds[].age_days" type="integer">
  Antigüedad del fondo en días dentro de la ventana de datos.
</ResponseField>

<ResponseField name="funds[].last_quote_date" type="string">
  Última fecha con cotización disponible.
</ResponseField>

<ResponseField name="funds[].performance" type="object">
  Retornos preestablecidos por período (`1D`, `1W`, `1M`, `YTD`, `1Y`). Cada período incluye `return` (decimal), `missing_days_in_window` e `insufficient_history`.
</ResponseField>

<ResponseField name="funds[].outlier_suspected" type="boolean | null">
  Indica si el fondo tiene retornos diarios sospechados como atípicos.
</ResponseField>

<ResponseField name="data_quality" type="object">
  Calidad de datos del universo: `funds_total`, `funds_with_real_data`, `funds_with_partial_data`, `funds_with_outliers`, `funds_excluded`, `funds_insufficient_history`, `fx_carried_forward_funds` y `reference_date`.
</ResponseField>

## Ejemplo de Respuesta Exitosa

<ResponseExample>
  ```json Success theme={null}
  {
    "reference_date": "2026-08-02",
    "native_currency_filter": null,
    "target_currency": "ARS",
    "fx_kind": "mep",
    "filters_applied": {
      "native_currency_filter": null
    },
    "ordering": {
      "by": "aum",
      "dir": "desc"
    },
    "pagination": {
      "limit": 2,
      "offset": 0
    },
    "total_matches": 4047,
    "page_size": 2,
    "funds": [
      {
        "fund_name": "Mercado Fondo - Clase A",
        "manager_name": "Mercado Pago Asset Managemet S.A.",
        "depositary_name": "Banco Industrial S.A.",
        "native_currency": "ARS",
        "rent_type": "Mercado de Dinero",
        "class_type": "Minorista",
        "fund_type": "Abierto",
        "region": "Argentina",
        "horizon": "Corto Plazo",
        "aum": 7882693319912.59,
        "fx_rate_applied": null,
        "age_days": 574,
        "last_quote_date": "2026-07-30",
        "performance": {
          "1D": {
            "return": 0.0004767150468019121,
            "missing_days_in_window": 0,
            "insufficient_history": false
          },
          "1W": {
            "return": 0.003353703949822595,
            "missing_days_in_window": 0,
            "insufficient_history": false
          },
          "YTD": {
            "return": 0.12882713824396963,
            "missing_days_in_window": 0,
            "insufficient_history": false
          }
        },
        "outlier_suspected": null
      }
    ],
    "data_quality": {
      "funds_total": 4570,
      "funds_with_real_data": 3478,
      "funds_with_partial_data": 569,
      "funds_with_outliers": 0,
      "funds_excluded": 523,
      "funds_insufficient_history": 569,
      "fx_carried_forward_funds": 0,
      "reference_date": "2026-08-02"
    }
  }
  ```
</ResponseExample>


# Detalle de FCI
Source: https://docs.doctacapital.com.ar/api-reference/endpoint/fci-instruments-detail

GET /api/v1/fci/instruments/{fund_name}
Detalle enriquecido de un fondo: metadata (gestora, depositaria, categoría), economics (fees, inversión mínima), composición de cartera (top holdings, HHI) y retornos preestablecidos. Si CAFCI no está disponible, la respuesta es parcial y cafci_unavailable=true.

<Note>
  Devuelve el detalle enriquecido de un fondo: metadatos (gerente, depositaria, categoría, horizonte), economics (comisiones, inversión mínima), composición de cartera (principales tenencias, HHI) y retornos preestablecidos (1D/1W/1M/3M/6M/YTD/1Y). Requiere el scope `fci:read`.
</Note>

## Parámetros de ruta

<ParamField type="string">
  Nombre del fondo. Va URL-encodeado, ya que los nombres contienen espacios (ej., `Premier%20Abierto%20Pymes%20-%20Clase%20A`).
</ParamField>

## Parámetros de consulta

<ParamField type="string">
  Conversión de moneda. Con `none` los valores quedan en la moneda nativa del fondo.
</ParamField>

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

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

## Ejemplo de Solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.doctacapital.com.ar/api/v1/fci/instruments/Premier%20Abierto%20Pymes%20-%20Clase%20A?fx=none" \
    -H "Authorization: Bearer $DOCTA_TOKEN"
  ```
</RequestExample>

## Respuesta Exitosa

<ResponseField name="fund_name" type="string">
  Nombre del fondo.
</ResponseField>

<ResponseField name="currency" type="string">
  Moneda nativa del fondo.
</ResponseField>

<ResponseField name="fx" type="string">
  Conversión de moneda solicitada.
</ResponseField>

<ResponseField name="output_currency" type="string">
  Moneda de salida de los valores.
</ResponseField>

<ResponseField name="metadata" type="object">
  Metadatos del fondo: `manager_name`, `depositary_name`, `class_type`, `fund_type`, `rent_type`, `region`, `benchmark`, `horizon` y `duration`.
</ResponseField>

<ResponseField name="economics" type="object | null">
  Economics del fondo: `minimum_investment`, `management_fee`, `redemption_fee`, `subscription_fee`, `transfer_fee`, `custodian_fee` y `objective` (descripción del objetivo de inversión). Es null cuando CAFCI no está disponible.
</ResponseField>

<ResponseField name="composition" type="object | null">
  Composición de cartera: `total_holdings`, `top_5` y `top_10` (listas de tenencias con `name` y `share` en porcentaje), `hhi` (índice de concentración Herfindahl-Hirschman) y `no_composition_data`. Es null cuando CAFCI no está disponible.
</ResponseField>

<ResponseField name="performance" type="object">
  Retornos preestablecidos por período (`1D`, `1W`, `1M`, `3M`, `6M`, `YTD`, `1Y`). Cada período incluye `return` (decimal), `anchor_date`, `end_date` e `insufficient_history`.
</ResponseField>

<ResponseField name="cafci_unavailable" type="boolean">
  Indica una respuesta parcial: cuando la fuente CAFCI no responde, este campo es `true` y `economics` y `composition` vuelven en null. El resto del detalle sigue disponible.
</ResponseField>

<ResponseField name="data_quality" type="object">
  Calidad de los datos del fondo: `real_data_pct`, `last_real_data_date`, `gap_count`, `long_gaps_detected`, `interpolated_days`, `missing_days`, `aum_estimated_days`, `fx_carried_forward_days` y `total_days`.
</ResponseField>

## Ejemplo de Respuesta Exitosa

<ResponseExample>
  ```json Success theme={null}
  {
    "fund_name": "Premier Abierto Pymes - Clase A",
    "currency": "ARS",
    "fx": "none",
    "output_currency": "ARS",
    "metadata": {
      "manager_name": "Supervielle Asset Management S.A.",
      "depositary_name": "Banco Supervielle S.A.",
      "class_type": "Mayorista",
      "fund_type": "Abierto",
      "rent_type": "PyMes",
      "region": "Argentina",
      "benchmark": "Otro",
      "horizon": "Mediano Plazo",
      "duration": "No Aplicable"
    },
    "economics": {
      "minimum_investment": 1.0,
      "management_fee": 2.024,
      "redemption_fee": null,
      "subscription_fee": null,
      "transfer_fee": 0.0,
      "custodian_fee": 0.176,
      "objective": "Es un fondo que invierte en activos de renta fija principalmente ChPD Ons y FF de emisores Pymes."
    },
    "composition": {
      "total_holdings": 11,
      "top_5": [
        {
          "name": "Resto de Activos",
          "share": 52.4
        },
        {
          "name": "Caucion Colocadora $ Merval",
          "share": 15.4
        },
        {
          "name": "Bono Dual TXMJ0",
          "share": 8.2
        }
      ],
      "hhi": 3114.97,
      "no_composition_data": false
    },
    "performance": {
      "1D": {
        "return": 0.0008049373324414688,
        "anchor_date": "2026-07-29",
        "end_date": "2026-07-30",
        "insufficient_history": false
      },
      "1M": {
        "return": 0.016567519671488284,
        "anchor_date": "2026-06-30",
        "end_date": "2026-07-30",
        "insufficient_history": false
      },
      "1Y": {
        "return": 0.4372903452209189,
        "anchor_date": "2025-07-30",
        "end_date": "2026-07-30",
        "insufficient_history": false
      }
    },
    "cafci_unavailable": false,
    "data_quality": {
      "real_data_pct": 0.983333,
      "last_real_data_date": "2026-07-30",
      "gap_count": 0,
      "long_gaps_detected": [],
      "interpolated_days": 1,
      "missing_days": 0,
      "aum_estimated_days": 1,
      "fx_carried_forward_days": 0,
      "total_days": 60
    }
  }
  ```
</ResponseExample>


# Buscar FCI
Source: https://docs.doctacapital.com.ar/api-reference/endpoint/fci-instruments-search

GET /api/v1/fci/instruments/search
Buscar fondos por campo elegido con matching insensible a mayúsculas y acentos (exact > prefix > contains > fuzzy).

<Note>
  Busca fondos por texto sobre un campo elegido, con matching insensible a mayúsculas y acentos y puntaje por tipo de coincidencia (exacta > prefijo > prefijo de token > contiene > fuzzy). Requiere el scope `fci:read`.
</Note>

## Parámetros de consulta

<ParamField type="string">
  Texto de búsqueda (insensible a mayúsculas y acentos).
</ParamField>

<ParamField type="string">
  Campo contra el que se busca.
</ParamField>

<Info>
  Valores válidos para <code>field</code>:

  * <code>fund\_name</code>
  * <code>manager\_name</code>
  * <code>depositary\_name</code>
  * <code>rent\_type</code>
  * <code>horizon</code>
</Info>

<ParamField type="integer">
  Máximo de resultados por página (1-100).
</ParamField>

<ParamField type="integer">
  Desplazamiento de paginación.
</ParamField>

## Ejemplo de Solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.doctacapital.com.ar/api/v1/fci/instruments/search?query=premier&field=fund_name&limit=3" \
    -H "Authorization: Bearer $DOCTA_TOKEN"
  ```
</RequestExample>

## Respuesta Exitosa

<ResponseField name="query" type="string">
  Texto de búsqueda utilizado.
</ResponseField>

<ResponseField name="field" type="string">
  Campo contra el que se buscó.
</ResponseField>

<ResponseField name="total_matches" type="integer">
  Cantidad total de coincidencias.
</ResponseField>

<ResponseField name="limit" type="integer">
  Límite aplicado.
</ResponseField>

<ResponseField name="offset" type="integer">
  Desplazamiento aplicado.
</ResponseField>

<ResponseField name="no_matches" type="boolean">
  Indica si la búsqueda no arrojó resultados.
</ResponseField>

<ResponseField name="results" type="array">
  Lista de fondos encontrados, ordenados por puntaje.
</ResponseField>

<ResponseField name="results[].fund_name" type="string">
  Nombre del fondo.
</ResponseField>

<ResponseField name="results[].manager_name" type="string">
  Sociedad gerente.
</ResponseField>

<ResponseField name="results[].depositary_name" type="string">
  Sociedad depositaria.
</ResponseField>

<ResponseField name="results[].currency" type="string">
  Moneda del fondo.
</ResponseField>

<ResponseField name="results[].rent_type" type="string">
  Tipo de renta / categoría.
</ResponseField>

<ResponseField name="results[].class_type" type="string">
  Clase de cuotaparte.
</ResponseField>

<ResponseField name="results[].fund_type" type="string">
  Tipo de fondo (Abierto / Cerrado).
</ResponseField>

<ResponseField name="results[].horizon" type="string">
  Horizonte de inversión.
</ResponseField>

<ResponseField name="results[].matched_value" type="string">
  Valor del campo que produjo la coincidencia.
</ResponseField>

<ResponseField name="results[].score" type="integer">
  Puntaje de la coincidencia (mayor es mejor).
</ResponseField>

## Ejemplo de Respuesta Exitosa

<ResponseExample>
  ```json Success theme={null}
  {
    "query": "premier",
    "field": "fund_name",
    "total_matches": 74,
    "limit": 3,
    "offset": 0,
    "no_matches": false,
    "results": [
      {
        "fund_name": "Premier Abierto Pymes - Clase A",
        "manager_name": "Supervielle Asset Management S.A.",
        "depositary_name": "Banco Supervielle S.A.",
        "currency": "ARS",
        "rent_type": "PyMes",
        "class_type": "Mayorista",
        "fund_type": "Abierto",
        "horizon": "Mediano Plazo",
        "matched_value": "Premier Abierto Pymes - Clase A",
        "score": 4
      },
      {
        "fund_name": "Premier Abierto Pymes - Clase B",
        "manager_name": "Supervielle Asset Management S.A.",
        "depositary_name": "Banco Supervielle S.A.",
        "currency": "ARS",
        "rent_type": "PyMes",
        "class_type": "Minorista",
        "fund_type": "Abierto",
        "horizon": "Mediano Plazo",
        "matched_value": "Premier Abierto Pymes - Clase B",
        "score": 4
      },
      {
        "fund_name": "Premier Abierto Pymes - Clase C",
        "manager_name": "Supervielle Asset Management S.A.",
        "depositary_name": "Banco Supervielle S.A.",
        "currency": "ARS",
        "rent_type": "PyMes",
        "class_type": "No Registrada",
        "fund_type": "Abierto",
        "horizon": "Mediano Plazo",
        "matched_value": "Premier Abierto Pymes - Clase C",
        "score": 4
      }
    ]
  }
  ```
</ResponseExample>


# Distribución de AUM
Source: https://docs.doctacapital.com.ar/api-reference/endpoint/fci-market-aum-distribution

GET /api/v1/fci/market/aum-distribution
Distribución de AUM por categoría a una fecha de referencia: AUM, participación de mercado y cantidad de fondos por categoría.

<Note>
  Distribución del AUM de la industria por categoría a una fecha de referencia: AUM, participación sobre la industria y cantidad de fondos por categoría. Requiere el scope `fci:read`.
</Note>

## Parámetros de consulta

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

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

<ParamField 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 type="string">
  Apertura de la distribución. Por ahora solo se admite `sub_category` (predeterminado).
</ParamField>

<ParamField 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/aum-distribution?target_currency=ARS" \
    -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="breakdown" type="string">
  Apertura aplicada (`sub_category`).
</ResponseField>

<ResponseField name="vigent_days_window" type="integer">
  Ventana de vigencia aplicada.
</ResponseField>

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

<ResponseField name="categories" type="array">
  Una entrada por categoría.
</ResponseField>

<ResponseField name="categories[].category" type="string">
  Nombre de la categoría (ej., "Mercado de Dinero").
</ResponseField>

<ResponseField name="categories[].aum" type="number">
  AUM de la categoría, expresado en `target_currency`.
</ResponseField>

<ResponseField name="categories[].share_pct" type="number">
  Participación de la categoría sobre la industria, expresada como porcentaje (ej., 53.66 = 53.66%).
</ResponseField>

<ResponseField name="categories[].fund_count" type="integer">
  Cantidad de fondos en la categoría.
</ResponseField>

<ResponseField name="data_quality" type="object">
  Metadatos de calidad: `funds_total`, `funds_with_real_data`, `fx_carried_forward` 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",
    "breakdown": "sub_category",
    "vigent_days_window": 5,
    "total_aum": 105081584883560.0,
    "categories": [
      {
        "category": "Mercado de Dinero",
        "aum": 56385165799267.4,
        "share_pct": 53.658465336002806,
        "fund_count": 242
      },
      {
        "category": "Renta Fija",
        "aum": 27111005010171.2,
        "share_pct": 25.79995823265577,
        "fund_count": 992
      },
      {
        "category": "Sin clasificar",
        "aum": 8380970595105.71,
        "share_pct": 7.975679662990038,
        "fund_count": 357
      }
    ],
    "data_quality": {
      "funds_total": 4672,
      "funds_with_real_data": 2431,
      "fx_carried_forward": false,
      "reference_date": "2026-07-30"
    }
  }
  ```
</ResponseExample>


# Flujos por categoría
Source: https://docs.doctacapital.com.ar/api-reference/endpoint/fci-market-flows-by-category

GET /api/v1/fci/market/flows-by-category
Flujos netos de suscripciones/rescates de una categoría en un rango. El parámetro category es obligatorio.

<Note>
  Flujo neto de suscripciones y rescates de una categoría sobre un rango de fechas, con cantidad de fondos e indicadores de datos parciales. Requiere el scope `fci:read`. Para la agregación de toda la industria, usar `GET /api/v1/fci/market/series` con `metric=net_flow`.
</Note>

## Parámetros de consulta

<ParamField type="string">
  Categoría a consultar. La comparación es exacta (ej., `Mercado de Dinero`).
</ParamField>

<ParamField type="string">
  Intervalo de fechas, mutuamente excluyente con `date_from`/`date_to`. Ejemplos: `1 week`, `1 month`, `3 months`, `ytd`, `1 year`, `max` (también acepta los alias cortos `1W`, `1M`, `3M`, `YTD`, `1Y`).
</ParamField>

<ParamField type="string">
  Inicio del rango en formato YYYY-MM-DD. Mutuamente excluyente con `interval`.
</ParamField>

<ParamField type="string">
  Fin del rango en formato YYYY-MM-DD (predeterminado: último cierre). Mutuamente excluyente con `interval`.
</ParamField>

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

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

<ParamField type="string">
  Tratamiento de los fondos con retornos diarios atípicos (predeterminado `exclude_fund`).
</ParamField>

<Info>
  Valores válidos para <code>outlier\_handling</code>:

  * <code>exclude\_fund</code>: excluye el fondo completo del cálculo
  * <code>skip\_days</code>: omite solo los días atípicos
  * <code>include</code>: incluye todos los datos sin filtrar
</Info>

<ParamField type="boolean">
  Incluye un reporte de outliers en la respuesta (predeterminado `false`).
</ParamField>

## Ejemplo de Solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -G "https://api.doctacapital.com.ar/api/v1/fci/market/flows-by-category" \
    -H "Authorization: Bearer $DOCTA_TOKEN" \
    --data-urlencode "category=Mercado de Dinero" \
    --data-urlencode "interval=1 month"
  ```
</RequestExample>

## Respuesta Exitosa

<ResponseField name="requested_range" type="object">
  Rango solicitado, con `from` y `to` en formato YYYY-MM-DD.
</ResponseField>

<ResponseField name="effective_range" type="object">
  Rango efectivo con datos disponibles, con `from` y `to` en formato YYYY-MM-DD.
</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="vigent_days_window" type="integer">
  Ventana de vigencia aplicada.
</ResponseField>

<ResponseField name="breakdown" type="string">
  Apertura aplicada (`sub_category`).
</ResponseField>

<ResponseField name="outlier_handling" type="string">
  Tratamiento de outliers aplicado.
</ResponseField>

<ResponseField name="filters_applied" type="object">
  Filtros aplicados en la solicitud, incluye `category`.
</ResponseField>

<ResponseField name="no_matches" type="boolean">
  Indica si la categoría no tuvo coincidencias.
</ResponseField>

<ResponseField name="total_net_flow" type="number | null">
  Flujo neto total en el rango. Es null cuando no puede calcularse de forma completa.
</ResponseField>

<ResponseField name="categories" type="array">
  Una entrada por categoría coincidente.
</ResponseField>

<ResponseField name="categories[].category" type="string">
  Nombre de la categoría.
</ResponseField>

<ResponseField name="categories[].net_flow" type="number | null">
  Flujo neto de la categoría en el rango, expresado en `target_currency`. Es null cuando no puede calcularse.
</ResponseField>

<ResponseField name="categories[].fund_count" type="integer">
  Cantidad de fondos en la categoría.
</ResponseField>

<ResponseField name="categories[].funds_with_partial_data" type="integer">
  Cantidad de fondos con datos parciales dentro del rango.
</ResponseField>

<ResponseField name="data_quality" type="object">
  Metadatos de calidad: `funds_total`, `funds_with_real_data`, `funds_with_partial_data`, `funds_excluded_by_outliers`, `fx_carried_forward_funds` y `reference_date`.
</ResponseField>

## Ejemplo de Respuesta Exitosa

<ResponseExample>
  ```json Success theme={null}
  {
    "requested_range": {
      "from": "2026-07-02",
      "to": "2026-08-02"
    },
    "effective_range": {
      "from": "2026-07-02",
      "to": "2026-07-30"
    },
    "target_currency": "ARS",
    "fx_kind": "mep",
    "vigent_days_window": 5,
    "breakdown": "sub_category",
    "outlier_handling": "exclude_fund",
    "filters_applied": {
      "category": "Mercado de Dinero"
    },
    "no_matches": false,
    "total_net_flow": null,
    "categories": [
      {
        "category": "Mercado de Dinero",
        "net_flow": null,
        "fund_count": 242,
        "funds_with_partial_data": 0
      }
    ],
    "data_quality": {
      "funds_total": 4672,
      "funds_with_real_data": 242,
      "funds_with_partial_data": 0,
      "funds_excluded_by_outliers": 0,
      "fx_carried_forward_funds": 0,
      "reference_date": "2026-07-30"
    }
  }
  ```
</ResponseExample>


# KPIs de mercado FCI
Source: https://docs.doctacapital.com.ar/api-reference/endpoint/fci-market-kpis

GET /api/v1/fci/market/kpis
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 type="string">
  Fecha de referencia en formato YYYY-MM-DD (predeterminado: último cierre).
</ParamField>

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

<ParamField 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 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>


# Serie de mercado FCI
Source: https://docs.doctacapital.com.ar/api-reference/endpoint/fci-market-series

GET /api/v1/fci/market/series
Serie temporal de la industria para una métrica (aum, funds_count o net_flow) con breakdown opcional (category o currency), granularidad diaria/semanal/mensual y filtros por categoría o gestora.

<Note>
  Serie temporal de la industria de FCI para una métrica (`aum`, `funds_count` o `net_flow`), con apertura opcional por categoría o moneda, granularidad diaria/semanal/mensual y filtros por categoría o gestora. Requiere el scope `fci:read`.
</Note>

## Parámetros de consulta

<ParamField type="string">
  Métrica a agregar.
</ParamField>

<Info>
  Valores válidos para <code>metric</code>:

  * <code>aum</code>: AUM total
  * <code>funds\_count</code>: cantidad de fondos vigentes
  * <code>net\_flow</code>: flujo neto de suscripciones y rescates
</Info>

<ParamField type="string">
  Intervalo de fechas, mutuamente excluyente con `date_from`/`date_to`. Ejemplos: `1 week`, `1 month`, `3 months`, `ytd`, `1 year`, `max` (también acepta los alias cortos `1W`, `1M`, `3M`, `YTD`, `1Y`).
</ParamField>

<ParamField type="string">
  Inicio del rango en formato YYYY-MM-DD. Mutuamente excluyente con `interval`.
</ParamField>

<ParamField type="string">
  Fin del rango en formato YYYY-MM-DD (predeterminado: último cierre). Mutuamente excluyente con `interval`.
</ParamField>

<ParamField type="string">
  Apertura de la serie en buckets (predeterminado `none`).
</ParamField>

<Info>
  Valores válidos para <code>breakdown</code>:

  * <code>none</code>: serie única para toda la industria
  * <code>category</code>: una serie por categoría
  * <code>currency</code>: una serie por moneda
</Info>

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

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

<ParamField type="string">
  Tratamiento de los fondos con retornos diarios atípicos (predeterminado `exclude_fund`).
</ParamField>

<Info>
  Valores válidos para <code>outlier\_handling</code>:

  * <code>exclude\_fund</code>: excluye el fondo completo del cálculo
  * <code>skip\_days</code>: omite solo los días atípicos
  * <code>include</code>: incluye todos los datos sin filtrar
</Info>

<ParamField type="boolean">
  Incluye un reporte de outliers en la respuesta (predeterminado `false`).
</ParamField>

<ParamField type="string">
  Filtra la serie a una categoría.
</ParamField>

<ParamField type="string">
  Filtra la serie a una gestora.
</ParamField>

<ParamField type="string">
  Granularidad de muestreo (predeterminado `daily`).
</ParamField>

<Info>
  Valores válidos para <code>granularity</code>:

  * <code>daily</code>
  * <code>weekly</code>
  * <code>monthly</code>
</Info>

## Ejemplo de Solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -G "https://api.doctacapital.com.ar/api/v1/fci/market/series" \
    -H "Authorization: Bearer $DOCTA_TOKEN" \
    --data-urlencode "metric=aum" \
    --data-urlencode "interval=1 month" \
    --data-urlencode "granularity=weekly"
  ```
</RequestExample>

## Respuesta Exitosa

<ResponseField name="metric" type="string">
  Métrica agregada.
</ResponseField>

<ResponseField name="breakdown" type="string">
  Apertura aplicada.
</ResponseField>

<ResponseField name="granularity" type="string">
  Granularidad aplicada.
</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="vigent_days_window" type="integer">
  Ventana de vigencia aplicada.
</ResponseField>

<ResponseField name="outlier_handling" type="string">
  Tratamiento de outliers aplicado.
</ResponseField>

<ResponseField name="filters_applied" type="object">
  Filtros aplicados en la solicitud (`category`, `manager`).
</ResponseField>

<ResponseField name="requested_range" type="object">
  Rango solicitado, con `from` y `to` en formato YYYY-MM-DD.
</ResponseField>

<ResponseField name="effective_range" type="object">
  Rango efectivo con datos disponibles, con `from` y `to` en formato YYYY-MM-DD.
</ResponseField>

<ResponseField name="series" type="array">
  Puntos de la serie. Con `breakdown=none` cada punto tiene `date` (YYYY-MM-DD) y `value` (en `target_currency` para `aum` y `net_flow`; entero para `funds_count`). Con apertura por categoría o moneda, los puntos se agrupan por bucket.
</ResponseField>

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

## Ejemplo de Respuesta Exitosa

<ResponseExample>
  ```json Success theme={null}
  {
    "metric": "aum",
    "breakdown": "none",
    "granularity": "weekly",
    "target_currency": "ARS",
    "fx_kind": "mep",
    "vigent_days_window": 5,
    "outlier_handling": "exclude_fund",
    "filters_applied": {},
    "requested_range": {
      "from": "2026-07-02",
      "to": "2026-08-02"
    },
    "effective_range": {
      "from": "2026-07-03",
      "to": "2026-07-30"
    },
    "series": [
      {
        "date": "2026-07-03",
        "value": 106422408976946.19
      },
      {
        "date": "2026-07-08",
        "value": 106186067544387.39
      },
      {
        "date": "2026-07-17",
        "value": 104155695727697.48
      }
    ],
    "data_quality": {
      "funds_total": 4672,
      "funds_total_universe": 4672,
      "funds_with_real_data": 2453,
      "funds_excluded_by_outliers": 0,
      "reference_date": "2026-07-30"
    }
  }
  ```
</ResponseExample>


# Ranking de gestoras
Source: https://docs.doctacapital.com.ar/api-reference/endpoint/fci-market-top-managers

GET /api/v1/fci/market/top-managers
Ranking de gestoras por AUM a una fecha de referencia, con participación de mercado y cantidad de fondos por gestora.

<Note>
  Ranking de gestoras por AUM a una fecha de referencia, con participación sobre la industria y cantidad de fondos por gestora. Requiere el scope `fci:read`.
</Note>

## Parámetros de consulta

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

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

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

<ParamField type="integer">
  Máximo de gestoras por página (predeterminado 20, rango 1-100).
</ParamField>

<ParamField type="integer">
  Desplazamiento de paginación (predeterminado 0).
</ParamField>

## Ejemplo de Solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.doctacapital.com.ar/api/v1/fci/market/top-managers?top=20&offset=0" \
    -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="vigent_days_window" type="integer">
  Ventana de vigencia aplicada.
</ResponseField>

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

<ResponseField name="total_managers" type="integer">
  Cantidad total de gestoras en el ranking.
</ResponseField>

<ResponseField name="top_returned" type="integer">
  Cantidad de gestoras devueltas en esta página.
</ResponseField>

<ResponseField name="offset" type="integer">
  Desplazamiento aplicado.
</ResponseField>

<ResponseField name="managers" type="array">
  Una entrada por gestora, ordenada por AUM.
</ResponseField>

<ResponseField name="managers[].rank" type="integer">
  Posición en el ranking.
</ResponseField>

<ResponseField name="managers[].manager_name" type="string">
  Nombre de la gestora.
</ResponseField>

<ResponseField name="managers[].aum" type="number">
  AUM de la gestora, expresado en `target_currency`.
</ResponseField>

<ResponseField name="managers[].share_pct" type="number">
  Participación sobre la industria, expresada como porcentaje (ej., 14.9 = 14.9%).
</ResponseField>

<ResponseField name="managers[].fund_count" type="integer">
  Cantidad de fondos de la gestora.
</ResponseField>

## Ejemplo de Respuesta Exitosa

<ResponseExample>
  ```json Success theme={null}
  {
    "reference_date": "2026-07-30",
    "data_lag": true,
    "target_currency": "ARS",
    "fx_kind": "mep",
    "vigent_days_window": 5,
    "industry_total_aum": 105081584883559.95,
    "total_managers": 57,
    "top_returned": 3,
    "offset": 0,
    "managers": [
      {
        "rank": 1,
        "manager_name": "Galicia Asset Management S.A.U.",
        "aum": 15653530692515.19,
        "share_pct": 14.896549866335512,
        "fund_count": 59
      },
      {
        "rank": 2,
        "manager_name": "Santander Rio Asset Management G.F.C.I.S.A.",
        "aum": 12136881301326.12,
        "share_pct": 11.549960266372937,
        "fund_count": 85
      },
      {
        "rank": 3,
        "manager_name": "Sin gestora",
        "aum": 8093521631387.21,
        "share_pct": 7.702131291943851,
        "fund_count": 351
      }
    ]
  }
  ```
</ResponseExample>


# Gestoras por flujo
Source: https://docs.doctacapital.com.ar/api-reference/endpoint/fci-market-top-managers-by-flow

GET /api/v1/fci/market/top-managers-by-flow
Ranking de gestoras por flujo neto de suscripciones/rescates en un rango, con AUM y cantidad de fondos al cierre.

<Note>
  Ranking de gestoras por flujo neto de suscripciones y rescates sobre un rango de fechas, con AUM y cantidad de fondos al cierre del rango. Requiere el scope `fci:read`.
</Note>

## Parámetros de consulta

<ParamField type="string">
  Intervalo de fechas, mutuamente excluyente con `date_from`/`date_to`. Ejemplos: `1 week`, `1 month`, `3 months`, `ytd`, `1 year`, `max` (también acepta los alias cortos `1W`, `1M`, `3M`, `YTD`, `1Y`).
</ParamField>

<ParamField type="string">
  Inicio del rango en formato YYYY-MM-DD. Mutuamente excluyente con `interval`.
</ParamField>

<ParamField type="string">
  Fin del rango en formato YYYY-MM-DD (predeterminado: último cierre). Mutuamente excluyente con `interval`.
</ParamField>

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

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

<ParamField type="integer">
  Máximo de gestoras por página (predeterminado 20, rango 1-100).
</ParamField>

<ParamField type="integer">
  Desplazamiento de paginación (predeterminado 0).
</ParamField>

<ParamField type="string">
  Tratamiento de los fondos con retornos diarios atípicos (predeterminado `exclude_fund`).
</ParamField>

<Info>
  Valores válidos para <code>outlier\_handling</code>:

  * <code>exclude\_fund</code>: excluye el fondo completo del cálculo
  * <code>skip\_days</code>: omite solo los días atípicos
  * <code>include</code>: incluye todos los datos sin filtrar
</Info>

<ParamField type="boolean">
  Incluye un reporte de outliers en la respuesta (predeterminado `false`).
</ParamField>

## Ejemplo de Solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -G "https://api.doctacapital.com.ar/api/v1/fci/market/top-managers-by-flow" \
    -H "Authorization: Bearer $DOCTA_TOKEN" \
    --data-urlencode "interval=1 month" \
    --data-urlencode "top=20"
  ```
</RequestExample>

## Respuesta Exitosa

<ResponseField name="requested_range" type="object">
  Rango solicitado, con `from` y `to` en formato YYYY-MM-DD.
</ResponseField>

<ResponseField name="effective_range" type="object">
  Rango efectivo con datos disponibles, con `from` y `to` en formato YYYY-MM-DD.
</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="vigent_days_window" type="integer">
  Ventana de vigencia aplicada.
</ResponseField>

<ResponseField name="outlier_handling" type="string">
  Tratamiento de outliers aplicado.
</ResponseField>

<ResponseField name="industry_total_flow" type="number | null">
  Flujo neto total de la industria en el rango. Es null cuando no puede calcularse de forma completa.
</ResponseField>

<ResponseField name="total_managers" type="integer">
  Cantidad total de gestoras en el ranking.
</ResponseField>

<ResponseField name="top_returned" type="integer">
  Cantidad de gestoras devueltas en esta página.
</ResponseField>

<ResponseField name="offset" type="integer">
  Desplazamiento aplicado.
</ResponseField>

<ResponseField name="managers" type="array">
  Una entrada por gestora, ordenada por flujo neto.
</ResponseField>

<ResponseField name="managers[].rank" type="integer">
  Posición en el ranking.
</ResponseField>

<ResponseField name="managers[].manager_name" type="string">
  Nombre de la gestora.
</ResponseField>

<ResponseField name="managers[].net_flow" type="number | null">
  Flujo neto de la gestora en el rango, expresado en `target_currency`. Es null cuando no puede calcularse.
</ResponseField>

<ResponseField name="managers[].fund_count_at_end" type="integer">
  Cantidad de fondos de la gestora al cierre del rango.
</ResponseField>

<ResponseField name="managers[].aum_at_end" type="number">
  AUM de la gestora al cierre del rango, expresado en `target_currency`.
</ResponseField>

<ResponseField name="managers[].partial_period" type="boolean">
  Indica si la gestora tiene datos parciales dentro del rango.
</ResponseField>

<ResponseField name="data_quality" type="object">
  Metadatos de calidad: `funds_total`, `funds_with_real_data`, `funds_with_partial_data`, `funds_excluded_by_outliers`, `fx_carried_forward_funds` y `reference_date`.
</ResponseField>

## Ejemplo de Respuesta Exitosa

<ResponseExample>
  ```json Success theme={null}
  {
    "requested_range": {
      "from": "2026-07-02",
      "to": "2026-08-02"
    },
    "effective_range": {
      "from": "2026-07-02",
      "to": "2026-07-30"
    },
    "target_currency": "ARS",
    "fx_kind": "mep",
    "vigent_days_window": 5,
    "outlier_handling": "exclude_fund",
    "industry_total_flow": null,
    "total_managers": 57,
    "top_returned": 3,
    "offset": 0,
    "managers": [
      {
        "rank": 1,
        "manager_name": "Proahorro Administradora de Activos S.A.",
        "net_flow": 21397882607.64,
        "fund_count_at_end": 7,
        "aum_at_end": 2014636421664.33,
        "partial_period": false
      },
      {
        "rank": 2,
        "manager_name": "Sin gestora",
        "net_flow": null,
        "fund_count_at_end": 349,
        "aum_at_end": 8093521431387.21,
        "partial_period": true
      },
      {
        "rank": 3,
        "manager_name": "Pellegrini S.A.S.G.F.C.I.",
        "net_flow": 662566036721.1,
        "fund_count_at_end": 41,
        "aum_at_end": 4416762701231.56,
        "partial_period": false
      }
    ],
    "data_quality": {
      "funds_total": 4672,
      "funds_with_real_data": 2422,
      "funds_with_partial_data": 0,
      "funds_excluded_by_outliers": 6,
      "fx_carried_forward_funds": 0,
      "reference_date": "2026-07-30"
    }
  }
  ```
</ResponseExample>


# Performance de FCI
Source: https://docs.doctacapital.com.ar/api-reference/endpoint/fci-performance

GET /api/v1/fci/instruments/{fund_name}/performance
Performance descriptiva de un fondo en un rango: retorno acumulado, TNA proporcional, mejor/peor día, mejor/peor sub-período y conteo de días positivos/negativos.

<Note>
  Devuelve la performance descriptiva de un fondo sobre un rango: retorno acumulado, TNA proporcional, mejor y peor día, mejor y peor subperíodo móvil y conteo de días positivos y negativos. Requiere el scope `fci:read`.
</Note>

## Parámetros de ruta

<ParamField type="string">
  Nombre del fondo. Va URL-encodeado, ya que los nombres contienen espacios (ej., `Premier%20Abierto%20Pymes%20-%20Clase%20A`).
</ParamField>

## Parámetros de consulta

<ParamField type="string">
  Intervalo de fechas, mutuamente excluyente con `date_from`/`date_to`. Valores permitidos: `1 week`, `1 month`, `3 months`, `6 months`, `ytd`, `1 year` (también se aceptan los alias cortos `1W`, `1M`, `3M`, `6M`, `YTD`, `1Y`). A diferencia de la serie, este endpoint no acepta `max`.
</ParamField>

<ParamField type="string">
  Fecha de inicio en formato YYYY-MM-DD. Mutuamente excluyente con `interval`.
</ParamField>

<ParamField type="string">
  Fecha de fin en formato YYYY-MM-DD. Predeterminado: última fecha disponible. Mutuamente excluyente con `interval`.
</ParamField>

<ParamField type="string">
  Conversión de moneda. Con `none` los valores quedan en la moneda nativa del fondo. Valores: `none`, `mep`, `ccl`, `a3500`, `oficial_minorista`.
</ParamField>

## Ejemplo de Solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.doctacapital.com.ar/api/v1/fci/instruments/Premier%20Abierto%20Pymes%20-%20Clase%20A/performance?interval=1%20month" \
    -H "Authorization: Bearer $DOCTA_TOKEN"
  ```
</RequestExample>

## Respuesta Exitosa

<ResponseField name="fund_name" type="string">
  Nombre del fondo.
</ResponseField>

<ResponseField name="currency" type="string">
  Moneda nativa del fondo.
</ResponseField>

<ResponseField name="fx" type="string">
  Conversión de moneda solicitada.
</ResponseField>

<ResponseField name="output_currency" type="string">
  Moneda de salida de los valores.
</ResponseField>

<ResponseField name="requested_range" type="object">
  Rango solicitado, con `from` y `to`.
</ResponseField>

<ResponseField name="effective_range" type="object">
  Rango efectivo con datos disponibles, con `from` y `to`.
</ResponseField>

<ResponseField name="fund_inactive_in_range" type="boolean">
  Indica si el fondo estuvo inactivo en el rango solicitado.
</ResponseField>

<ResponseField name="performance" type="object">
  Métricas descriptivas del rango.
</ResponseField>

<ResponseField name="performance.cumulative_return" type="number">
  Retorno acumulado del rango, en decimal.
</ResponseField>

<ResponseField name="performance.tna" type="number">
  TNA proporcional del rango, en decimal.
</ResponseField>

<ResponseField name="performance.days_calendar" type="integer">
  Días calendario del rango.
</ResponseField>

<ResponseField name="performance.days_business" type="integer">
  Días hábiles del rango.
</ResponseField>

<ResponseField name="performance.best_day" type="object">
  Mejor día del rango, con `date`, `return`, `previous_vcp` y `vcp`.
</ResponseField>

<ResponseField name="performance.worst_day" type="object">
  Peor día del rango, con `date`, `return`, `previous_vcp` y `vcp`.
</ResponseField>

<ResponseField name="performance.positive_days" type="integer">
  Cantidad de días con retorno positivo.
</ResponseField>

<ResponseField name="performance.negative_days" type="integer">
  Cantidad de días con retorno negativo.
</ResponseField>

<ResponseField name="performance.best_subperiod" type="object">
  Mejor subperíodo móvil, con `start`, `end`, `return`, `label`, `start_vcp` y `end_vcp`.
</ResponseField>

<ResponseField name="performance.worst_subperiod" type="object">
  Peor subperíodo móvil, con `start`, `end`, `return`, `label`, `start_vcp` y `end_vcp`.
</ResponseField>

<ResponseField name="performance.subperiod_interval" type="string">
  Longitud del subperíodo móvil (ej., "1 week").
</ResponseField>

<ResponseField name="range_too_short_for_meaningful_metrics" type="boolean">
  Indica si el rango es demasiado corto para que las métricas sean significativas.
</ResponseField>

<ResponseField name="data_quality" type="object">
  Calidad de los datos del rango: `real_data_pct`, `last_real_data_date`, `gap_count`, `long_gaps_detected`, `interpolated_days`, `missing_days`, `aum_estimated_days`, `fx_carried_forward_days` y `total_days`.
</ResponseField>

## Ejemplo de Respuesta Exitosa

<ResponseExample>
  ```json Success theme={null}
  {
    "fund_name": "Premier Abierto Pymes - Clase A",
    "currency": "ARS",
    "fx": "none",
    "output_currency": "ARS",
    "requested_range": {
      "from": "2026-06-30",
      "to": "2026-07-30"
    },
    "effective_range": {
      "from": "2026-06-30",
      "to": "2026-07-30"
    },
    "fund_inactive_in_range": false,
    "performance": {
      "cumulative_return": 0.016567519671488284,
      "tna": 0.20157148933644078,
      "days_calendar": 30,
      "days_business": 21,
      "best_day": {
        "date": "2026-07-23",
        "return": 0.009322698105125982,
        "previous_vcp": 127330.413,
        "vcp": 128517.476
      },
      "worst_day": {
        "date": "2026-07-16",
        "return": -0.004386222108857418,
        "previous_vcp": 127709.675,
        "vcp": 127149.512
      },
      "positive_days": 12,
      "negative_days": 6,
      "best_subperiod": {
        "start": "2026-07-22",
        "end": "2026-07-29",
        "return": 0.015825441483489078,
        "label": "Semana del 22 Jul 2026",
        "start_vcp": 127330.413,
        "end_vcp": 129345.473
      },
      "worst_subperiod": {
        "start": "2026-07-15",
        "end": "2026-07-22",
        "return": -0.002969720187605218,
        "label": "Semana del 15 Jul 2026",
        "start_vcp": 127709.675,
        "end_vcp": 127330.413
      },
      "subperiod_interval": "1 week"
    },
    "range_too_short_for_meaningful_metrics": false,
    "data_quality": {
      "real_data_pct": 0.952381,
      "last_real_data_date": "2026-07-30",
      "gap_count": 0,
      "long_gaps_detected": [],
      "interpolated_days": 1,
      "missing_days": 0,
      "aum_estimated_days": 1,
      "fx_carried_forward_days": 0,
      "total_days": 21
    }
  }
  ```
</ResponseExample>


# Serie de FCI
Source: https://docs.doctacapital.com.ar/api-reference/endpoint/fci-series

GET /api/v1/fci/instruments/{fund_name}/series
Serie diaria de un fondo: VCP, AUM, flujo neto, retorno diario y acumulado, con flags de calidad de datos por punto. Rango por interval o date_from/date_to (mutuamente excluyentes).

<Note>
  Devuelve la serie diaria de un fondo: VCP (valor de cuotaparte), AUM, flujo neto, retorno diario y acumulado, con flags de interpolación, outliers y calidad de datos por punto. Requiere el scope `fci:read`.
</Note>

## Parámetros de ruta

<ParamField type="string">
  Nombre del fondo. Va URL-encodeado, ya que los nombres contienen espacios (ej., `Premier%20Abierto%20Pymes%20-%20Clase%20A`).
</ParamField>

## Parámetros de consulta

<ParamField type="string">
  Intervalo de fechas, mutuamente excluyente con `date_from`/`date_to`. Ejemplos: `1 week`, `1 month`, `3 months`, `ytd`, `1 year`, `max` (también se aceptan los alias cortos `1W`, `1M`, `3M`, `YTD`, `1Y`).
</ParamField>

<ParamField type="string">
  Fecha de inicio en formato YYYY-MM-DD. Mutuamente excluyente con `interval`.
</ParamField>

<ParamField type="string">
  Fecha de fin en formato YYYY-MM-DD. Predeterminado: última fecha disponible. Mutuamente excluyente con `interval`.
</ParamField>

<ParamField type="string">
  Conversión de moneda. Con `none` los valores quedan en la moneda nativa del fondo. Valores: `none`, `mep`, `ccl`, `a3500`, `oficial_minorista`.
</ParamField>

## Ejemplo de Solicitud

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://api.doctacapital.com.ar/api/v1/fci/instruments/Premier%20Abierto%20Pymes%20-%20Clase%20A/series?interval=1%20week" \
    -H "Authorization: Bearer $DOCTA_TOKEN"
  ```
</RequestExample>

## Respuesta Exitosa

<ResponseField name="fund_name" type="string">
  Nombre del fondo.
</ResponseField>

<ResponseField name="currency" type="string">
  Moneda nativa del fondo.
</ResponseField>

<ResponseField name="fx" type="string">
  Conversión de moneda solicitada.
</ResponseField>

<ResponseField name="output_currency" type="string">
  Moneda de salida de los valores.
</ResponseField>

<ResponseField name="requested_range" type="object">
  Rango solicitado, con `from` y `to`.
</ResponseField>

<ResponseField name="effective_range" type="object">
  Rango efectivo con datos disponibles, con `from` y `to`.
</ResponseField>

<ResponseField name="fund_inactive_in_range" type="boolean">
  Indica si el fondo estuvo inactivo en el rango solicitado.
</ResponseField>

<ResponseField name="series" type="array">
  Puntos diarios de la serie.
</ResponseField>

<ResponseField name="series[].date" type="string">
  Fecha del punto (YYYY-MM-DD).
</ResponseField>

<ResponseField name="series[].vcp" type="number">
  Valor de cuotaparte.
</ResponseField>

<ResponseField name="series[].aum" type="number">
  Patrimonio administrado.
</ResponseField>

<ResponseField name="series[].flow" type="number | null">
  Flujo neto del día (suscripciones menos rescates). Es null cuando no se puede calcular.
</ResponseField>

<ResponseField name="series[].daily_return" type="number | null">
  Retorno diario en decimal. Es null en el primer punto de la serie.
</ResponseField>

<ResponseField name="series[].cumulative_return" type="number">
  Retorno acumulado desde el inicio del rango, en decimal.
</ResponseField>

<ResponseField name="series[].interpolated" type="boolean">
  Indica si el punto fue interpolado. `interpolation_method` detalla el método usado (null si no hubo interpolación).
</ResponseField>

<ResponseField name="series[].data_missing" type="boolean">
  Indica si faltan datos originales en la fecha.
</ResponseField>

<ResponseField name="series[].aum_estimated" type="boolean">
  Indica si el AUM del punto es estimado.
</ResponseField>

<ResponseField name="series[].outlier_suspected" type="boolean">
  Indica si el retorno diario del punto se sospecha atípico.
</ResponseField>

<ResponseField name="series[].flow_undefined" type="boolean">
  Indica si el flujo del punto no está definido.
</ResponseField>

<ResponseField name="data_quality" type="object">
  Calidad de los datos del rango: `real_data_pct`, `last_real_data_date`, `gap_count`, `long_gaps_detected`, `interpolated_days`, `missing_days`, `aum_estimated_days`, `fx_carried_forward_days` y `total_days`.
</ResponseField>

## Ejemplo de Respuesta Exitosa

<ResponseExample>
  ```json Success theme={null}
  {
    "fund_name": "Premier Abierto Pymes - Clase A",
    "currency": "ARS",
    "fx": "none",
    "output_currency": "ARS",
    "requested_range": {
      "from": "2026-07-23",
      "to": "2026-07-30"
    },
    "effective_range": {
      "from": "2026-07-23",
      "to": "2026-07-30"
    },
    "fund_inactive_in_range": false,
    "series": [
      {
        "date": "2026-07-23",
        "vcp": 128517.476,
        "aum": 17808478350.92,
        "flow": null,
        "daily_return": null,
        "cumulative_return": 0.0,
        "interpolated": false,
        "interpolation_method": null,
        "data_missing": false,
        "aum_estimated": false,
        "outlier_suspected": false,
        "flow_undefined": true
      },
      {
        "date": "2026-07-24",
        "vcp": 128724.617,
        "aum": 17837181587.2,
        "flow": 11.404281616210938,
        "daily_return": 0.001611773016768625,
        "cumulative_return": 0.001611773016768625,
        "interpolated": false,
        "interpolation_method": null,
        "data_missing": false,
        "aum_estimated": false,
        "outlier_suspected": false,
        "flow_undefined": false
      },
      {
        "date": "2026-07-27",
        "vcp": 129597.201,
        "aum": 17956094292.57,
        "flow": -1999981.1139335632,
        "daily_return": 0.006778687871333844,
        "cumulative_return": 0.008401386594302673,
        "interpolated": false,
        "interpolation_method": null,
        "data_missing": false,
        "aum_estimated": false,
        "outlier_suspected": false,
        "flow_undefined": false
      }
    ],
    "data_quality": {
      "real_data_pct": 1.0,
      "last_real_data_date": "2026-07-30",
      "gap_count": 0,
      "long_gaps_detected": [],
      "interpolated_days": 0,
      "missing_days": 0,
      "aum_estimated_days": 0,
      "fx_carried_forward_days": 0,
      "total_days": 6
    }
  }
  ```
</ResponseExample>


# API de Docta
Source: https://docs.doctacapital.com.ar/api-reference/introduction

Documentación de la API de Docta: bonos (catálogo, cashflows, curvas de rendimiento) y FCI (screener, series, performance y analytics de industria).

## Bienvenido a la API de Docta

La API de Docta brinda datos especializados del mercado argentino. Bonos: catálogo de instrumentos, detalle enriquecido, flujos de fondos, yields intradiarios y curvas históricas. FCI: screener del universo de fondos, detalle con composición y fees, series diarias, performance, comparaciones y analytics de la industria (AUM, gestoras, flujos). La autenticación sigue el flujo de credenciales de cliente OAuth 2.0.

<Card title="URL Base" icon="globe">
  [https://api.doctacapital.com.ar](https://api.doctacapital.com.ar)
</Card>

## Generar credenciales

1. **Generar Credenciales**: Generá tus credenciales en [Docta Terminal](https://app.doctacapital.com.ar) (`client_id` y `client_secret`).
2. **Obtener Token de Acceso**: Usá tu `client_id` y `client_secret` para obtener un token de acceso. [Ver endpoint](/api-reference/endpoint/auth-token).

## Autenticación

La API utiliza el flujo de credenciales de cliente OAuth 2.0. Necesitas obtener un token de acceso antes de consultar instrumentos, cashflows, curvas o datos de FCI.

<Note>
  El acceso por dominio se controla con scopes: `bonds:read` para los endpoints de bonos y `fci:read` para los de FCI. Si tu cliente no tiene el scope necesario, la API responde 403.
</Note>

<Steps>
  <Step title="Solicitar Token de Acceso">
    Envía una solicitud POST a `/api/v1/auth/token` con tus credenciales de cliente.
  </Step>

  <Step title="Usar el Token">
    Incluye el token de acceso en el header Authorization: `Bearer {access_token}`.
  </Step>

  <Step title="Expiración del Token">
    Los tokens expiran. Solicita uno nuevo al vencer para mantener el acceso a los datos.
  </Step>
</Steps>

## Soporte

Para soporte técnico o preguntas sobre la API, por favor contacta a nuestro equipo de soporte.


# Servidor MCP
Source: https://docs.doctacapital.com.ar/servidor-mcp

Conectá Claude, ChatGPT o tu editor a los datos de mercado de Docta

Docta expone un servidor remoto [MCP (Model Context Protocol)](https://modelcontextprotocol.io) para que asistentes de IA consulten datos del mercado argentino — bonos (rendimientos, duration, flujos de fondos, paridad) y FCI (screener, series, performance, gestoras y flujos de industria) — directamente desde la conversación.

<Card title="URL del servidor" icon="plug">
  `https://mcp.docta.com.ar/mcp`
</Card>

## Conectar con tu cuenta Docta (OAuth)

La forma recomendada: iniciás sesión con tu cuenta de Docta y autorizás el acceso. No hay claves para copiar.

<Steps>
  <Step title="Agregá el conector">
    * **Claude (claude.ai / Desktop):** Configuración → Conectores → *Agregar conector personalizado* → pegá `https://mcp.docta.com.ar/mcp`.
    * **ChatGPT:** Settings → Connectors (modo desarrollador) → *Add connector* con la misma URL.
    * **Claude Code:** `claude mcp add --transport http docta https://mcp.docta.com.ar/mcp`
    * **Cursor:** agregá el servidor con transporte HTTP en la configuración de MCP.
  </Step>

  <Step title="Autorizá el acceso">
    Se abre `app.docta.com.ar`: iniciá sesión (o creá tu cuenta) y aceptá los permisos. Si nunca generaste credenciales de API, se crean automáticamente en el plan gratuito.
  </Step>

  <Step title="Listo">
    Preguntale a tu asistente, por ejemplo: *"¿Cómo está la curva CER hoy?"* o *"Analizá el AL30"*.
  </Step>
</Steps>

## Herramientas disponibles

El servidor expone 26 herramientas, una por cada endpoint documentado de la API.

### Bonos

| Herramienta               | Endpoint                             | Qué hace                                                         |
| ------------------------- | ------------------------------------ | ---------------------------------------------------------------- |
| `search_instruments`      | `/bonds/instruments/search`          | Buscar bonos por texto libre y resolver el ticker exacto         |
| `list_instruments`        | `/bonds/instruments`                 | Listar el catálogo, opcionalmente filtrado por `sub_asset_class` |
| `get_instrument`          | `/bonds/instruments/{symbol}`        | Ficha del bono: nombre, sector, emisor, ley, ISIN                |
| `get_intraday_yields`     | `/bonds/yields/{symbol}/intraday`    | TIR, TNA, TNA 30/360, TEM, duration, DTM y margen                |
| `get_history`             | `/bonds/yields/{symbol}/historical`  | Serie diaria de TIR/TNA/TEA/TEM en un rango de fechas            |
| `get_bond_cashflow`       | `/bonds/analytics/{symbol}/cashflow` | Cronograma de pagos, con montos ajustados por CER/UVA            |
| `get_bond_residual_value` | `.../cashflows/residual-value`       | Serie diaria de valor residual por plazo de liquidación          |
| `price_bond`              | `/analytics/bonds/pricer`            | Calculadora: de precio a TIR y viceversa                         |
| `compare_bonds`           | `/bonds/compare`                     | Comparación de 2–20 bonos en una tabla, en una sola request      |
| `get_my_usage`            | —                                    | Tu plan y cuota restante (no consume requests)                   |

### FCI

| Herramienta                    | Endpoint                           | Qué hace                                                                  |
| ------------------------------ | ---------------------------------- | ------------------------------------------------------------------------- |
| `search_fci_funds`             | `/fci/instruments/search`          | Resolver un fondo por nombre, gestora o categoría                         |
| `list_fci_funds`               | `/fci/instruments`                 | Screener del universo FCI: filtros por gestora, categoría, AUM y retornos |
| `get_fci_fund`                 | `/fci/instruments/{fund_name}`     | Ficha del fondo: fees, composición, retornos preestablecidos              |
| `get_fci_series`               | `.../{fund_name}/series`           | Serie diaria de VCP, AUM, flujo y retornos                                |
| `get_fci_performance`          | `.../{fund_name}/performance`      | Performance de un rango: retorno acumulado, TNA, mejor/peor día           |
| `get_fci_catalog`              | `/fci/catalog`                     | Valores válidos de cada filtro del screener                               |
| `list_fci_benchmarks`          | `/fci/benchmarks`                  | Benchmarks disponibles (CER, BADLAR, MEP, …)                              |
| `get_fci_benchmark_series`     | `/fci/benchmarks/{name}/series`    | Serie de retorno acumulado de un benchmark                                |
| `compare_fci_funds`            | `/fci/compare/table`               | Comparación de hasta 30 fondos en una tabla                               |
| `compare_fci_series`           | `/fci/compare/series`              | Series de retorno acumulado de hasta 10 fondos + benchmarks               |
| `get_fci_market_series`        | `/fci/market/series`               | Serie temporal de la industria (AUM, cantidad de fondos o flujo neto)     |
| `get_fci_market_kpis`          | `/fci/market/kpis`                 | KPIs de industria: fondos vigentes, AUM total, gestoras activas           |
| `get_fci_aum_distribution`     | `/fci/market/aum-distribution`     | AUM de la industria por categoría                                         |
| `get_fci_top_managers`         | `/fci/market/top-managers`         | Ranking de gestoras por AUM                                               |
| `get_fci_top_managers_by_flow` | `/fci/market/top-managers-by-flow` | Ranking de gestoras por flujo neto                                        |
| `get_fci_flows_by_category`    | `/fci/market/flows-by-category`    | Flujos netos de una categoría en un rango                                 |

<Note>
  El alcance es **renta fija argentina y FCI**. La API no cubre acciones, CEDEARs ni futuros, y
  en bonos no expone precios, OHLC ni volumen operado: donde dice "intradiario" se trata de
  **rendimientos** intradiarios, no de cotizaciones. Los datos de FCI son de frecuencia diaria
  (VCP/AUM al cierre) y los retornos son decimales (0.05 = 5%).
</Note>

## Cuotas y caché

* Cada llamada a una herramienta consume requests de tu [plan de API](https://app.docta.com.ar/pricing#api), con una excepción importante: las respuestas se cachean del lado del servidor (catálogos \~1 h, datos intradiarios \~5 min) y **los hits de caché no consumen tu cuota**.
* Cada respuesta incluye `_quota` (requests restantes) y `_cached`. La herramienta `get_my_usage` muestra tu estado sin gastar requests.
* Los datos intradiarios tienen \~20 minutos de demora y las tasas son decimales (0.1046 = 10,46%).

## Alternativa: autenticación por headers

Para clientes CLI o entornos donde OAuth no aplica, podés enviar tus [credenciales de API](https://app.docta.com.ar/dashboard/account/api) como headers en cada request:

```json theme={null}
{
  "mcpServers": {
    "docta": {
      "url": "https://mcp.docta.com.ar/mcp",
      "headers": {
        "X-Docta-Client-Id": "docta-api-...",
        "X-Docta-Client-Secret": "tu-client-secret"
      }
    }
  }
}
```

<Note>
  Rotar tu client secret no afecta las conexiones OAuth: solo invalida los headers.
  Las conexiones OAuth se revocan desde tu cuenta.
</Note>