API pública y widget

Todo lo que muestra BCV Hoy está disponible gratis para tu app, bot o web. Sin clave y sin registro. Solo te pedimos citar a bcvhoy.com.

Widget en vivo para tu web

Pega esto donde quieras que aparezcan las tasas. Se actualiza solo por WebSocket.

<script src="https://bcvhoy.com/widget.js" async></script>
<bcv-hoy mostrar="bcv,binance,brecha"></bcv-hoy>

Atributos: mostrar (bcv, binance, euro, brecha) y tema (claro u oscuro).

REST: tasas actuales

curl https://bcvhoy.com/api/tasas

JSON con oficial (dólar BCV), oficial_updated (fecha valor), oficial_prev, euro, binance y binance_pm (USDT/VES en Binance P2P general y Pago Móvil), cop_usdt, brl_usdt, pen_usdt, clp_usdt, ars_usdt, pyg_usdt (unidades por USDT) y eurusd (BCE). CORS abierto, caché de 15 segundos.

Importante: si la fecha de oficial_updated es posterior a hoy, el BCV ya publicó la tasa de mañana: la vigente hoy es oficial_prev.

WebSocket: tiempo real

const ws = new WebSocket('wss://bcvhoy.com/ws');
ws.onmessage = (e) => {
  const m = JSON.parse(e.data);
  // "snapshot" al conectar; luego "delta" solo con lo que cambió
  if (m.type === 'snapshot' || m.type === 'delta') console.log(m);
  if (m.type === 'bcv_publicado') console.log('¡El BCV publicó!', m.usd);
};

Histórico

• /datos/tasa-bcv.csv: tasa BCV diaria desde 2023, con mercado y brecha.
• /api/bcv/publicaciones: cada publicación del BCV que detectamos, con la hora exacta.
• /llms.txt: resumen para modelos de IA.