← 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 5 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 5 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