Changelog

Notas de
actualización.

Cambios, mejoras y correcciones de la API de Cotizave, en orden cronológico inverso.

  1. APIv1.7.0

    Profesional sube a 6 meses de histórico

    El plan Profesional pasa de 3 a 6 meses de retención en el endpoint de histórico. Gratis, Esencial y Escala no cambian.

    • Retención de histórico en Profesional: 90 → 180 días.
    • Gratis se mantiene en 14 días, Esencial en 90 y Escala en 1 año.
    • Sin cambios de contrato: mismos parámetros y formato de respuesta de GET /v1/fx/rates/:market/history.
  2. Fixv1.6.0

    Respuestas 429 con información accionable

    Un 429 ahora te dice contra qué límite chocaste y cuánto esperar con precisión. Antes X-RateLimit-Remaining reportaba 0 en cualquier rechazo, incluso cuando te quedaba casi toda la cuota del mes.

    • X-RateLimit-Remaining refleja tu cuota real. Si el rechazo fue por velocidad, tu saldo mensual aparece intacto — antes decía 0 y podía leerse como "agotaste el plan".
    • X-RateLimit-Scope distingue burst (pediste demasiado rápido) de monthly (agotaste la cuota). Se resuelven distinto: el primero espaciando pedidos, el segundo con más volumen.
    • X-RateLimit-Limit-Second y X-RateLimit-Burst publican tus límites de velocidad; antes había que descubrirlos chocando.
    • X-RateLimit-Retry-After-Ms trae la espera exacta en milisegundos. Retry-After solo admite segundos enteros, así que en planes altos redondear a 1 segundo puede ser 30 veces más de lo necesario.
    • El cuerpo del error incluye details con kind, retry_after y retry_after_ms.
    • Todos los headers están expuestos vía CORS, así que se leen desde el navegador.
  3. APIv1.5.0

    Histórico por rango y serie completa

    El endpoint de histórico ahora devuelve series completas, no solo un punto. Sin parámetros trae toda tu retención; con ?from=&to= un rango. El modo ?date= sigue devolviendo un único valor, igual que antes.

    • GET /v1/fx/rates/:market/history sin parámetros devuelve la serie completa dentro de la retención de tu plan.
    • Parámetros ?from=&to= (YYYY-MM-DD) acotan un rango de fechas; un solo día = from igual a to.
    • granularity=daily (default) da un punto de cierre por día; granularity=raw da cada captura, hasta 5.000 puntos.
    • La respuesta de colección incluye from, to, granularity, count y points[]. El modo ?date= no cambia su contrato.
    • Retención de histórico: Indie 90 días, Pro 1 año.
    • Disponible en planes Indie y superiores.
  4. Newv1.4.0

    BingX y CoinEx — dos exchanges P2P nuevos

    Ampliamos la cobertura P2P con BingX y CoinEx. Ahora la API agrega ocho exchanges simultáneamente: Binance, Bybit, OKX, Bitget, MEXC, BingX, CoinEx y Saldo.

    • BingX P2P añadido al agregador de tasas paralelas.
    • CoinEx P2P añadido; agrega pares USDT/VES y BTC/VES.
    • El campo `source` en cada resultado ahora incluye los nuevos identificadores `bingx` y `coinex`.
    • La latencia promedio del endpoint GET /rates se mantiene bajo 120 ms a pesar de la carga adicional.
  5. APIv1.3.0

    Nuevo endpoint: GET /convert

    Se publica el endpoint de conversión directa. Convierte cualquier monto entre VES, USD, EUR o cualquier moneda soportada, usando la tasa del mercado que elijas.

    • GET /convert?from=USD&to=VES&amount=100&market=binance devuelve el monto convertido y la tasa usada.
    • Parámetro opcional `market` acepta cualquier fuente P2P o `bcv` / `paralela`.
    • Respuesta incluye `rate`, `converted_amount`, `market` y `fetched_at`.
    • Si `market` se omite, la API usa la media ponderada de los P2P activos.
    • Disponible en todos los planes, incluyendo Free.
  6. APIv1.2.0

    Spread y profundidad de libro en GET /spread

    El nuevo endpoint GET /spread expone el spread bid/ask y la profundidad de primer nivel de cada exchange P2P en tiempo real.

    • GET /spread devuelve `bid`, `ask`, `spread_pct` y `depth_bid`/`depth_ask` para cada mercado.
    • GET /rate/:market ahora incluye el campo `spread_pct` en la respuesta.
    • Los campos de spread están disponibles en planes Starter y superiores.
    • Se agrega documentación interactiva del endpoint en /docs/api/endpoints/spread.
  7. Fixv1.1.0

    Headers de rate-limit y mejoras de errores

    Correcciones y mejoras de calidad de vida: headers de límite de tasa más precisos y códigos de error estandarizados según RFC 9457.

    • X-RateLimit-Remaining ahora se actualiza correctamente en cada respuesta, no solo al agotar el límite.
    • X-RateLimit-Reset devuelve un timestamp Unix en lugar de segundos relativos.
    • Los errores 4xx siguen el formato Problem Details (RFC 9457): `type`, `title`, `status`, `detail`.
    • Error 429 incluye el campo `retry_after` con los segundos hasta el reset.
    • Se corrige un bug donde llamadas concurrentes podían consumir doble cuota en condiciones de alta carga.
  8. Newv1.0.0

    Lanzamiento público de Cotizave API

    Primera versión estable de la API. Seis fuentes P2P, tasa BCV oficial y paralela, todo en un solo contrato.

    • GET /rates — snapshot de todos los mercados activos.
    • GET /rate/:market — tasa de un exchange específico (binance, bybit, okx, bitget, mexc, saldo, bcv, paralela).
    • Autenticación por API key en header X-API-Key.
    • Plan Gratis disponible con su propio rate limit.
    • Plan Pro con mayor volumen, histórico completo y SLA.
    • Documentación completa en /docs con ejemplos en cURL, Python y Node.js.

¿Tienes preguntas sobre un cambio?

Revisa la documentación o escríbenos. Respondemos en menos de 24 horas.

Ver documentación →Contactar soporte