跳至主要内容

地址轉帳監聽 · 簡介

產品概述​

簡介​

地址轉帳監聽服務面向需要跟進錢包地址在鏈上轉帳行為的業務場景：服務持續接收並解析多鏈交易資料，將相關轉帳結構化後落庫，並透過 HTTP 與 WebSocket 將結果推送給已訂閱的應用。

設計目標：接入方無需自建節點或自研解析流水線，只需維護監聽地址與連線，即可感知指定地址的鏈上轉帳與相關交易資訊。

核心能力​

能力說明
多鏈交易監聽統一接入 EVM 系、Solana、Tron、Bitcoin 等多條鏈
即時推送透過 WebSocket 將鏈上交易即時推送給訂閱方
歷史查詢透過 HTTP 介面查詢地址的歷史交易記錄
地址訂閱管理動態增刪監聽地址，支援多應用隔離
Webhook 通知將交易資料推送到接入方配置的 HTTP 回呼地址

支援的鏈​

EVM 相容鏈​

鏈chain_type主網 chain_id
Ethereumethereum1
BNB Smart Chainbsc56
Polygonpolygon137
Arbitrum Onearbitrum42161
Optimismoptimism10
Basebase8453

非 EVM 鏈​

鏈chain_type主網 chain_id
Solanasolana1
Trontron1
Bitcoinbitcoin1

說明：chain_type 在請求時大小寫不敏感，服務端會自動歸一化為小寫。

核心概念​

鏈標識：chain_type 與 chain_id​

每條鏈透過兩個欄位唯一標識：

  • chain_type：鏈的類型名稱，例如 ethereum、solana、tron
  • chain_id：鏈 ID，區分主網與測試網，例如以太坊主網為 1，Sepolia 測試網為 11155111

這兩個欄位在所有涉及鏈的介面中均會用到。

公共鑑權：X-API-Key​

目前對外提供的介面統一透過公共請求頭 X-API-Key 進行介面鑑權和計費識別。地址管理、交易查詢和 WebSocket 連線都應攜帶該請求頭。

X-API-Key: your-api-key

統一回應格式​

大多數介面的回應遵循以下 JSON 結構：

{
  "code": 0,
  "message": "ok",
  "data": {}
}
欄位類型說明
codeinteger業務狀態碼，0 表示成功
messagestring回應訊息，成功時通常為 ok
dataany業務資料，失敗時為 null

注意：部分歷史介面的訊息欄位名為 msg 而非 message，接入時請以具體介面文件為準。

錯誤回應格式​

請求失敗時，回應結構如下：

{
  "code": 400,
  "msg": "Invalid request",
  "data": null
}

常見 HTTP 狀態碼：

狀態碼含義
400請求參數驗證失敗
401鑑權失敗（推流金鑰錯誤）
403無權限（API Key 錯誤）
504請求逾時（超過 15 秒）
500服務內部錯誤

鑑權方式​

對外 API 統一使用 X-API-Key 請求頭。該 Key 同時用於介面鑑權、呼叫方識別和計費統計。

公共 API Key（X-API-Key）​

所有對外介面請求都應攜帶：

X-API-Key: your-api-key