无需轮询
GetBlock 跟踪每个新区块，只推送匹配的事件。
25 CU
每次投递尝试
8 次尝试
在约 52 分钟内重试
HMAC-SHA256
每次投递都带签名
250,000
Scale 及以上方案每个 Webhook 的地址数
为什么选择 WEBHOOK
告别轮询，即时响应。
轮询会把请求浪费在空区块上。Webhook 只在真正发生变化时通知你。
精确筛选
按地址、合约和 topic 匹配。Scale 及以上方案每个 Webhook 最多可监控 250,000 个地址。
天然感知重组
可订阅首次上链、确认或两者。如果区块被丢弃，你会收到更正。
签名与重试
每个请求都带有 HMAC-SHA256 签名。失败的投递最多尝试 8 次。
使用场景
为需要响应链上事件的产品而生
一个端点即可取代轮询器和区块扫描器。
钱包通知
ETH 或代币转入、转出时立即通知用户。
充值确认
充值达到你设定的确认深度后再入账。
DeFi 与合约提醒
按合约和 topic 跟踪兑换、清算或治理事件。
NFT 动态
跟踪你关注的系列的铸造与转移。
合规监控
监控最多 100,000 个地址的列表，并转发每次命中。
分析数据管道
将匹配的事件送入你的队列或数据仓库。
工作原理
三步上线
使用控制台或 API 均可。
选择触发器和筛选条件
钱包活动、合约日志或交易确认。
添加 HTTPS 端点
保存密钥，并验证每个签名。
接收事件
在 15 秒内确认接收，并撤销被重组的事件。
网络覆盖
已上线
Ethereum
即将支持
BNB Smart Chain
Polygon
Base
Webhook v1 运行在以太坊主网。BNB Smart Chain、Polygon 和 Base 已在路线图中，目前暂不可选。
对比
Webhook 与其他方式对比
每种方式各有所长。
| 能力 | GetBlock Webhooks | 轮询 RPC | WebSocket 数据流 | 自建索引器 |
|---|---|---|---|---|
| 搭建 | 在控制台几分钟完成 | 轮询器和游标存储 | 带重连的客户端 | 节点、索引器和存储 |
| 你需要运维的基础设施 | 一个 HTTPS 端点 | Worker、状态 | 常驻的 Socket 客户端 | 节点、数据库、监控 |
| 你的服务宕机时 | 约 52 分钟内最多 8 次尝试 | 需要自己追赶 | 断开期间的事件会丢失 | 自己重放 |
| 成本模式 | 每次尝试 25 CU | 每次轮询都消耗 CU，空结果也算 | 按投递事件计 CU | 服务器和工程时间 |
在控制台几分钟完成这是不同方式之间的对比，而非具体服务商的对比。实际数据取决于你的流量和架构。
价格
按投递尝试付费
你的 CU 方案涵盖 Webhook，并决定其限额。
25 CU每次投递尝试
从与 RPC 请求相同的 CU 余额中扣除。
每次尝试都计费，包括重试。测试投递免费。 计费规则详解
创建 Webhook
估算 CU 用量
每月匹配的事件数
每个事件的阶段数
未确认：交易进入区块时发送；已确认：该区块达到你设定的确认深度时发送。
2,500,000 每月 CU
假设每次尝试都成功。重试和重组更正会增加尝试次数。
Free 方案每天包含 50,000 CU，约可进行 2,000 次投递尝试。
| 方案 | 活跃 Webhook | 每个 Webhook 的地址数 | 每个账户的地址数 | 每秒事件数 | 突发 |
|---|---|---|---|---|---|
| Free | 1 | 10 | 10 | 1 | 12 |
| Starter | 10 | 100,000 | 100,000 | 5 | 60 |
| Growth | 25 | 100,000 | 250,000 | 10 | 120 |
| Advanced | 25 | 100,000 | 250,000 | 10 | 120 |
| Scale | 50 | 250,000 | 1,000,000 | 20 | 240 |
| Pro | 75 | 250,000 | 1,000,000 | 30 | 360 |
| Premium | 100 | 250,000 | 1,000,000 | 50 | 600 |
| Enterprise | 与 Premium 相同，或按协议约定 | ||||
- 已暂停的 Webhook 也计入活跃 Webhook 数和地址数。
- 每秒事件数是你所有 Webhook 共享的一个额度。超出的事件会被丢弃而不是延迟，且不计费。
须知
常见问题
需要更高的限额或定制方案？
更多解答请见文档