使用 JSON-RPC 監聽 USDT / USDC 收款
用 BlockVectra 的 JSON-RPC 監聽 USDT / USDC 到帳(透過 eth_getLogs 輪詢;支援 WebSocket 的鏈也可以訂閱)。
支援的鏈
各鏈能力以 GET /v1/chains 為準。
| 鏈 | 支援的接收機制 |
|---|---|
| Arbitrum One | HTTP 輪詢 (eth_getLogs) |
| Base | HTTP 輪詢 (eth_getLogs) |
| BNB Smart Chain | HTTP 輪詢 (eth_getLogs) |
| Ethereum | HTTP 輪詢 (eth_getLogs) |
| HyperEVM | HTTP 輪詢 (eth_getLogs) |
| Polygon | HTTP 輪詢 (eth_getLogs) |
| Robinhood Chain | HTTP 輪詢與 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)。詳見 計費規則指南(簡體中文),或查看 完整定價表。