Webhooks

Eventos on-chain, entregados en tu endpoint

Define una vez el trigger y los filtros. GetBlock sigue cada bloque nuevo y envía cada evento que coincide a tu endpoint HTTPS: firmado, reintentado y corregido en caso de reorg.

Crear un webhook arrow-up-right
  • 25 CU

    por intento de entrega

  • 8 intentos

    reintentos durante unos 52 minutos

  • HMAC-SHA256

    firma en cada entrega

  • 250.000

    direcciones por webhook desde Scale

POR QUÉ WEBHOOKS

Deja de consultar. Empieza a reaccionar.

El polling gasta solicitudes en bloques vacíos. Los webhooks te avisan solo cuando algo ocurre.

Sin bucle de polling

GetBlock sigue cada bloque nuevo y envía solo los eventos que coinciden.

Filtros precisos

Filtra por dirección, contrato y topic. Vigila hasta 250.000 direcciones por webhook desde Scale.

Preparado para reorgs

Suscríbete a la primera inclusión, a la confirmación o a ambas. Si un bloque se descarta, recibes una corrección.

Firmado y reintentado

Cada solicitud va firmada con HMAC-SHA256. Una entrega fallida tiene hasta 8 intentos.

CASOS DE USO

Para productos que reaccionan a la cadena

Un endpoint sustituye al poller y al escáner de bloques.

Notificaciones de wallet

Avisa a los usuarios cuando entran o salen ETH o tokens.

Confirmación de depósitos

Acredita depósitos al alcanzar la profundidad de confirmación que elijas.

Alertas de DeFi y contratos

Sigue swaps, liquidaciones o eventos de gobernanza por contrato y topic.

Actividad NFT

Sigue los mints y transferencias de las colecciones que te interesan.

Monitorización de cumplimiento

Vigila listas de hasta 100.000 direcciones y envía cada coincidencia.

Pipelines de analítica

Lleva los eventos coincidentes a tu cola o data warehouse.

CÓMO FUNCIONA

En marcha en tres pasos

Usa el panel o la API.

  1. Elige un trigger y filtros

    Actividad de wallets, logs de contratos o confirmaciones de transacciones.

  2. Añade tu endpoint HTTPS

    Guarda el secreto y verifica cada firma.

  3. Recibe eventos

    Confirma en menos de 15 segundos y deshaz los eventos revertidos por reorg.

Cobertura de redes

Disponible

  • Ethereum

Próximamente

  • BNB Smart Chain
  • Polygon
  • Base

Webhooks v1 funciona en Ethereum mainnet. BNB Smart Chain, Polygon y Base están en la hoja de ruta y todavía no se pueden seleccionar.

COMPARACIÓN

Webhooks frente a otros enfoques

Cada uno sirve para algo distinto.

CapacidadGetBlock WebhooksPolling RPCStream WebSocketIndexador propio
Puesta en marcha Minutos en el panel Poller y almacén de cursores Cliente con reconexión Nodos, indexador, almacenamiento
Infraestructura que gestionas Un endpoint HTTPS Workers, estado Cliente de socket siempre activo Nodos, bases de datos, monitorización
Si tu servicio cae 8 intentos en unos 52 minutos Te pones al día tú mismo Pierdes eventos desconectado Reproduces tú mismo
Modelo de coste 25 CU por intento CU por consulta, incluso vacía CU por evento entregado Servidores y tiempo de ingeniería

Una comparación de enfoques, no de proveedores concretos. Tus cifras dependen del tráfico y la arquitectura.

PLAYGROUND

Crea un webhook y mira cómo llegan los eventos

Una simulación en tu navegador con datos simulados. No se envía nada a GetBlock.

  • checkCrea un webhook
  • checkMira cómo llegan entregas firmadas
  • checkHaz fallar tu endpoint y observa los reintentos

PRECIOS

Paga por intento de entrega

Tu plan de CU incluye los webhooks y fija sus límites.

Calcula tus CU

Eventos coincidentes al mes

Fases por evento

La no confirmada se envía cuando la transacción entra en un bloque; la confirmada, cuando ese bloque alcanza tu profundidad de confirmación.

2.500.000 CU al mes

Supone que cada intento tiene éxito. Los reintentos y las correcciones por reorg añaden intentos.

El plan Free incluye 50.000 CU al día, unos 2.000 intentos de entrega.

Ver planes de CU
Límites de webhooks por plan
PlanWebhooks activosDirecciones por webhookDirecciones por cuentaEventos por segundoRáfaga
Free11010112
Starter10100.000100.000560
Growth25100.000250.00010120
Advanced25100.000250.00010120
Scale50250.0001.000.00020240
Pro75250.0001.000.00030360
Premium100250.0001.000.00050600
EnterpriseLímites de Premium o según acuerdo
  • Los webhooks en pausa cuentan para los webhooks activos y las direcciones.
  • Los eventos por segundo son un único presupuesto para todos tus webhooks. Los que lo superan se descartan, no se retrasan, y no se cobran.

BUENO SABERLO

Preguntas frecuentes

¿Necesitas límites más altos o una configuración a medida?

Más respuestas en la documentación

Lanza tu primer webhook hoy

Empieza con el plan Free: 1 webhook, 10 direcciones y 50.000 CU cada día.