Freev1

Cotizave Index

El Cotizave Index es un único número que resume el tipo de cambio venezolano. Combina tres fuentes de mercado —la tasa oficial del BCV, el mercado paralelo y los exchanges P2P— en una sola cifra ponderada que refleja el precio real que paga la gente.

Disponible como endpoint GET /v1/fx/index en todos los planes, incluyendo Free.

Fórmula v1

Cotizave Index = BCV × 0.30 + Paralelo × 0.20 + MedianaP2P × 0.50

Componente	Peso v1	Fuente	Actualización
bcv	30 %	Banco Central de Venezuela	~1 vez al día (días hábiles)
paralelo	20 %	Monitor Dólar	~cada 25 minutos
p2p (mediana)	50 %	Binance, Bybit, OKX, Bitget, MEXC, BingX, Saldo — USDT/VES	~cada 25 minutos

Por qué estos pesos

BCV — 30 %

La tasa oficial del BCV es el único anclaje legalmente reconocido en Venezuela para contratos, facturas y obligaciones tributarias. Le asignamos el 30 % porque es indispensable para cualquier contexto formal, pero no puede dominar: se actualiza una sola vez al día (en días hábiles) y puede estar hasta 26 horas desactualizada respecto al mercado real.

Paralelo — 20 %

El mercado paralelo (Monitor Dólar) es el termómetro del precio informal que usa la mayoría de la población para sus transacciones cotidianas. Le asignamos el 20 % —no más— porque hay solapamiento con el componente P2P: ambos reflejan el mercado informal. Un peso mayor causaría doble conteo.

Mediana P2P — 50 %

Los exchanges P2P (Binance, Bybit, OKX, Bitget, MEXC, BingX y Saldo) son el mercado más transaccional y verificable: precios reales de compra y venta de USDT/VES con libro de órdenes público. Tienen el mayor peso (50 %) porque representan lo que la gente realmente paga en este momento, no estimaciones ni encuestas.

Usamos la mediana, no el promedio, para evitar que un solo exchange con un precio anómalo (stale, glitch de API, o intento de manipulación) mueva el índice. La mediana de siete exchanges altamente correlacionados es prácticamente insensible a un outlier.

Exclusión de outliers P2P

Antes de calcular la mediana, filtramos cualquier exchange que reporte un precio que se desvíe más del 50 % del promedio del resto del grupo. El exchange excluido aparece en el campo flags.outliers_excluded.

Ejemplo: si 6 exchanges cotizán ~640 Bs/USD y uno reporta 1.200 Bs/USD (error de API o dato desactualizado), ese exchange se descarta y la mediana se calcula sobre los 6 restantes.

Flags de calidad

Cuando el cálculo detecta anomalías, las reporta en el campo flags de la respuesta. En condiciones normales flags es un objeto vacío.

Flag	Tipo	Qué significa	Efecto en el cálculo
`bcv_stale`	boolean	El BCV lleva más de 26 horas sin publicar tasa nueva.	El peso del BCV (30 %) se redistribuye entre paralelo y P2P proporcionalmente.
`degraded`	boolean	Menos de 4 exchanges P2P disponibles para calcular la mediana.	El índice se sigue calculando pero con menor representatividad.
`missing_sources`	string[]	Uno o más componentes principales ausentes del snapshot.	Su peso se redistribuye entre los componentes disponibles. Los pesos efectivos siempre suman 1.0.
`outliers_excluded`	string[]	Exchanges P2P descartados por precio anómalo (>50 % de desviación).	La mediana se recalcula sin ellos.

Renormalización de pesos

Cuando un componente falta o se descarta, sus pesos no se desperdician: se redistribuyen proporcionalmente entre los restantes para que la suma siempre sea 1.0. El campo weights en la respuesta muestra los pesos efectivos usados en ese cálculo específico, que pueden diferir de los nominales (0.30 / 0.20 / 0.50).

Cómo interpretar el resultado

El campo value expresa cuántos bolívares (VES) vale un dólar (USD). Ejemplo:

{
  "value": 521.3842,   // 1 USD = 521.3842 VES según el Cotizave Index
  "version": "v1",
  "as_of": "2026-05-10T14:32:11Z",
  "weights": { "bcv": 0.30, "paralelo": 0.20, "p2p": 0.50 },
  "components": { "bcv": 475.01, "paralelo": 538.87, "p2p": 544.20 },
  "p2p_median": 544.20,
  "p2p_count": 7,
  "flags": {}
}

El campo as_of indica el timestamp del snapshot subyacente, no el momento exacto del request. Si el snapshot está en cache, as_of puede ser hasta 30 minutos anterior al instante de la llamada.

Cuándo usarlo (y cuándo no)

Úsalo para

Mostrar una sola cifra de referencia en apps consumer o dashboards fintech.
Estimaciones internas, presupuestos y análisis económico.
Artículos periodísticos que necesiten una tasa representativa sin tomar partido entre BCV, paralelo o P2P.
Valorar activos o carteras en VES con una referencia neutra.
Detectar anomalías de mercado mediante el seguimiento del spread entre components.bcv y components.p2p.

No lo uses para

Liquidar transacciones financieras o contratos — usa la tasa BCV directamente vía GET /v1/fx/rates/reference.
Declaraciones fiscales o reportes tributarios — la normativa venezolana exige la tasa oficial del BCV, no índices compuestos.
Arbitraje en tiempo real — para eso usa los markets individuales vía GET /v1/fx/rates o GET /v1/fx/route.

Tasa de referencia informativa

El Cotizave Index es una tasa de referencia informativa. No debe usarse para liquidar transacciones financieras, contratos, declaraciones fiscales, ni como tasa oficial de ningún tipo. Para efectos legales en Venezuela, la tasa vigente es la publicada por el Banco Central de Venezuela (BCV).

Versionado

La fórmula y los pesos forman parte del contrato público. Cualquier cambio que afecte el valor producido —ajuste de pesos, cambio de fuentes, nueva regla de outliers— se considera un cambio de versión mayor y se publica como v2, con un período de convivencia mínimo de 60 días junto a v1.

El campo version en la respuesta identifica qué metodología generó ese resultado. Los consumidores que dependan del índice deben almacenar version junto al valor para garantizar reproducibilidad histórica.

← AnteriorAPI — GET /v1/fx/index Siguiente →Facturación con BCV