跳转到主要内容

​
配额和速率限制

使用 API 最多可以输入 100,000 个地址。
是的，通过 API 或仪表板编辑 webhook 每次请求需要 100 积分。这适用于任何修改，包括 URL 更改、添加/删除地址或更新交易类型。
每个 webhook 事件在 Helius 处理并发送到您的端点时需要 1 积分。无论您的端点是否成功处理 webhook 或返回错误，您都将被扣除积分。
通过 API 执行的所有 webhook 管理操作（创建、编辑、删除）每次请求需要 100 积分。这涵盖了更新您的 webhook 配置所需的处理。

​
支持的网络

是的。如果您通过 UI 创建 webhook，请选择“devnet”作为“Network”。如果您通过 Webhook API 创建它，请根据所需的 webhook 类型将“webhookType”参数设置为 “rawDevnet”、“enhancedDevnet” 或 “discordDevnet”。
不可以——URL 必须通过 HTTPS 公开可访问。Helius 无法通过 localhost URL 访问本地开发服务器。

​
使用 Webhooks

在创建或更新 webhook 时设置一个授权头。Helius 在将数据发送到您的 webhook 端点时会在 Authorization 头中回显此值，允许您验证请求的真实性。
原始webhooks直接从区块链返回常规的Solana交易数据。当监控的地址发生交易时，原始交易数据会被发送到您的webhook URL。增强webhooks提供Helius解释的交易类型。我们解析超过100种Solana交易类型（NFT列表、DeFi交换、转账等），并将其抽象为我们自己的模式。如果您想要所有的交易数据而不进行抽象，请使用原始webhooks；如果您想要内置的交易类型检测和解析，请使用增强webhooks。
Webhooks在匹配的交易在区块链上确认后立即发送通知。

​
重试

如果您的服务器出错或超时，Helius将重新尝试传递。您的端点应返回200状态码以确认成功接收。如果您的端点返回错误状态码或根本没有响应，我们将以1分钟的间隔重试传递最多3次。如果所有重试尝试都失败，webhook事件将被丢弃。在Helius仪表板中监控您的webhook日志，以识别传递失败并调查端点问题。我们还为企业计划提供可定制的重试策略。
Helius可能会多次传递相同的webhook事件。这可能是由于重试逻辑或网络问题导致的。您的webhook处理程序必须准备好优雅地处理重复事件——多次处理相同事件应产生与处理一次相同的结果。要处理重复事件，请使用交易签名或唯一事件标识符来跟踪您已处理的事件。
这取决于webhook的类型。增强型webhook不发送失败的交易，但原始webhook会包括成功和失败的交易。

​
webhook故障排除

数据丢失通常发生在您的端点遇到错误时，导致webhook重试最终失败并导致数据丢失。检查您在仪表板中的webhook日志，确保有足够的客户端日志记录，如果问题仍然存在，请联系支持。
确保所选的交易类型与您正在监控的交易匹配。首先使用 “ANY” 交易类型来确定这是一个普遍问题还是类型不匹配。使用 webhook.site 测试问题是否出在您的端点配置上。
TOKEN_MINT webhook 仅对特定程序触发，如 Candy Machine V1 和 Solana Program Library。它不涵盖整个区块链上的所有代币铸造事件。对于更广泛的监控，考虑使用更通用的账户或程序订阅，通过 webhooks 使用 “ANY” 交易类型过滤。

​
需要更多帮助？

联系支持

通过 Discord、聊天或电子邮件支持从我们的团队获取帮助。

状态页面

查看实时服务可用性和性能信息。