Referencia para desarrolladores

API pública

Consulta las rutas que la aplicación expone hoy para tasas, series, conversiones, estadísticas y contenido.

BASE https://api.preciodolarparalelo.com

Esta guía describe contratos observados en el servidor Hono. Hay handlers heredados en otra aplicación API; sus respuestas pueden diferir. No se publica aquí un compromiso de disponibilidad, compatibilidad ni versionado del contrato.

Lectura

Rutas de datos GET observadas

Los enlaces abren las respuestas JSON directamente en el dominio de la API.

01 GET /v1/exchange-rates

Tasas por fuente

Respuesta detallada de fuentes activas con observaciones almacenadas, su categoría y metadatos visibles.

Respuesta documentada: exchangeRates, averageRate, change24h, changePercentage24h, methodologyVersion, indexSourceCount, indexCategories, calculatedAt y lastUpdate.
Parámetros: No consume parámetros de consulta en la implementación actual.

02 GET /v1/rates

Resumen de tasas

Resumen compacto del USD paralelo, EUR y referencias oficiales BCV cuando están disponibles.

Respuesta documentada: BCVUSD, BCVEUR, USD, EUR, last_update, metodología e información del índice.
Parámetros: No consume parámetros de consulta en la implementación actual.

03 GET /v1/history

Serie histórica

Serie de promedios agrupados y rango mínimo-máximo de las tasas guardadas en cada intervalo; no representa operaciones ni velas OHLC.

Respuesta documentada: 24h y 7d: semantics bucket-average-range; points contiene time, sampleCount, average, minimum y maximum. 1m, 3m, 6m, 1y, 5y y max: semantics segmented-history, timezone America/Caracas, points conserva el agregado heredado y segments separa legacy de canonical. El segmento canonical usa snapshots diarios finalizados daily-category-mean-v1 y puede estar vacío hasta que exista procedencia y calidad normalizadas.
Parámetros: timeframe: 24h, 7d, 1m, 3m, 6m, 1y, 5y o max. También acepta 30d y 90d como alias.

04 GET /v1/currencies

Tipos de cambio auxiliares

Tipos de cambio usados por el servicio de monedas para conversiones entre divisas.

Respuesta documentada: currencies, timestamp, total y cacheStatus.
Parámetros: force=true solicita una actualización en vez de usar la respuesta en caché.

05 GET /v1/stats

Estadísticas

Diferencial frente al BCV y variación histórica calculada para varios períodos.

Respuesta documentada: currentRate, bcvRate, diferencial y devaluation.
Parámetros: No consume parámetros de consulta en la implementación actual.

06 GET /v1/commodities

Commodities

Respuesta de precios de commodities construida por el servicio de la API.

Respuesta documentada: commodities y timestamp.
Parámetros: No consume parámetros de consulta en la implementación actual.

07 GET /v1/news

Titulares enlazados

Titulares sobre dólar, economía y criptomonedas recopilados del sitemap de Panorama.

Respuesta documentada: items (title, url, publishedAt, source) y timestamp.
Parámetros: No consume parámetros de consulta en la implementación actual.

08 GET /v1/notas

Notas editoriales

Listado paginado de notas suministradas mediante la integración editorial WordPress.

Respuesta documentada: Objeto paginado devuelto por la integración; si falla, notes, total, totalPages y error.
Parámetros: page, perPage, search y category. perPage se limita en el servidor.

09 GET /v1/status

Estado público

Para solicitudes públicas devuelve una comprobación mínima de vida del servicio.

Respuesta documentada: status, service y timestamp. Los detalles operativos requieren autorización.
Parámetros: No consume parámetros de consulta en la implementación actual.

Eventos del servidor

Flujo de tasas en vivo

GET /v1/sse/rates mantiene una conexión Server-Sent Events. El servidor envía primero un evento connected y, cuando tiene datos disponibles, un evento ratesUpdate con tasas e información del índice. Cada actualización incluye methodologyVersion y marcas de cálculo; el flujo no define aquí un SLA ni una frecuencia garantizada.

El tipo de respuesta es text/event-stream. Requiere un cliente compatible con SSE, como EventSource.

Alcance del contrato

Lee cada respuesta con su contexto

El promedio principal usa la versión de metodología reportada en la respuesta. Consulta cómo se calcula antes de comparar series o indicadores.
Las tasas pueden tener monedas de cotización distintas. En /v1/exchange-rates, revisa currency, nativeRateUnit e inIndex cuando estén presentes.
Los errores HTTP y la disponibilidad de campos dependen de la operación solicitada y de los datos disponibles. Esta página no garantiza que cada ruta responda siempre con datos.
En el histórico, el segmento legacy promedia filas almacenadas por intervalo; cada punto no expone unidad ni fuente individual. El segmento canonical publica snapshots diarios por categoría cuando están finalizados y disponibles.
El catálogo /data-catalog.json documenta cobertura, calidad, límites y permisos conocidos. No hay exportación de archivo CSV/JSON ni licencia general de redistribución publicada.

Compatibilidad

Migrar consumidores del histórico

Los clientes de 24h/7d pueden seguir leyendo points con la forma de agregado heredada.
Para 1m y períodos mayores, lea semantics antes de interpretar la respuesta. points sigue como alias de compatibilidad para el agregado heredado.
Use segments.legacy.points para identificar explícitamente la serie antigua y segments.canonical.points para snapshots diarios finalizados; compruebe versión de metodología, categoría, fecha local y revisión.
Trate un segmento canonical vacío como ausencia de snapshots publicados, no como una tasa de cero. Los puntos legacy y canonical tienen semánticas y ponderaciones distintas.