← Volver a docs
📖 Empezar / Introducción

Introducción a la API de Cotizave

Bienvenido a la documentación de Cotizave, la API de tasas de cambio venezolanas para developers.

Qué es Cotizave

Cotizave es una API REST que provee tasas de cambio del bolívar venezolano (VES) frente a otras monedas, en tiempo real, a través de un único endpoint unificado.

En lugar de tener que:

  • Parsear el HTML del sitio del BCV
  • Integrar cada exchange de crypto por separado (Binance, Bybit, OKX, etc.)
  • Mantener tus propios scrapers que se rompen cuando cambia un sitio
  • Lidiar con formatos distintos, monedas distintas, frecuencias de actualización distintas

Con Cotizave haces un solo GET y recibes todas las tasas en un JSON limpio, con un contrato estable.

Qué tasas expone

Tasa de referencia: BCV oficial

La tasa publicada por BCV. La tasa oficial y confiable para documentos formales, presupuestos y reportes. Se actualiza cada vez que el BCV publica (típicamente una vez por día hábil).

Tasa paralela

El promedio ponderado del mercado paralelo, calculado a partir de fuentes públicas de referencia. Es la tasa que la mayoría de la gente usa en la práctica diaria. Se actualiza aproximadamente cada 25 minutos.

Tasas P2P de exchanges de crypto

Cotizaciones reales de USDT/VES de los principales exchanges:

  • Binance P2P
  • Bybit P2P
  • OKX P2P
  • Bitget P2P
  • MEXC P2P
  • KuCoin P2P
  • BingX P2P
  • CoinEx P2P

Cada cotización incluye ask, bid y mid. Se actualizan aproximadamente cada 25 minutos.

Casos de uso

Algunos ejemplos de lo que puedes construir con Cotizave:

  • Documentos y presupuestos con la tasa BCV oficial
  • Apps de remesas y transferencias mostrando la tasa real al usuario
  • Calculadoras de conversión USD/VES en sitios web y apps mobile
  • Dashboards financieros para empresas que operan en Venezuela
  • Bots de Telegram/Discord que responden "¿cuánto está el dólar?"
  • Integraciones contables con sistemas ERP y de gestión
  • Análisis de mercado comparando cotizaciones P2P entre exchanges
  • Alertas de movimientos bruscos en las tasas

Características técnicas

  • REST: HTTP GET con respuestas JSON. Sin GraphQL, sin gRPC, sin sorpresas.
  • Autenticación por API Key: header X-API-Key con tu clave.
  • Rate limiting por Plan: cuotas mensuales claras, sin letra chica.
  • Baja latencia desde LATAM: infraestructura en América, optimizada para la región.
  • Schema estable: el contrato de respuesta no cambia sin previo aviso de al menos 90 días.
  • Versionado: todas las URLs empiezan con /v1/. Cambios breaking → /v2/ con transición.

Infraestructura

Cotizave corre en infraestructura en América, con CDN global, protección DDoS y monitoreo 24/7. Está optimizada para baja latencia desde Latinoamérica.

Primeros pasos

Para empezar a usar la API en cinco minutos:

  1. Regístrate en app.cotizave.com
  2. Sigue la guía rápida
  3. Copia tu primera API Key del dashboard
  4. Haz tu primer request con curl
★

¿Listo para saltar al código?

Ve directo al Quickstart y haz tu primera llamada en menos de 5 minutos.

Ayuda y soporte

Filosofía

Cotizave está hecho con algunos principios simples:

  • Hacer una cosa y hacerla bien. Venezuela, tasas de cambio, bien resuelto.
  • Precios claros desde el primer día. Sin "contacta a ventas". Self-serve completo.
  • Desarrolladores primero. Buena documentación, buenos ejemplos, buen manejo de errores.
  • Contratos estables. No rompemos la API sin aviso.
  • Transparencia. Status page público y comunicación directa cuando algo falla.
← AnteriorÍndice de docsSiguiente →Inicio rápido