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 el Banco Central de Venezuela. Es la tasa que el SENIAT reconoce para facturación electrónica y reportes fiscales. 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 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 cada minuto.

Casos de uso

Algunos ejemplos de lo que puedes construir con Cotizave:

• Facturación electrónica cumpliendo los requisitos del SENIAT con la tasa BCV
• 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.
• Bajo latencia desde LATAM: servidores en São Paulo, Brasil. Desde la mayoría de países sudamericanos la latencia es de 20 a 80 ms.
• Schema estable: el contrato de respuesta no cambia sin previo aviso de al menos 90 días.
• Versionado: todas las URLs empiezan con /v1/. Si hacemos cambios breaking, lanzamos /v2/ y mantenemos /v1/ funcionando durante el período de transición.

Arquitectura e infraestructura

Cotizave corre en infraestructura ubicada en São Paulo, Brasil, con CDN global, protección DDoS y monitoreo 24/7. Toda la base de datos y los backups también están alojados en Brasil.

Por qué Brasil: Sudamérica tiene poca presencia de infraestructura cloud comparada con EEUU o Europa. São Paulo es el único datacenter tier-1 de la región con presencia de todos los grandes proveedores. Elegir São Paulo significa latencia óptima para usuarios de Venezuela, Colombia, Argentina, Chile, Perú, Uruguay, Paraguay y el propio Brasil.

Desde EEUU, Europa o Asia, la latencia es mayor (150-300 ms), pero la API sigue siendo completamente funcional.

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

Ayuda y soporte

• Documentación completa: estás leyéndola ahora
• Referencia de endpoints: /docs
• Guías prácticas: /docs
• Estado del servicio: /status
• Soporte por email: hello@cotizave.com
• Changelog de la API: /docs

Filosofía

Cotizave está hecho con algunos principios simples:

• Hacer una cosa y hacerla bien. No somos una API de 50 países con 400 endpoints. Somos Venezuela, tasas de cambio, bien resuelto.
• Precios claros desde el primer día. Sin “contacta a ventas”. Sin demos obligatorios. Self-serve completo.
• Desarrolladores primero. Buena documentación, buenos ejemplos, buen manejo de errores, buen logging.
• Contratos estables. No rompemos la API sin aviso. Nadie quiere despertarse un lunes con una integración rota.
• Transparencia. Status page público, post-mortems honestos, changelog completo.

Si esto te hace sentido, bienvenido. Si no, no pasa nada, hay otras opciones.