GET /v1/fx/rates

Devuelve un snapshot con todas las tasas disponibles de bolívar venezolano frente a la moneda base.

Es el endpoint principal y el más usado. Una sola llamada te da todo lo que necesitas.

Request

GET /v1/fx/rates HTTP/1.1
Host: api.cotizave.com
X-API-Key: nd-tu-api-key-aqui
Accept: application/json

Parámetros de query

Ejemplos de request

Tasas contra USD (default):

curl https://api.cotizave.com/v1/fx/rates \
  -H "X-API-Key: nd-tu-api-key-aqui"

Tasas contra EUR:

curl "https://api.cotizave.com/v1/fx/rates?base=EUR" \
  -H "X-API-Key: nd-tu-api-key-aqui"

Solo BCV y paralela:

curl "https://api.cotizave.com/v1/fx/rates?markets=reference,parallel" \
  -H "X-API-Key: nd-tu-api-key-aqui"

Solo exchanges P2P principales:

curl "https://api.cotizave.com/v1/fx/rates?markets=binance,bybit,okx" \
  -H "X-API-Key: nd-tu-api-key-aqui"

Response

200 OK

{
  "country": "VE",
  "currency": "VES",
  "base": "USD",
  "rates": [
    {
      "market": "reference",
      "type": "reference",
      "mid": 475.0083,
      "updated_at": "2026-04-08T14:00:00Z"
    },
    {
      "market": "parallel",
      "type": "parallel",
      "ask": 640.12,
      "bid": 637.63,
      "mid": 638.87,
      "updated_at": "2026-04-08T17:25:00Z"
    },
    {
      "market": "binance",
      "type": "p2p",
      "ask": 639.24,
      "bid": 636.50,
      "mid": 637.87,
      "updated_at": "2026-04-08T17:29:00Z"
    },
    {
      "market": "bybit",
      "type": "p2p",
      "ask": 639.88,
      "bid": 637.12,
      "mid": 638.50,
      "updated_at": "2026-04-08T17:29:00Z"
    },
    {
      "market": "okx",
      "type": "p2p",
      "ask": 635.80,
      "bid": 632.70,
      "mid": 634.25,
      "updated_at": "2026-04-08T17:29:00Z"
    },
    {
      "market": "bitget",
      "type": "p2p",
      "ask": 636.10,
      "bid": 632.86,
      "mid": 634.48,
      "updated_at": "2026-04-08T17:29:00Z"
    },
    {
      "market": "mexc",
      "type": "p2p",
      "ask": 650.50,
      "bid": 647.54,
      "mid": 649.02,
      "updated_at": "2026-04-08T17:28:00Z"
    }
  ],
  "fetched_at": "2026-04-08T17:29:15Z"
}

Schema de respuesta

Markets disponibles

Tasas reference vs parallel vs p2p

reference (BCV): la tasa oficial publicada por el Banco Central. Úsala para:

• Facturación electrónica (SENIAT la reconoce)
• Declaraciones fiscales
• Reportes contables formales
• Cumplimiento normativo

parallel (paralela): el promedio de mercado del paralelo. Úsala para:

• Mostrar “la tasa real” en apps consumer
• Remesas informales
• Conversiones rápidas en la vida diaria
• Comparación contra la oficial

p2p (exchanges): cotizaciones reales de USDT/VES en cada exchange. Úsalas para:

• Apps de trading o wallet crypto
• Comparación de precios entre exchanges
• Análisis de spreads
• Estrategias de arbitraje

Errores posibles

Notas importantes

Fuentes temporalmente caídas

En casos excepcionales, una fuente upstream puede estar temporalmente caída. En ese caso:

• El campo updated_at refleja la edad real del dato (puede ser más viejo de lo habitual)
• Si una fuente está caída por más de 10 minutos, la excluimos de la respuesta en lugar de devolver datos peligrosamente desactualizados

Recomendación: siempre revisa updated_at antes de confiar en un dato para operaciones críticas.

Orden de los rates

El orden del array rates no está garantizado. No dependas de que reference siempre esté primero. Usa el campo market para identificar cada cotización:

const bcv = data.rates.find(r => r.market === 'reference')
const paralela = data.rates.find(r => r.market === 'parallel')

Precisión numérica

Los valores son números JSON estándar (double-precision floating point). Para operaciones financieras críticas, considera:

• Redondear a 2-4 decimales antes de mostrar al usuario
• Usar bibliotecas de aritmética decimal (decimal.js, BigDecimal en Java, Decimal en Python) si haces cálculos complejos
• No comparar montos exactos con === (usar tolerancia)