Para desarrolladores
API pública de Dólar Paralelo Hoy
Endpoints de solo lectura para integrar cotizaciones actuales, histórico y estadísticas del dólar paralelo y oficial en Bolivia. Respuestas en JSON, sin autenticación obligatoria.
Inicio rápido
Base URL: http://localhost:3000/api/v1
Autenticación opcional: header Authorization: Bearer <API_KEY>.
Rate limit: 30 req/min por IP en endpoints de histórico y estadísticas. Con API key sube a 120 req/min. Se devuelven headers X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset.
curl "http://localhost:3000/api/v1/rates/current"
Endpoints
Cotización actual consolidada. Incluye estado del servicio, fuentes y brecha cambiaria.
{
"updatedAt": "2026-01-29T13:40:00.000Z",
"status": "OK",
"sources": { "bcb": "OK", "binance_p2p": "OK" },
"paralelo": { "buy": 12.4, "sell": 12.6, "sources_count": 1, "sampleSize": 72 },
"oficial": { "buy": 6.96, "sell": 6.96, "sources_count": 1 },
"brecha": { "gap_abs": 5.64, "gap_pct": 81.03 },
"notes": null
}Serie histórica con intervalos configurables. Parámetros: kind=PARALELO|OFICIAL, from, to, interval (ej. 10m, 1h).
{
"from": "2026-01-22T00:00:00.000Z",
"to": "2026-01-29T00:00:00.000Z",
"interval": "1h",
"series": [
{
"t": "2026-01-29T10:00:00.000Z",
"official_bcb": 6.96,
"parallel_mid": 12.5,
"parallel_buy": 12.4,
"parallel_sell": 12.6
}
],
"kind": "PARALELO",
"count": 1,
"data": [
{
"date": "2026-01-29T10:00:00.000Z",
"buy_avg": 12.4,
"sell_avg": 12.6,
"sources_count": 72
}
]
}Estadísticas para el dólar paralelo (min, max, promedio y variación). Parámetro: period=7d|30d|90d|1y.
{
"min": 12.1,
"max": 12.9,
"avg": 12.5,
"period": "30d",
"change_percent": 3.2,
"count": 720,
"timestamp_utc": "2026-01-29T13:40:00.000Z"
}Fuentes de datos
El dólar oficial se obtiene desde referencias institucionales (BCB) y el paralelo se calcula con datos agregados de mercados públicos P2P (Binance). Aplicamos validaciones para filtrar outliers y mantener series consistentes.
Uso y legal
Esta API es pública y de solo lectura. No documentamos endpoints administrativos ni internos en esta página.