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.
Metodología completa en preguntas frecuentes, fuentes y licencia de uso de datos en fuentes. Los datos se actualizan cada 10 minutos; el histórico consolida promedios diarios.
Inicio rápido
Base URL: https://dolarparalelohoy.com/api/v1
Autenticación opcional: header Authorization: Bearer <API_KEY>.
Rate limit: depende del plan (ver tabla abajo). Se devuelven headers X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset en cada respuesta.
curl "https://dolarparalelohoy.com/api/v1/rates/current"
Planes
Sin API key tienes acceso de solo lectura con límites básicos. Los planes Free y Pro suben el límite de peticiones y el rango de histórico disponible; están en fase de diseño y todavía no se emiten claves de forma automática.
| Plan | /rates/current | /rates/history y /rates/statistics | Histórico máximo |
|---|---|---|---|
| Anónimo | 60 req/min | 30 req/min | 1000 días |
| Free (con API key) | 120 req/min | 90 req/min | 2000 días |
| Pro | 600 req/min | 400 req/min | 4000 días (todo el histórico) |
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.