監控 USDT / USDC 充值與出款
監控受支援的 USDT 與 USDC 轉帳,用於充值核驗、商戶通知和出款追蹤;通知本身不證明最終結算。
適用於開發者與 AI Agent。先準備 API key 與自有 HTTPS 接收端,在應用程式中篩選代幣合約與金額。
基礎轉帳監控已可用金額與代幣篩選在你的接收端執行。服務端條件、多階段確認與 IM 提醒即將推出。
開始前的準備
開發者與 AI Agent 使用同一套接入流程。 安全設置 BLOCKVECTRA_API_KEY,安裝 curl 和 jq。從下方任務支持範圍選擇 CHAIN,核驗該鏈代幣合約、收款方及最小單位的整數金額。Push 需要自有 HTTPS 接收端與 443 端口;創建訂閱前核對認證鏈目錄、確認數範圍和 halted 狀態。
檢視程式化建立帳戶指南 →交易所充值核驗
輪詢充值地址的 ERC-20 Transfer 日誌。按可信收款配置設置 TOKEN_CONTRACT 和 RECIPIENT;FROM_BLOCK 與 TO_BLOCK 使用十六進制塊高,範圍須在節點覆蓋與公開區間上限內。每段處理完成後再持久化推進游標。
支持的鏈
set -euo pipefail
: "${BLOCKVECTRA_API_KEY:?}" "${CHAIN:?}" "${TOKEN_CONTRACT:?}" "${RECIPIENT:?}"
: "${FROM_BLOCK:?}" "${TO_BLOCK:?}"
TOPIC_TO="0x000000000000000000000000${RECIPIENT#0x}"
jq -n --arg token "$TOKEN_CONTRACT" --arg to "$TOPIC_TO" \
--arg from "$FROM_BLOCK" --arg end "$TO_BLOCK" \
'{jsonrpc:"2.0",id:1,method:"eth_getLogs",params:[{address:$token,
fromBlock:$from,toBlock:$end,topics:[
"0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",null,$to]}]}' |
curl --fail-with-body -sS "https://api.blockvectra.com/v1/$CHAIN" \
-H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' --data-binary @-需要核驗的結果
核對合約、收款方與整數金額,核驗 receipt 和業務確認策略後再入賬。按鏈、transactionHash 與 logIndex 去重,保留 blockHash 用於重組核對。
閱讀完整指南商戶收款通知
設置 RECIPIENT 與 RECEIVER_URL,按鏈默認確認數創建基礎地址訂閱。安全保存返回的 secret;等 applied_version >= change_version 並記錄 applied_from_block 後,再等待匹配活動。
支持的鏈
- Arbitrum One — 目前可執行
- Base — 目前可執行
- BNB Smart Chain — 目前可執行
- Ethereum — 目前可執行
- Ethereum Sepolia — 目前可執行
- HyperEVM — 目前可執行
- Polygon — 目前可執行
- Robinhood Chain — 目前可執行
- Robinhood Chain Testnet — 目前可執行
此範例的 CHAIN 請選擇下列目前可執行的鏈
set -euo pipefail
umask 077
: "${BLOCKVECTRA_API_KEY:?}" "${CHAIN:?}" "${RECIPIENT:?}" "${RECEIVER_URL:?}"
PUSH_URL='https://api.blockvectra.com/v1/push'
curl --fail-with-body -sS "$PUSH_URL/chains" \
-H "x-api-key: $BLOCKVECTRA_API_KEY" > push-chains.json
jq -e --arg chain "$CHAIN" 'any(.chains[]; .chain == $chain and .halted == false)' push-chains.json
jq -n --arg url "$RECEIVER_URL" --arg chain "$CHAIN" \
'{url: $url, chains: {($chain): {}}}' > create.json
curl --fail-with-body -sS "$PUSH_URL/subscriptions" \
-H "x-api-key: $BLOCKVECTRA_API_KEY" \
-H 'Content-Type: application/json' -d @create.json > subscription.json
SUBSCRIPTION_ID=$(jq -er '.id' subscription.json)
jq -n --arg recipient "$RECIPIENT" '{addresses: [$recipient]}' > addresses.json
curl --fail-with-body -sS "$PUSH_URL/subscriptions/$SUBSCRIPTION_ID/addresses/add" \
-H "x-api-key: $BLOCKVECTRA_API_KEY" \
-H 'Content-Type: application/json' -d @addresses.json > address-change.json
curl --fail-with-body -sS "$PUSH_URL/subscriptions/$SUBSCRIPTION_ID" \
-H "x-api-key: $BLOCKVECTRA_API_KEY"需要核驗的結果
首個匹配事件須完成原始 body 驗籤、代幣/收款方/整數金額核對、按事件 id 持久化去重,並由接收端返回 2xx。訂閱 HTTP 201 不代表已收到收款通知。
閱讀完整指南出款追蹤
把 TX_HASH 設置為支付系統已提交的交易。用 JSON-RPC 查詢 receipt,比較 receipt.blockNumber 與當前塊高,並核對預期代幣轉賬日誌。
支持的鏈
set -euo pipefail
: "${BLOCKVECTRA_API_KEY:?}" "${CHAIN:?}" "${TX_HASH:?}"
jq -n --arg hash "$TX_HASH" \
'{jsonrpc:"2.0",id:1,method:"eth_getTransactionReceipt",params:[$hash]}' |
curl --fail-with-body -sS "https://api.blockvectra.com/v1/$CHAIN" \
-H "x-api-key: $BLOCKVECTRA_API_KEY" -H 'Content-Type: application/json' --data-binary @-需要核驗的結果
receipt 為 null 或交易處於 pending 都不代表到賬。核驗 receipt.status、代幣合約、收款方、整數金額及業務確認策略;成功 receipt 本身不能證明預期轉賬發生。
閱讀完整指南確認與覆蓋邊界
N 個確認不是鏈上終局。基礎 Push 沒有服務端金額或代幣過濾,須在接收端篩選;不覆蓋合約內部原生幣轉賬。Pending 不是到賬。收到 chain.reorg 時核對被替換區塊,冪等處理規範鏈的替代事件。 部分鏈的系統交易不在覆蓋範圍,見對應鏈頁。
恢復缺口與核對歷史
Replay 只重投保留的匹配事件,不補訂閱或地址生效前歷史。更早區間與缺口用有界 RPC 輪詢恢復;維護每條鏈的游標,按完整指南處理重組。
支持的鏈
可選:查詢下列鏈的索引 ERC-20 轉賬。FROM_BLOCK 與 TO_BLOCK 使用索引覆蓋內的十進制塊高;核對新鮮度與覆蓋,沿 next_cursor 翻頁直至字段缺省。逐筆核驗代幣合約、收款方和整數金額;索引數據不證明終局。
支持的鏈
: "${BLOCKVECTRA_API_KEY:?}" "${CHAIN:?}" "${RECIPIENT:?}" "${FROM_BLOCK:?}" "${TO_BLOCK:?}"
curl --fail-with-body -sS --get \
"https://api.blockvectra.com/v1/data/$CHAIN/addresses/$RECIPIENT/transfers" \
-H "x-api-key: $BLOCKVECTRA_API_KEY" \
--data-urlencode 'standard=erc20' --data-urlencode 'direction=in' \
--data-urlencode "from_block=$FROM_BLOCK" --data-urlencode "to_block=$TO_BLOCK"計費與價格規則
eth_getLogs 方法權重:30 CU(每 100 萬次請求 $3.00)。
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 |