Skip to main content
HistóricoCampos nuevosContrato
Histórico y campos nuevos
  • Histórico con ?fecha=AAAA-MM-DD en oficial, ufv, oro, sdr, sofr, monedas, inflacion (mes), oma y tre (mes): lo que el BCB publicó para esa fecha, con su procedencia en historico. Rangos en /api/v1/historico/{serie}.
  • Nuevos endpoints: /tc/oma y /tc/tre.
  • monedas.cotizaciones[].me_por_usd (unidades por 1 USD) · oro.bs_otf / plata_bs_otf · sdr.bs_por_deg (Bs, de las páginas del BCB).
  • inflacion.acumulada_pct y nucleo_* (panel de estadísticas del BCB).
  • Cambio de contrato: oma.tasa_reporto_15d va null si el plazo vigente no es de 15 días (hoy es de 7). Usa tasa_reporto + plazo_reporto_dias.
ErroresCaché
Uso justo: mejoras
  • 429 en application/problem+json (RFC 9457). El objeto error anterior sigue en el mismo cuerpo.
  • Un 304 (revalidación con el ETag vigente) no consume cuota.
  • Bloqueo por IP si muchos User-Agents distintos ignoran el 429 desde la misma red.
LímitesCaché
Uso justo
  • Cabeceras RateLimit-* (IETF) además de X-RateLimit-*.
  • Cache-Control hasta la próxima publicación del BCB · ETag + If-None-Match → 304.
  • Insistir tras un 429 se bloquea: 403 1 h → 24 h → 7 días. Política
Campos nuevosDisponibilidad
Resiliencia por indicador
  • actualizado · desactualizado en UFV, oro, monedas, SOFR, DEG e inflación (antes sólo en el TC).
  • UFV cruzada entre tres publicaciones del BCB; oro entre dos.
  • Si una fuente del BCB cae o cambia, cada indicador sigue con su último valor válido (también tras un reinicio).
  • Sin dato ni valor anterior: 503 con Retry-After en vez de 200 con null.
  • ufv.proxima: la UFV de mañana, que el BCB publica desde ~20:00; ufv sigue siendo la de hoy hasta medianoche.
  • oma.tasa_reporto + plazo_reporto_dias (el BCB rotula hoy “reporto 7 días”); tasa_reporto_15d queda como alias deprecado (desde el 07-oct, null si el plazo no es de 15 días).
NormaContrato
RD BCB 142/2026
  • Publicación del BCB a las 23:30 (antes 20:00). proxima_publicacion ya lo refleja.
  • venta = TCO: la norma eliminó el tope TCO + Bs 0,10.
  • El TCO nuevo se sirve minutos después de publicado.
  • X-RateLimit-Reset y headers de cuota legibles desde el navegador (CORS).
  • URL con / final responde 200 directo.
  • proxima siempre presente (null si no aplica) en todos los endpoints.
  • Registro de solicitudes (400 días).
Campos nuevos
Vigencia por rango
  • vigencia_desde · vigencia_hasta: rango que rotula el BCB (fin de semana y feriados).
  • fecha_publicacion_derivada · desactualizado.
  • HEAD en todos los endpoints · 503 con Retry-After si el BCB no responde (desde el 06-oct, sólo si además no hay un valor anterior).
Infra
Dominio canónico
  • apibcb.cucu.bo. bcb.cucu.bo/api/* sigue funcionando.
  • Límite de 120/h por cliente real.
NormaCampos nuevos
Régimen flexible
  • TC oficial flexible (RD BCB 88/2026).
  • proxima · actualizado · proxima_publicacion.