跳至主要內容

使用 JSON-RPC 監聽 USDT / USDC 收款

用 BlockVectra 的 JSON-RPC 監聽 USDT / USDC 到帳(透過 eth_getLogs 輪詢;支援 WebSocket 的鏈也可以訂閱)。

支援的鏈

各鏈能力以 GET /v1/chains 為準。

鏈支援的接收機制
Arbitrum OneHTTP 輪詢 (eth_getLogs)
BaseHTTP 輪詢 (eth_getLogs)
BNB Smart ChainHTTP 輪詢 (eth_getLogs)
EthereumHTTP 輪詢 (eth_getLogs)
HyperEVMHTTP 輪詢 (eth_getLogs)
PolygonHTTP 輪詢 (eth_getLogs)
Robinhood ChainHTTP 輪詢與 WebSocket 訂閱

三步接入收款監聽

1. 獲取 API key

透過以太坊錢包簽名進行 程式化開戶(簡體中文) 自主建立 key,或直接登入 控制台 建立。

2. 按指南輪詢 Transfer 事件

使用代幣合約地址、Transfer 事件 topic0 簽名雜湊與 32 位元組零填補收款地址建構 eth_getLogs 過濾器。在鏈允許的最大區塊區間(通常為 1,000 塊)內推進游標。詳見 Transfer 事件過濾指南(簡體中文) 與 游標輪詢指南(簡體中文)。

3. 確認深度後入帳

查詢至 safe_head = current_head - CONFIRMATION_DEPTH 以防範鏈重組風險。核驗 log.removed 不為 true,並在入帳前按 (transactionHash, logIndex) 複合鍵冪等去重。詳見 鏈重組處理指南(簡體中文) 與 去重指南(簡體中文)。

eth_getLogs 請求範例

與實戰指南保持一致的標準 JSON-RPC 請求:

curl -s -X POST https://api.blockvectra.com/v1/bsc_mainnet \
  -H "content-type: application/json" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "eth_getLogs",
    "params": [
      {
        "address": "0x55d398326f99059fF775485246999027B3197955",
        "fromBlock": "0x28a0000",
        "toBlock": "0x28a03e7",
        "topics": [
          "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
          null,
          "0x000000000000000000000000<your-receiving-address>"
        ]
      }
    ]
  }'

計費與價格規則

eth_getLogs 方法權重:30 CU(每 100 萬次請求 $3.00)。

被服務拒絕的請求(如超出單次區塊區間或觸上限額)不計費(billed: false)。詳見 計費規則指南(簡體中文),或查看 完整定價表。

開始接入收款監聽