Pantau Deposit dan Pembayaran USDT / USDC
Pantau transfer USDT dan USDC yang didukung untuk deposit, notifikasi pedagang, dan pembayaran keluar; notifikasi saja tidak membuktikan penyelesaian akhir.
Untuk pengembang dan AI Agent. Mulai dengan kunci API dan penerima HTTPS Anda; saring kontrak token dan jumlah di aplikasi Anda.
Pemantauan transfer dasar tersediaPenyaringan jumlah dan token dilakukan di penerima Anda. Kondisi sisi server, konfirmasi beberapa tahap, dan peringatan IM akan segera tersedia.
Sebelum memulai
Pengembang dan AI Agent mengikuti alur integrasi yang sama. Atur BLOCKVECTRA_API_KEY dengan aman dan pasang curl serta jq. Pilih CHAIN dari cakupan di bawah; verifikasi kontrak token, penerima, dan jumlah bilangan bulat dalam unit terkecil. Push memerlukan penerima HTTPS milik Anda pada port 443. Sebelum membuat langganan, periksa daftar chain terautentikasi, rentang konfirmasi, dan status halted.
Lihat panduan pendaftaran terprogram →Verifikasi deposit bursa
Polling log ERC-20 Transfer untuk alamat deposit. Atur TOKEN_CONTRACT dan RECIPIENT dari konfigurasi tepercaya; FROM_BLOCK dan TO_BLOCK adalah tinggi blok heksadesimal dalam cakupan node dan batas rentang yang dipublikasikan. Majukan kursor persisten hanya setelah memproses tiap rentang.
Chain yang didukung
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 @-Hasil yang perlu diverifikasi
Cocokkan kontrak, penerima, dan jumlah bilangan bulat; periksa receipt serta kebijakan konfirmasi sebelum mengkreditkan. Deduplicasi berdasarkan chain, transactionHash, dan logIndex; simpan blockHash untuk rekonsiliasi reorganisasi.
Baca panduan lengkapTerima notifikasi pembayaran pedagang
Atur RECIPIENT dan RECEIVER_URL, lalu buat langganan alamat dasar dengan konfirmasi bawaan chain. Simpan secret dengan aman. Tunggu applied_version >= change_version dan catat applied_from_block sebelum mengharapkan aktivitas yang cocok.
Chain yang didukung
- Arbitrum One — Dapat dijalankan saat ini
- Base — Dapat dijalankan saat ini
- BNB Smart Chain — Dapat dijalankan saat ini
- Ethereum — Dapat dijalankan saat ini
- Ethereum Sepolia — Dapat dijalankan saat ini
- HyperEVM — Dapat dijalankan saat ini
- Polygon — Dapat dijalankan saat ini
- Robinhood Chain — Dapat dijalankan saat ini
- Robinhood Chain Testnet — Dapat dijalankan saat ini
Pilih CHAIN untuk contoh ini dari chain yang saat ini dapat dijalankan di bawah
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"Hasil yang perlu diverifikasi
Peristiwa cocok pertama selesai setelah verifikasi tanda tangan body asli, pemeriksaan token/penerima/jumlah bilangan bulat, deduplikasi persisten berdasarkan id, dan respons 2xx penerima. HTTP 201 langganan bukan notifikasi pembayaran yang telah diterima.
Baca panduan lengkapLacak pembayaran keluar
Atur TX_HASH ke transaksi yang sudah dikirim sistem pembayaran. Baca receipt lewat JSON-RPC, bandingkan receipt.blockNumber dengan head saat ini, dan cocokkan log transfer token yang diharapkan.
Chain yang didukung
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 @-Hasil yang perlu diverifikasi
receipt null atau transaksi pending bukan pembayaran diterima. Periksa receipt.status, kontrak token, penerima, jumlah bilangan bulat, serta kebijakan konfirmasi. receipt sukses saja tidak membuktikan transfer yang diharapkan.
Baca panduan lengkapBatas konfirmasi dan cakupan
N konfirmasi bukan finalitas chain. Push dasar tidak memiliki filter jumlah atau token di server; filter di penerima. Transfer koin native internal kontrak tidak tercakup. Pending bukan pembayaran diterima. Rekonsiliasi blok yang diganti pada chain.reorg dan proses pengganti kanonis secara idempoten. Beberapa chain tidak mencakup transaksi sistem; lihat halaman chain terkait.
Pulihkan celah dan rekonsiliasi riwayat
Replay hanya mengirim ulang kecocokan yang tersimpan; tidak memulihkan riwayat sebelum langganan atau alamat aktif. Gunakan polling RPC berbatas untuk interval sebelumnya atau celah. Simpan kursor per chain dan rekonsiliasi reorganisasi dengan panduan lengkap.
Chain yang didukung
Opsional, kueri transfer ERC-20 terindeks pada chain berikut. FROM_BLOCK dan TO_BLOCK adalah tinggi blok desimal dalam cakupan indeks. Periksa kebaruan dan cakupan; ikuti next_cursor hingga tidak ada. Verifikasi kontrak, penerima, dan jumlah bilangan bulat; data indeks bukan bukti finalitas.
Chain yang didukung
: "${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"Harga & Aturan Penagihan
Bobot metode eth_getLogs: 30 CU ($3.00 per 1,000,000 permintaan).
Permintaan yang ditolak oleh layanan (seperti rentang blok berlebih atau batas laju) tidak ditagih. Lihat panduan aturan penagihan atau tabel harga lengkap.
Push webhook
Bobot CU dari GET /v1/plans. Percobaan ulang otomatis gratis.
Alamat gratis per akun per hari UTC: 1000
Kuota alamat gratis per akun per hari UTC dibagikan oleh semua grup langganan, terlepas dari paketnya. Untuk setiap grup, hitung jumlah alamat maksimum selama online pada hari tersebut; alokasikan kuota menurut ID grup secara menaik. Alamat yang sama dalam dua grup dihitung dua kali; jumlah chain dalam grup tidak melipatgandakan jumlah alamatnya. Grup yang offline atau dihapus sepanjang hari tidak menambah hitungan. Untuk setiap grup, jumlah yang tersisa setelah dikurangi bagiannya dari kuota dikalikan dengan bobot CU `push.address_day` dalam `method_weights`. Kuota yang dikonfigurasi saat ini berasal dari kebijakan harga yang sama dengan biaya alamat-hari; ini bukan batas kapasitas akun atau kuota terpisah per grup.
| Metode | Unit penagihan | CU |
|---|---|---|
| push.address_day | Hari alamat yang ditagih | 33 |
| push.history | Permintaan riwayat berhasil | 25 |
| push.log | Peristiwa data terkirim | 150 |
| push.native_transfer | Peristiwa data terkirim | 150 |
| push.token_transfer | Peristiwa data terkirim | 150 |