eth_getLogs vs Token Transfers API: riwayat transfer ERC-20

Untuk riwayat dompet atau rekonsiliasi transfer ERC-20, mulailah dengan Token Transfers API. Gunakan eth_getLogs saat Anda membutuhkan log peristiwa kontrak. Pengembang dan agen AI dapat mengueri transfer alamat terindeks melalui API data blockchain yang sama. Panduan aset dompet menggabungkan saldo token, riwayat transfer, dan metadata; referensi Data API mendefinisikan parameter permintaan dan skema respons.

Tugas yang dibantu panduan ini

• Kueri log peristiwa kontrak melalui RPC terautentikasi dalam rentang blok terbatas untuk pemantauan atau backfill log.
• Kueri riwayat transfer ERC-20 terindeks melalui API data blockchain berdasarkan alamat atau kontrak token, dengan paginasi kursor dan pemeriksaan cakupan.

Dua cara membaca log dan transfer

eth_getLogs adalah metode JSON-RPC: metode ini mengembalikan log blok melalui endpoint JSON-RPC. Data API mengekspos riwayat transfer token melalui dua endpoint dengan cakupan rantai:

• GET /{chain}/addresses/{address}/transfers — transfer yang melibatkan suatu alamat.
• GET /{chain}/tokens/{token}/transfers — transfer untuk satu kontrak token.

Keduanya menggunakan API key yang sama dan diukur dalam CU berdasarkan bobot metode (lihat bobot di bawah). Mana yang sesuai bergantung pada seberapa baru datanya, apakah Anda memerlukan jendela blok, dan bagaimana Anda melakukan paginasi.

Batas yang berlaku untuk eth_getLogs

eth_getLogs dibatasi oleh batas per-rantai yang dipublikasikan respons publik GET /v1/chains:

• Rentang blok: max_logs_block_range adalah jumlah maksimum blok yang dapat dicakup oleh satu permintaan eth_getLogs. Batas ini berbeda menurut rantai — baca dari GET /v1/chains (rantai tercantum di Rantai yang Didukung) alih-alih melakukan hardcoding. Rentang yang lebih lebar ditolak dengan error JSON-RPC -32602 eth_getLogs block range too large (tidak ditagih).
• Sinkronisasi node: selama node rantai belum tersinkronisasi, eth_getLogs mengembalikan -32010 (tidak ditagih).
• Jendela status: jendela status yang dilaporkan GET /v1/chains sebagai state_window_blocks berlaku untuk metode pembacaan status seperti eth_call dan eth_getBalance, bukan untuk eth_getLogs.
• Pemangkasan node (pruning): pembacaan blok dan log tidak dibatasi oleh jendela status, tetapi dibatasi oleh riwayat yang dipertahankan oleh node. Data yang telah dipangkas mengembalikan 4444 pruned history unavailable (tidak ditagih).

Ketika bidang filter fromBlock dan toBlock dihilangkan atau null, bidang tersebut default ke latest.

Memanggil eth_subscribe melalui HTTP mengembalikan -32601 method not available. Pada rantai di mana ws bernilai true di /v1/chains, eth_subscribe tersedia melalui WebSocket (lihat Rantai yang Didukung); jika tidak, lakukan polling eth_getLogs pada blok-blok terbaru.

Apa yang disediakan oleh endpoint transfer Data API

Kedua endpoint memerlukan parameter yang berbeda:

Paginasi

Kedua endpoint menggunakan paginasi berbasis keyset:

• limit default ke 50; nilai di atas 500 dibatasi (clamp) ke 500, dan 0 atau non-integer mengembalikan 400 bad_request.
• next_cursor hanya muncul jika ada halaman lain. Pada halaman terakhir, kuncinya sama sekali tidak ada, tidak pernah null.
• Teruskan nilai yang dikembalikan kembali sebagai cursor, tanpa perubahan, untuk mengambil halaman berikutnya. Kursor hanya valid untuk rantai, endpoint, dan parameter kueri yang menerbitkannya.

Cakupan dan finalitas

Transfer Data API mengindeks transfer token historis dari coverage.from_block setiap rantai hingga meta.as_of_block. Lihat Rantai yang Didukung untuk mengetahui rantai mana saja yang menyediakannya.

Setiap item transfer berisi token, standard, from, to, block_number, block_timestamp, tx_hash, tx_index, dan log_index. Item ERC-20 menambahkan amount; item ERC-721 menambahkan token_id; item ERC-1155 menambahkan operator, token_id, value, dan batch_index.

Mana yang harus digunakan

Mengueri log dengan eth_getLogs

export BLOCKVECTRA_API_KEY=rgw_your_api_key

# fromBlock / toBlock default to latest. Set an explicit recent range to follow
# new events, and keep its span within the chain's max_logs_block_range.
curl -s "https://api.blockvectra.com/v1/robinhood_mainnet" \
  -H 'Content-Type: application/json' \
  -H "x-api-key: $BLOCKVECTRA_API_KEY" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "eth_getLogs",
    "params": [{
      "address": "0x1111111111111111111111111111111111111111",
      "fromBlock": "latest",
      "toBlock": "latest"
    }]
  }'

Mengueri transfer dengan Data API

export BLOCKVECTRA_API_KEY=rgw_your_api_key

# from_block / to_block are optional here; omitting to_block defaults to as_of_block.
curl -s "https://api.blockvectra.com/v1/data/robinhood_mainnet/tokens/0x1111111111111111111111111111111111111111/transfers?standard=erc20" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY"

Untuk mengueri berdasarkan alamat sebagai gantinya, from_block dan to_block diperlukan:

# clamp=true truncates a too-wide window, or a to_block above as_of_block,
# instead of returning 409.
curl -s "https://api.blockvectra.com/v1/data/robinhood_mainnet/addresses/0x1111111111111111111111111111111111111111/transfers?standard=erc20&from_block=0&to_block=73000000&direction=any&clamp=true" \
  -H "x-api-key: $BLOCKVECTRA_API_KEY"

CU per panggilan

Setiap metode ditagih berdasarkan bobot CU-nya. Bobot di bawah ini dibaca dari API rencana platform:

Untuk harga terkini dan opsi top-up, lihat halaman Harga.

Langkah selanjutnya

• Telusuri direktori dataset untuk melihat setiap dataset yang diindeks oleh BlockVectra.
• Lihat paket gratis dan harga untuk memeriksa apa yang termasuk dalam akun Anda.
• Masuk ke konsol untuk membuat API key.