钱包活动
关注钱包地址，接收原生币和代币的转入、转出事件。
区块链 Webhook API：接收钱包活动与代币转账
地址 Webhook 将关注钱包的转账与匹配合约日志发送到 HTTPS 接收端；入账前需验签、去重并处理缺口。
地址生效块之前的事件需另行回补，replay 无法补齐。内部原生币转账不包含。确认数须在 GET /v1/push/chains 公布的各链范围内，按块数计算，不按 safe 或 finalized 标签。
把地址活动发到你的接收端
native.transfer 投递顶层交易中的原生币转账，token.transfer 投递 ERC-20、ERC-721 和 ERC-1155 转移；其他日志若由关注的合约地址发出，或在 topics[1]–topics[3] 中包含关注地址，则通过 log 投递。
GET /v1/push/chains 返回当前支持的链及其确认数范围。选择订阅的链之前，先携带 API key 查询。
一个订阅可覆盖多条链、一个接收 URL。开发者与 AI Agent 使用相同的容量档位和价格。
- 自助档
每个订阅最多 1,000,000 个地址，注册即用。
按量计费
- 企业档
每个订阅 10,000,000 / 100,000,000 个地址。
联系我们开通
两档沿用相同的地址日与已送达事件单价。
钱包与合约活动的常见用法
稳定币到账
接收 ERC-20 USDT / USDC 转账，核对代币合约、收款地址和整数金额后再入账。
合约事件
关注合约地址以接收其日志，或接收 topics[1]–topics[3] 中包含关注地址的日志。
NFT 转移
处理 ERC-721 和 ERC-1155 转移，读取 token_id；批量转移还可读取 batch_index。
验签、确认与恢复
- 处理事件前，用订阅密钥对 `webhook-id.webhook-timestamp.raw-body` 校验 HMAC-SHA256 签名；请使用原始请求体，切勿先解析 JSON。
- 事件按至少一次语义投递。按事件 id 去重，持久化处理结果后返回 2xx。订阅在线且事件仍在保留窗口内时，投递失败会继续重试。
- 按链设置 confirmations，取值范围从 GET /v1/push/chains 查询。chain.reorg 通知已投递区块被替换：按 ref 标记旧事件，保留自动重投的规范链事件，并按 id 去重。
- Replay 在可重放范围内重新投递已存储的匹配事件，不能找回地址或链加入订阅之前的活动。
定价
下表从 GET /v1/plans 读取 CU 权重和免费地址额度。数据事件按投递计费，自动重试和控制事件免费；replay 的重新投递按事件价格计费。
Webhook 推送
CU 权重来自 GET /v1/plans，自动重试免费。
每账户每 UTC 日免费地址数：1000
每账户每 UTC 日的免费地址额度，由所有订阅组共享，与套餐无关。对每个组，统计其在该日在线期间的最大地址数；按组 ID 升序分配额度。同一地址在两个组中计为两份；组内链的数量不会使地址数成倍增加。整日离线或已删除的组不计入。对每个组，扣除分配给它的额度后，将剩余地址数乘以 `push.address_day` CU 权重（来自 `method_weights`）。当前配置的额度来自地址日计费所用的同一定价策略；它不是账户容量上限，也不是每个组各自独立的额度。
| 方法 | 计费单位 | CU |
|---|---|---|
| push.address_day | 计费地址日 | 33 |
| push.history | 成功的历史查询请求 | 25 |
| push.log | 已送达的数据事件 | 150 |
| push.native_transfer | 已送达的数据事件 | 150 |
| push.token_transfer | 已送达的数据事件 | 150 |