O que são webhooks do Solana?
Os webhooks do Solana são notificações HTTP em tempo real enviadas para sua aplicação quando ocorrem eventos na cadeia. Em vez de consultar continuamente a blockchain, o Helius envia dados de transações processados diretamente para seu endpoint sempre que uma carteira transfere fundos, um NFT é vendido ou qualquer tipo de transação monitorada é acionada. Use webhooks para alimentar bots de negociação, painéis de análise, pipelines de conformidade e automação orientada por eventos. Oferecemos uma interface amigável, API programática e acesso a SDK para criar e gerenciar webhooks com facilidade. Para perguntas frequentes, veja as Perguntas Frequentes sobre Webhooks.Preços
Eventos de webhook são cobrados a 1 crédito quando o Helius processa e envia o evento para seu endpoint. Você será cobrado independentemente de seu endpoint processar com sucesso o webhook ou não. Editar, adicionar ou excluir um webhook via API custará 100 créditos por solicitação.Tipos de Webhooks
Atualmente oferecemos vários tipos de webhooks adaptados a diferentes necessidades:Webhooks de Transações Aprimoradas
Fornecem dados processados, legíveis por humanos, para tipos específicos de transações (por exemplo, vendas de NFT) relacionadas aos endereços que você monitora. Isso é ideal se você deseja insights filtrados e acionáveis.Webhooks de Transações Brutas
Esta opção entrega dados brutos de transações para todas as transações envolvendo os endereços que você monitora. Não permite filtragem por tipo de transação.Os Webhooks de Transações Brutas oferecem menor latência, pois não envolvem o processamento dos tipos de eventos.
Webhooks do Discord
Transmitem atualizações para tipos específicos de transações diretamente para um canal designado do Discord como mensagens formatadas. Para usar esta opção, você deve enviar sua URL do Webhook do Discord.Exemplo de Payload de Evento
Aprimorado
Aprimorado
Bruto
Bruto
Comece Agora
Início Rápido de Webhooks
Crie seu primeiro webhook através do Painel, API REST ou SDK oficial TypeScript / Rust.
Desativação Automática de Webhooks com Falhas
O Helius monitora a saúde dos endpoints de webhook e desativa automaticamente webhooks que consistentemente não recebem entregas. Isso evita tentativas de entrega desperdiçadas contra endpoints inatingíveis ou com problemas.Como Funciona
- Planos pagos (Dev e superiores): Webhooks com taxa de falha ≥ 95% ao longo de 7 dias são desativados automaticamente.
- Plano gratuito: Webhooks são avaliados em uma janela de 24 horas com o mesmo limite de falha.
Notificações por Email
Usuários no plano Dev e superiores recebem uma notificação por email quando um webhook é desativado automaticamente.Reativando um Webhook Desativado
1
Corrigir seu endpoint
Resolva o problema que está causando as falhas de entrega (por exemplo, tempo de inatividade do servidor, URL incorreta, erros de endpoint).
2
Faça login no Painel Helius
Vá para o Painel Helius.
3
Reative o webhook
Encontre o webhook desativado e ative-o novamente.
Após a reativação, o webhook entra em um período de carência de 24 horas durante o qual ele não será desativado automaticamente novamente. Isso lhe dá tempo para verificar se o seu endpoint está estável.
Exemplos de Uso
Bots
- Quando um NFT é listado no marketplace X, aciona uma ação de “compra de NFT”.
- Quando uma posição de margem está instável, aciona uma ação de “liquidação”.
Monitoramento e Alertas
- Quando um programa emite um determinado log, ele aciona a integração com o PagerDuty.
- Quando o saldo de uma conta de token muda em mais de X%, usa o Dialect para comunicar uma ação de alerta.
Indexação Orientada a Eventos
- Quando qualquer transação ocorre para um determinado programa, envie-a diretamente para seu banco de dados ou backend.
Notificações e Rastreamento de Atividades
- Ao transferir da carteira X para a carteira Y — envia uma notificação via Slack ou email.
Análises e Logs
- Quando o evento X acontece, envie-o para um pipeline ETL ou persista diretamente no Helius para visualizar tendências ao longo do tempo.
Automação de Fluxo de Trabalho
- Quando o evento X acontece, acione qualquer conjunto de ações.