ERPC

Documentazione dell'endpoint RPC di Bitcoin | ERPC

Documentazione dell'endpoint RPC di Bitcoin

Usa ERPC come tuo endpoint RPC di Bitcoin per richieste HTTP JSON-RPC. Bitcoin RPC fa parte delle RPC APIs di ERPC all'interno della nostra Global Edge Blockchain Infrastructure, e la chiave API può essere gestita dalla ERPC Web Dashboard.
Puoi usare la stessa chiave RPC di Solana, Ethereum e Avalanche.
Passa la tua chiave API nel parametro di query api-key, oppure inviala come Authorization: Bearer <YOUR_API_KEY>. Se sono presenti entrambi, viene usato il parametro di query.

Endpoint

Invia richieste JSON-RPC come HTTP POST a:
text
https://edge.erpc.global/bitcoin?api-key=<YOUR_API_KEY>
oppure all'host dedicato:
text
https://bitcoin.erpc.global?api-key=<YOUR_API_KEY>
Le richieste sono accettate solo su /.

Esempi

Ecco un esempio di richiesta HTTP con la chiave API nel parametro di query.
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":[]
}'
Ecco la stessa richiesta con la chiave API nell'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 accetta jsonrpc impostato a 1.0 o 2.0, oppure omesso, e ogni chiamata deve avere un id.
Puoi ottenere e verificare la tua chiave API sulla ERPC Web Dashboard: ERPC Web Dashboard

Richieste in batch

Sono supportati batch JSON-RPC da 1 a 100 chiamate per 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. Il corpo della richiesta può arrivare a 1 MiB.

Utilizzo dei token

L'utilizzo viene misurato in token, e la tariffa in token può variare in base al metodo. Ogni chiamata in un batch HTTP viene misurata separatamente.

Limiti del piano Free

Con il piano Free, il tuo account può inviare una richiesta ogni 10 secondi. Il limite viene conteggiato per account, non per endpoint, quindi anche una richiesta a un'altra chain può rientrare nel conteggio. Una richiesta inviata prima riceve una risposta HTTP 429, e l'header retry-after indica l'attesa in secondi.
Con il piano Free, una richiesta che contiene due o più chiamate JSON-RPC riceve una risposta HTTP 429, e nessuna delle sue chiamate viene inviata: ogni chiamata riceve un errore JSON-RPC con codice -32041. Invia invece queste chiamate una alla volta.

Metodi supportati

L'endpoint serve questi 32 metodi JSON-RPC di Bitcoin Core.
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
Un metodo non elencato riceve una risposta HTTP 400.

Codici di stato della risposta

Stato HTTPSignificato
200Risposta JSON-RPC upstream. Anche un errore JSON-RPC viene restituito con HTTP 200: mantiene l'id della richiesta e l'error.code, il suo error.message è ERPC upstream error, e error.data non viene restituito.
400Un metodo o un percorso al di fuori dell'elenco dei metodi supportati, una richiesta JSON-RPC non valida, un batch vuoto o con più di 100 chiamate, un id duplicato in un batch, o un corpo superiore a 1 MiB.
401Chiave API mancante o non valida, oppure non è soddisfatta una restrizione di IP o di Origin impostata sulla chiave.
405Un metodo di richiesta diverso da POST.
426È stato richiesto un WebSocket Upgrade. L'endpoint supporta solo HTTP.
429Rate limitato, compresi i limiti del piano Free indicati sopra: più di una richiesta ogni 10 secondi, oppure due o più chiamate in una richiesta. Se è presente un header retry-after, attendi il numero di secondi indicato.
502La richiesta upstream non è stata completata: una risposta upstream non riuscita, una risposta superiore a 8 MiB, o nessuna risposta entro 30 secondi.
503Il servizio è temporaneamente non disponibile.

Metodi RPC di Bitcoin e documentazione

Per l'elenco completo dei metodi standard, dei parametri e delle specifiche, consulta la documentazione ufficiale.
https://developer.bitcoin.org/reference/rpc/

Precedente

Bitcoin RPC - Guida rapida

Successivo

Hyperliquid RPC - Guida rapida