Bitcoin RPC - Quickstart

Bitcoin RPC - Quickstart

Esta guía te lleva de cero a tu primera respuesta Bitcoin JSON-RPC con ERPC.

1. Obtén tu API key

Puedes obtener y comprobar tu API key en ERPC Web Dashboard: ERPC Web Dashboard
¿Ya usas ERPC para Solana, Ethereum o Avalanche? Puedes usar la misma RPC key.

2. Realiza tu primera solicitud

Envía una solicitud JSON-RPC como HTTP POST, con tu API key en el parámetro 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 respuesta devuelve el número actual de bloques en el campo result.
Bitcoin acepta jsonrpc con el valor 1.0 o 2.0, o sin indicarlo, y cada llamada necesita un id.
En el Plan Free, tu cuenta puede enviar una solicitud cada 10 segundos, y una solicitud a otra chain también puede contar para este límite. Espera 10 segundos antes de enviar la siguiente solicitud.
Puedes comprobar qué chain sirve el 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":[]
}'
También puedes enviar tu API key como Authorization: Bearer <YOUR_API_KEY>. Si están presentes ambos, se usa el parámetro de consulta.

3. Solicitudes por lotes

Puedes enviar de 1 a 100 llamadas JSON-RPC en una sola solicitud HTTP. Cada llamada necesita su propio id, y los valores de id no deben repetirse dentro de un lote. Cada llamada en un lote se mide como una llamada individual. En el Plan Free, envía una llamada por solicitud: una solicitud con dos o más llamadas se responde con HTTP 429.

Próximos pasos