ERPC

Dokumentasi Bitcoin RPC Endpoint | ERPC

Dokumentasi Bitcoin RPC Endpoint

Gunakan ERPC sebagai endpoint RPC Bitcoin Anda untuk HTTP JSON-RPC request. Bitcoin RPC adalah bagian dari RPC APIs ERPC di dalam Global Edge Blockchain Infrastructure kami, dan API key dapat dikelola dari ERPC Web Dashboard.
Anda dapat menggunakan RPC key yang sama dengan Solana, Ethereum, dan Avalanche.
Kirim API key Anda di query parameter api-key, atau kirim sebagai Authorization: Bearer <YOUR_API_KEY>. Jika keduanya ada, yang digunakan adalah query parameter.

Endpoint

Kirim request JSON-RPC sebagai HTTP POST ke:
text
https://edge.erpc.global/bitcoin?api-key=<YOUR_API_KEY>
atau ke host khusus:
text
https://bitcoin.erpc.global?api-key=<YOUR_API_KEY>
Request hanya diterima di /.

Contoh

Berikut adalah contoh HTTP request dengan API key di query parameter.
bash
curl 'https://edge.erpc.global/bitcoin?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
  "jsonrpc":"1.0","id":1,
  "method":"getblockcount",
  "params":[]
}'
Berikut adalah request yang sama dengan API key di header Authorization.
bash
curl 'https://edge.erpc.global/bitcoin' --header 'Content-Type: application/json' --header 'Authorization: Bearer <YOUR_API_KEY>' --data '{
  "jsonrpc":"1.0","id":1,
  "method":"getblockcount",
  "params":[]
}'
Bitcoin menerima jsonrpc bernilai 1.0 atau 2.0, atau tanpa jsonrpc sama sekali, dan setiap panggilan memerlukan id.
Anda dapat membuat dan memeriksa API key Anda di ERPC Web Dashboard: ERPC Web Dashboard

Batch Request

JSON-RPC batch berisi 1 hingga 100 panggilan per HTTP request didukung. Setiap panggilan memerlukan id sendiri, dan nilai id tidak boleh berulang dalam satu batch. Setiap panggilan dalam satu batch diukur sebagai panggilan tersendiri. Body request maksimal 1 MiB.

Pengukuran Penggunaan

Penggunaan diukur dalam token, dan tarif token dapat berbeda per method. Setiap panggilan dalam satu HTTP batch diukur secara terpisah.

Batas Paket Free

Pada Paket Free, akun Anda dapat mengirim satu request per 10 detik. Batas ini dihitung per akun, bukan per endpoint, sehingga request ke chain lain juga dapat dihitung ke dalam batas tersebut. Request yang dikirim lebih cepat dijawab dengan HTTP 429, dan header retry-after memberikan waktu tunggu dalam detik.
Pada Paket Free, request yang membawa dua panggilan JSON-RPC atau lebih dijawab dengan HTTP 429, dan tidak ada satu pun panggilannya yang dikirim: setiap panggilan mendapat error JSON-RPC dengan kode -32041. Kirim panggilan-panggilan ini satu per satu.

Method yang Didukung

Endpoint ini melayani 32 method JSON-RPC Bitcoin Core berikut.
decoderawtransaction, decodescript, estimatesmartfee, getbestblockhash, getblock, getblockchaininfo, getblockcount, getblockfilter, getblockhash, getblockheader, getblockstats, getchaintips, getchaintxstats, getconnectioncount, getdifficulty, getmempoolancestors, getmempooldescendants, getmempoolinfo, getmininginfo, getnetworkinfo, getrawmempool, getrawtransaction, gettransaction, gettxout, gettxoutproof, gettxoutsetinfo, sendrawtransaction, testmempoolaccept, validateaddress, verifychain, verifymessage, verifytxoutproof
Method yang tidak tercantum dijawab dengan HTTP 400.

Kode Status Response

HTTP statusArti
200Response JSON-RPC dari upstream. Error JSON-RPC juga dikembalikan dengan HTTP 200: id request dan error.code tetap dipertahankan, error.message berisi ERPC upstream error, dan error.data tidak dikembalikan.
400Method atau path di luar daftar Method yang Didukung, request JSON-RPC tidak valid, batch kosong atau batch lebih dari 100 panggilan, id duplikat dalam satu batch, atau body lebih dari 1 MiB.
401API key tidak ada atau tidak valid, atau pembatasan IP atau Origin pada key tidak terpenuhi.
405Request dengan method HTTP selain POST.
426WebSocket Upgrade diminta. Endpoint ini hanya mendukung HTTP.
429Dibatasi rate, termasuk batas Paket Free di atas: lebih dari satu request per 10 detik, atau dua panggilan atau lebih dalam satu request. Jika ada header retry-after, tunggu selama jumlah detik yang disebutkan.
502Request upstream tidak dapat diselesaikan: response upstream gagal, response lebih dari 8 MiB, atau tidak ada jawaban dalam 30 detik.
503Layanan tidak tersedia sementara.

Metode dan Dokumentasi Bitcoin RPC

Untuk daftar lengkap metode standar, parameter, dan spesifikasi, lihat dokumentasi resmi.
https://developer.bitcoin.org/reference/rpc/

Sebelumnya

Bitcoin RPC Quickstart | ERPC

Berikutnya

Hyperliquid RPC Quickstart | ERPC