Base RPC - Quickstart

Base RPC - Quickstart

Esta guía te lleva de cero a tu primera respuesta Base 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 2.0 como HTTP POST, con tu API key en el parámetro api-key:
bash
curl 'https://base.erpc.global?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"eth_blockNumber"
}'
La respuesta devuelve el último número de bloque en hexadecimal:
json
{ "jsonrpc": "2.0", "id": 1, "result": "0x..." }
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 eth_chainId:
bash
curl 'https://base.erpc.global?api-key=<YOUR_API_KEY>' --header 'Content-Type: application/json' --data '{
  "jsonrpc":"2.0","id":1,
  "method":"eth_chainId"
}'

3. Suscríbete por WebSocket

Para suscripciones, conéctate por WebSocket a:
text
wss://base.erpc.global?api-key=<YOUR_API_KEY>
Para los tipos de suscripción disponibles, consulta la documentación oficial de Base enlazada abajo. En el Plan Free, las conexiones WebSocket no están disponibles y se responden con HTTP 403.

4. Solicitudes por lotes

Puedes enviar hasta 256 llamadas JSON-RPC en una sola solicitud HTTP. 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