Cotizave Index

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

Consulta

No requiere parámetros. Admite el formato de respuesta. Los ejemplos se ejecutan en el servidor. JavaScript y Python usan los clientes del inicio rápido; configura allí COTIZAVE_API_KEY.

curl --fail-with-body --max-time 10 "https://api.cotizave.com/v1/fx/index" \
  -H "X-API-Key: $COTIZAVE_API_KEY"

import { cotizave } from './cotizave.mjs';

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

from cotizave import cotizave

data = cotizave('/v1/fx/index')
print(data)

Respuesta

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

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

Cálculo

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.

Mostrar el índice

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. Conserva valor, versión, componentes y fecha si registras estimaciones.

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.

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 de autenticación, cuota o disponibilidad. Las respuestas de error de la API son JSON; decide por code, no por el texto de message.

Documentación

Empezar

API

Venezuela: endpoints

Índices

Guías

Consulta

Respuesta

Cálculo

Mostrar el índice

Referencia informativa

Errores

​Consulta

​Respuesta

​Cálculo

​Mostrar el índice

​Referencia informativa

​Errores

Consulta

Respuesta

Cálculo

Mostrar el índice

Referencia informativa

Errores