Skip to main content

什么是 Solana webhooks?

Solana webhooks 是当链上事件发生时,实时通过 HTTP 通知发送到您的应用程序。与其不断轮询区块链,Helius 会在钱包转移资金、NFT 销售或任何监控的交易类型触发时,将解析的交易数据直接推送到您的端点。使用 webhooks 来支持交易机器人、分析仪表盘、合规流水线和事件驱动的自动化。 我们提供了用户友好的界面、程序化 API 和 SDK 访问,以便轻松创建和管理 webhooks。有关常见问题,请参见 Webhooks FAQ
如果您的服务器未成功响应,Helius 可能会重试 webhook 的传送,并且您可能会收到重复事件。有关重试和处理重复的详细信息,请参阅 Webhooks FAQ

价格

当 Helius 处理并将事件发送到您的端点时,Webhook 事件会收取 1 个信用。无论您的端点是否成功处理了 webhook,您都会被收取费用。通过 API 编辑、添加或删除 webhook 将花费 100 个信用/请求。

Webhooks 类型

我们目前提供几种针对不同需求定制的 webhooks 类型:

增强交易 Webhooks

提供与您监控的地址相关的特定交易类型(例如,NFT 销售)的人可读解析数据。如果您想要过滤后的可操作见解,这是理想的选择。

原始交易 Webhooks

此选项为您监控的地址涉及的所有交易提供原始交易数据。它不允许按交易类型进行过滤。
原始交易 Webhooks 提供较低延迟,因为它们不涉及事件类型解析。

Discord Webhooks

将特定交易类型的流更新直接作为格式化消息发送到指定的Discord频道。要使用此选项,您必须提交您的Discord Webhook URL。

事件有效负载示例

开始使用

Webhooks 快速入门

通过仪表板、REST API 或官方 TypeScript / Rust SDK 创建您的第一个 webhook。

自动禁用失败的 Webhooks

Helius 监控 webhook 端点的健康状况,并自动禁用持续无法接收传递的 webhooks。这可以防止向无法访问或损坏的端点进行无用的传递尝试。

工作原理

  • 付费计划(开发及以上): Webhooks 在 7 天内故障率 ≥ 95% 的情况下会被自动禁用。
  • 免费计划: Webhooks 在一个 24 小时窗口 内进行评估,故障阈值相同。
系统每 4 小时检查一次 webhook 的健康状况。当 webhook 被禁用时,传递将在几秒钟内停止。

电子邮件通知

开发计划及以上 的用户在 webhook 被自动禁用时会收到电子邮件通知。

重新启用禁用的 Webhook

1

修复您的端点

解决导致传递失败的问题(例如,服务器停机、不正确的 URL、端点错误)。
2

登录 Helius 仪表板

3

重新启用 webhook

找到禁用的 webhook 并重新打开。
您还可以通过 Toggle Webhook API endpoint 以编程方式重新启用 webhook。
重新启用后,webhook 将进入 24 小时宽限期,在此期间不会再次自动禁用。这使您有时间验证您的端点是否健康。

示例用途

机器人

  • 当在市场 X 上列出 NFT 时,触发 “NFT 购买” 操作。
  • 当保证金头寸不健康时,触发 “清算” 操作。

监控与警报

  • 当程序发出某个日志时,它会触发PagerDuty集成。
  • 当代币账户余额变化超过X%时,使用Dialect进行警告操作。

事件驱动的索引

  • 当给定程序发生任何交易时,将其直接发送到您的数据库或后端。

通知与活动跟踪

  • 从钱包X转移到钱包Y时,发送Slack通知或电子邮件。

分析与日志

  • 当事件X发生时,将其发送到ETL管道或直接保存在Helius上,以便随时间查看趋势。

工作流自动化

  • 当事件X发生时,触发任何一组操作。