¿Qué son los webhooks de Solana?
Los webhooks de Solana son notificaciones HTTP en tiempo real que se envían a tu aplicación cuando ocurren eventos on-chain. En lugar de consultar continuamente la blockchain, Helius envía los datos analizados de las transacciones directamente a tu endpoint cada vez que una billetera transfiere fondos, se vende un NFT o se activa cualquier tipo de transacción monitoreada. Usa webhooks para impulsar bots de trading, paneles de análisis, flujos de cumplimiento y automatizaciones basadas en eventos. Ofrecemos una interfaz fácil de usar, una API programática y acceso mediante SDK para crear y administrar webhooks con facilidad. Para consultar las preguntas frecuentes, consulta las preguntas frecuentes sobre webhooks. Para compilaciones nuevas que necesitan transacciones analizadas en tiempo real, considera Parsed Streams. Es el sucesor de Enhanced Transaction Webhooks, decodifica cada instrucción mediante el catálogo de IDL, filtra en el servidor por programa, cuenta y nombre de instrucción, y se factura al mismo precio de 1 crédito por evento en todos los planes.Precios
Los eventos de webhook se cobran a 1 crédito cuando Helius procesa y envía el evento a tu endpoint. El cargo se aplica independientemente de si tu endpoint procesa correctamente el webhook. Editar, agregar o eliminar un webhook mediante la API cuesta 100 créditos por solicitud.Tipos de webhooks
Actualmente, ofrecemos varios tipos de webhooks adaptados a diferentes necesidades:Webhooks de transacciones mejoradas
Proporcionan datos analizados y legibles para humanos sobre tipos específicos de transacciones (por ejemplo, ventas de NFT) relacionadas con las direcciones que monitoreas. Es ideal si buscas información filtrada y útil para tomar medidas.Webhooks de transacciones sin procesar
Esta opción entrega datos de transacciones sin procesar para todas las transacciones que involucren las direcciones que monitoreas. No permite filtrar por tipo de transacción.Los webhooks de transacciones sin procesar ofrecen menor latencia porque no requieren analizar los tipos de eventos.
Webhooks de Discord
Transmite actualizaciones de tipos específicos de transacciones directamente a un canal de Discord designado como mensajes con formato. Para usar esta opción, debes proporcionar la URL de tu webhook de Discord.Ejemplo de carga útil de un evento
Enhanced
Enhanced
Raw
Raw
Primeros pasos
Webhooks Quickstart
Crea tu primer webhook mediante el Dashboard, la API REST o los SDK oficiales de TypeScript y Rust.
Desactivación automática de webhooks con errores
Helius monitorea el estado de los endpoints de webhooks y desactiva automáticamente los webhooks que no reciben entregas de forma constante. Esto evita intentos de entrega innecesarios a endpoints inaccesibles o dañados.Cómo funciona
- Planes de pago (Dev y superiores): Los webhooks con una tasa de fallos ≥ 95 % durante 7 días se desactivan automáticamente.
- Plan gratuito: Los webhooks se evalúan durante un periodo de 24 horas con el mismo umbral de fallos.
Notificaciones por correo electrónico
Los usuarios del plan Dev y superiores reciben una notificación por correo electrónico cuando un webhook se desactiva automáticamente.Volver a activar un webhook desactivado
1
Fix your endpoint
Resuelve el problema que causa los fallos de entrega (por ejemplo, interrupciones del servidor, una URL incorrecta o errores del endpoint).
2
Log in to the Helius Dashboard
Ve al Dashboard de Helius.
3
Re-enable the webhook
Busca el webhook desactivado y vuelve a activarlo.
Después de volver a activarlo, el webhook entra en un periodo de gracia de 24 horas durante el cual no se volverá a desactivar automáticamente. Esto te da tiempo para verificar que tu endpoint funciona correctamente.
Ejemplos de uso
Bots
- Cuando se publique un NFT en el mercado X, activa una acción de “compra de NFT”.
- Cuando una posición de margen no sea saludable, activa una acción de “liquidación”.
Monitoreo y alertas
- Cuando un programa emita un registro determinado, activa la integración con PagerDuty.
- Cuando el saldo de una cuenta de tokens cambie más de un X %, usa Dialect para comunicar una alerta.
Indexación basada en eventos
- Cuando ocurra cualquier transacción para un programa determinado, envíala directamente a tu base de datos o backend.
Notificaciones y seguimiento de actividad
- Cuando se haga una transferencia de la billetera X a la billetera Y, envía una notificación de Slack o un correo electrónico.
Análisis y registros
- Cuando ocurra el evento X, envíalo a una canalización ETL o almacénalo directamente en Helius para ver las tendencias a lo largo del tiempo.
Automatización de flujos de trabajo
- Cuando ocurra el evento X, activa cualquier conjunto de acciones.