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

# Metodología del Cotizave Index

> Fórmula v1, mediana P2P, descarte de valores atípicos y renormalización.

Esta metodología corresponde al [endpoint del índice](/api/endpoints/index). Combina referencias distintas; no representa operaciones efectivamente realizadas.

<span id="formula" />

## Fórmula v1

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

<span id="componentes" />

## Componentes

* **BCV, 30 %:** `reference`, tasa oficial USD/VES.
* **Paralelo, 20 %:** `parallel`, referencia de mercado libre recibida y normalizada por Cotizave.
* **P2P, 50 %:** mediana de las cotizaciones positivas disponibles de `binance`, `bybit`, `okx`, `bitget`, `mexc`, `bingx` y `saldo`, después del filtro de valores atípicos. Son referencias USDT/VES normalizadas, no un libro de órdenes ni operaciones ejecutadas.

<span id="outliers" />

## Valores atípicos

Primero se calcula la mediana global de las cotizaciones P2P positivas. Se excluye cada cotización cuya desviación absoluta respecto a esa mediana sea **mayor que 50 %**. Se recalcula la mediana con las restantes. Con un número par de valores, la mediana es la media de los dos centrales; con menos de dos no se detectan valores atípicos.

<span id="flags" />

## Flags y pesos efectivos

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

Después de excluir componentes, cada peso restante se divide por la suma de los pesos disponibles. Si solo quedan paralelo y P2P, sus pesos son `0.2/0.7` y `0.5/0.7`. El resultado se redondea a cuatro decimales. Si no queda ninguno, la API devuelve `503`.

El filtrado de P2P se basa en disponibilidad, valor positivo y desviación; los flags no acreditan que todas las cotizaciones P2P sean recientes.

<span id="interpretacion" />

## Ejemplo de cálculo

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"
}
```

`475.0083 × 0.3 + 538.87 × 0.2 + 544.2 × 0.5 = 522.37649`, que se devuelve como `522.3765`. `as_of` identifica la captura; no existe aquí una garantía de antigüedad máxima.

<span id="cuando-usarlo" />

## Uso e interpretación

Úsalo como referencia en gráficas y estimaciones, mostrando versión, fecha y flags. No sustituye una tasa oficial ni garantiza el precio de una operación. Para datos BCV consulta directamente `reference` o `eur_reference`.

<span id="versionado" />

## Versión

La respuesta actual identifica esta metodología como `v1`. Guarda `version` junto con los resultados y revisa la documentación antes de adoptar otra versión. No se promete un plazo fijo de convivencia entre versiones.


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