ERPC

Bitcoin RPC endpoint documentatie | ERPC

Bitcoin RPC endpoint documentatie

Gebruik ERPC als uw Bitcoin RPC endpoint voor HTTP JSON-RPC-verzoeken. Bitcoin RPC maakt deel uit van de RPC APIs van ERPC binnen onze Global Edge Blockchain Infrastructure, en de API key kan worden beheerd via het ERPC Web Dashboard.
U kunt dezelfde RPC key als Solana, Ethereum en Avalanche gebruiken.
Geef uw API key mee in de queryparameter api-key, of stuur hem mee als Authorization: Bearer <YOUR_API_KEY>. Als beide aanwezig zijn, wordt de queryparameter gebruikt.

Endpoints

Verstuur JSON-RPC-verzoeken als HTTP POST naar:
text
https://edge.erpc.global/bitcoin?api-key=<YOUR_API_KEY>
of naar de dedicated host:
text
https://bitcoin.erpc.global?api-key=<YOUR_API_KEY>
Verzoeken worden alleen op / geaccepteerd.

Voorbeelden

Hier is een HTTP-verzoekvoorbeeld met de API key in de queryparameter.
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":[]
}'
Hier is hetzelfde verzoek met de API key in de Authorization-header.
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 accepteert jsonrpc met de waarde 1.0 of 2.0, of zonder dit veld, en elke aanroep heeft een id nodig.
U kunt uw API key verkrijgen en controleren in het ERPC Web Dashboard: ERPC Web Dashboard

Batch-verzoeken

JSON-RPC-batches van 1 tot 100 aanroepen per HTTP-verzoek worden ondersteund. Elke aanroep heeft een eigen id nodig, en id-waarden mogen binnen een batch niet herhaald worden. Elke aanroep in een batch wordt gemeten als een eigen aanroep. De request body mag maximaal 1 MiB groot zijn.

Tokengebruik

Het gebruik wordt gemeten in tokens, en het tokentarief kan per methode verschillen. Elke aanroep in een HTTP-batch wordt afzonderlijk gemeten.

Limieten van het Free-abonnement

Bij het Free-abonnement kan uw account één verzoek per 10 seconden versturen. De limiet wordt per account geteld, niet per endpoint, dus een verzoek naar een andere chain kan ook meetellen. Een verzoek dat sneller wordt verstuurd, wordt beantwoord met HTTP 429, en de retry-after-header geeft de wachttijd in seconden aan.
Bij het Free-abonnement wordt een verzoek met twee of meer JSON-RPC-aanroepen beantwoord met HTTP 429, en wordt geen van de aanroepen verzonden: elke aanroep krijgt een JSON-RPC-fout met code -32041. Verstuur deze aanroepen in plaats daarvan één voor één.

Ondersteunde methodes

Het endpoint bedient deze 32 Bitcoin Core JSON-RPC-methodes.
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
Een methode die niet in de lijst staat, wordt beantwoord met HTTP 400.

Antwoordstatuscodes

HTTP-statusBetekenis
200Upstream JSON-RPC-respons. Ook een JSON-RPC-fout wordt met HTTP 200 geretourneerd: de id van het verzoek en de error.code blijven behouden, de error.message is ERPC upstream error, en error.data wordt niet geretourneerd.
400Een methode of pad buiten de lijst met ondersteunde methodes, een ongeldig JSON-RPC-verzoek, een lege batch of een batch van meer dan 100 aanroepen, een dubbele id in een batch, of een body groter dan 1 MiB.
401Ontbrekende of ongeldige API key, of er wordt niet voldaan aan een IP- of Origin-beperking op de key.
405Een andere requestmethode dan POST.
426Er is een WebSocket Upgrade aangevraagd. Het endpoint ondersteunt alleen HTTP.
429Rate-limited, inclusief de hierboven genoemde limieten van het Free-abonnement: meer dan één verzoek per 10 seconden, of twee of meer aanroepen in één verzoek. Als er een retry-after-header aanwezig is, wacht dan het aangegeven aantal seconden.
502Het upstream-verzoek kon niet worden voltooid: een mislukte upstream-respons, een respons groter dan 8 MiB, of geen antwoord binnen 30 seconden.
503De service is tijdelijk niet beschikbaar.

Bitcoin RPC-methoden en documentatie

Voor de volledige lijst van standaardmethoden, parameters en specificaties verwijzen wij u naar de officiële documentatie.
https://developer.bitcoin.org/reference/rpc/

Vorige

Bitcoin RPC - Snelstart

Volgende

Hyperliquid RPC - Snelstart