Changelog

Notas de
actualización.

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

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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.
  6. 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