錢包活動
關注錢包地址，接收原生幣和代幣的轉入、轉出事件。
區塊鏈 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 |