> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cotizave.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cotizave Index

> Referencia ponderada BCV, paralelo y P2P, con componentes y flags de calidad.

`GET /v1/fx/index` · Todos los planes · Una consulta de cuota. Devuelve una referencia informativa en VES por USD.

<span id="request" />

## Consulta

No requiere parámetros. Admite el [formato de respuesta](/api/formats).

Los ejemplos se ejecutan en el servidor. JavaScript y Python usan los clientes del [inicio rápido](/api/quickstart#paso-2); configura allí `COTIZAVE_API_KEY`.

<CodeGroup>
  ```bash curl theme={null}
  curl --fail-with-body --max-time 10 "https://api.cotizave.com/v1/fx/index" \
    -H "X-API-Key: $COTIZAVE_API_KEY"
  ```

  ```javascript Node.js theme={null}
  import { cotizave } from './cotizave.mjs';

  const data = await cotizave('/v1/fx/index');
  console.log(data);
  ```

  ```python Python theme={null}
  from cotizave import cotizave

  data = cotizave('/v1/fx/index')
  print(data)
  ```
</CodeGroup>

<span id="response" />

## Respuesta

Respuesta ilustrativa: las cifras y fechas no son cotizaciones actuales.

```json theme={null}
{
  "value": 522.3765,
  "version": "v1",
  "as_of": "2026-10-19T17:29:15Z",
  "weights": {
    "bcv": 0.3,
    "paralelo": 0.2,
    "p2p": 0.5
  },
  "components": {
    "bcv": 475.0083,
    "paralelo": 538.87,
    "p2p": 544.2
  },
  "p2p_median": 544.2,
  "p2p_count": 7,
  "flags": {},
  "methodology_url": "https://cotizave.com/docs/cotizave-index"
}
```

`value` se redondea a cuatro decimales. `version` identifica la metodología; no le antepongas otra `v`. `as_of` corresponde al snapshot, no al instante de la consulta. `weights` contiene los pesos efectivos, `components` los valores incluidos, y `p2p_count` el número de mercados que quedaron tras el filtrado. `flags` es `{}` cuando no se activa ninguna alerta. `methodology_url` enlaza la metodología.

| Flag | Significado |
| - | - |
| `bcv_stale` | BCV supera 132 horas de antigüedad; su peso pasa a cero. Es una regla de cálculo, no una validación del calendario legal. |
| `degraded` | Quedan entre 1 y 3 cotizaciones P2P. Con cero, se usa `missing_sources`. |
| `missing_sources` | Componentes ausentes: `bcv`, `paralelo` o `p2p`. Su peso pasa a cero. |
| `outliers_excluded` | Mercados P2P descartados por desviarse más del 50 % de la mediana inicial. |

<span id="metodologia" />

## Cálculo

```text theme={null}
Index = BCV × 0.30 + Parallel × 0.20 + P2PMedian × 0.50
```

Los componentes ausentes y BCV marcado como antiguo reciben peso cero; los pesos restantes se renormalizan para sumar uno. Revisa la [metodología completa](/cotizave-index).

<span id="casos-uso" />

## Mostrar el índice

```javascript theme={null}
import { cotizave } from './cotizave.mjs';
const index = await cotizave('/v1/fx/index');
console.log(`${index.value.toFixed(4)} VES/USD (${index.version})`);
console.log({ as_of: index.as_of, flags: index.flags, weights: index.weights });
```

Usa el cliente del [inicio rápido](/api/quickstart#paso-2). Conserva valor, versión, componentes y fecha si registras estimaciones.

<span id="disclaimer" />

## Referencia informativa

El índice no es una tasa oficial ni una cotización ejecutable. No sustituye la tasa exigida para una factura, contrato o liquidación.

<span id="errores" />

## Errores

`503 service_unavailable` cuando no queda ningún componente utilizable. En `/rates`, el fallo de cálculo puede omitir `index` sin invalidar las otras tasas.

Además pueden producirse los [errores comunes](/api/errors) de autenticación, cuota o disponibilidad. Las respuestas de error de la API son JSON; decide por `code`, no por el texto de `message`.


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