Bitcoin RPC - Guida rapida

Bitcoin RPC - Guida rapida

Questa guida ti accompagna da zero alla tua prima risposta Bitcoin JSON-RPC con ERPC.

1. Ottieni la tua chiave API

Puoi ottenere e verificare la tua chiave API sulla ERPC Web Dashboard: ERPC Web Dashboard
Usi già ERPC per Solana, Ethereum o Avalanche? Puoi usare la stessa chiave RPC.

2. Effettua la tua prima richiesta

Invia una richiesta JSON-RPC come HTTP POST, con la tua chiave API nel parametro api-key:
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":[]
}'
La risposta restituisce il numero attuale di blocchi nel campo result.
Bitcoin accetta jsonrpc impostato a 1.0 o 2.0, oppure omesso, e ogni chiamata deve avere un id.
Con il piano Free, il tuo account può inviare una richiesta ogni 10 secondi, e anche una richiesta a un'altra chain può rientrare in questo limite. Attendi 10 secondi prima di inviare la richiesta successiva.
Puoi verificare quale chain serve l'endpoint con getblockchaininfo:
bash
curl 'https://edge.erpc.global/bitcoin?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
  "jsonrpc":"1.0","id":1,
  "method":"getblockchaininfo",
  "params":[]
}'
Puoi anche inviare la tua chiave API come Authorization: Bearer <YOUR_API_KEY>. Se sono presenti entrambi, viene usato il parametro di query.

3. Richieste in batch

Puoi inviare da 1 a 100 chiamate JSON-RPC in un'unica richiesta HTTP. Ogni chiamata deve avere un proprio id, e i valori di id non devono ripetersi all'interno di un batch. Ogni chiamata in un batch viene misurata come chiamata a sé stante. Con il piano Free, invia una chiamata per richiesta: una richiesta con due o più chiamate riceve una risposta HTTP 429.

Prossimi passi