Skip to main content

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.
O Helius pode tentar reenviar as entregas de webhooks se o seu servidor não responder com sucesso, e você pode receber eventos duplicados. Para detalhes sobre tentativas de reenvio e tratamento de duplicados, 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

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.
O sistema verifica a saúde dos webhooks a cada 4 horas. Quando um webhook é desativado, as entregas param em segundos.

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.
Você também pode reativar webhooks programaticamente via o Endpoint da API de Alternância de Webhook.
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.