Changelog

Notas de
actualización.

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

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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 Free disponible sin tarjeta de crédito: 1 000 solicitudes/mes.
    • Planes Starter, Pro y Enterprise con volúmenes mayores y SLA garantizado.
    • 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.