> For the complete documentation index, see [llms.txt](https://docs.getblock.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.getblock.io/rpc-endpoint/how-to-get-an-ethereum-rpc-endpoint.md). # How to Get an Ethereum RPC Endpoint Step-by-step guide to getting a fast, reliable Ethereum RPC endpoint. Set up free or production-grade ETH RPC access with GetBlock in under 2 minutes. An Ethereum RPC (Remote Procedure Call) endpoint is a URL that your application uses to send requests to an Ethereum node. When your dApp needs to: * Check a wallet balance (`eth_getBalance`) * Read a smart contract (`eth_call`) * Send a transaction (`eth_sendRawTransaction`) * Get block data (`eth_getBlockByNumber`) * Fetch transaction receipts (`eth_getTransactionReceipt`) It sends a JSON-RPC request to an Ethereum node through an RPC endpoint. The node processes the request and returns the data. **For example:** {% tabs %} {% tab title="Request" %} {% code overflow="wrap" %} ```json { "jsonrpc": "2.0", "method": "eth_blockNumber", "params": [], "id": "getblock.io" } ``` {% endcode %} {% endtab %} {% tab title="Response" %} {% code overflow="wrap" %} ```json { "jsonrpc": "2.0", "id": "getblock.io", "result": "0x134A5B2" } // The result field contains the latest block number in hexadecimal. ``` {% endcode %} {% endtab %} {% endtabs %} ### Step-by-Step: Get Your Ethereum RPC Endpoint {% stepper %} {% step %} #### Create a GetBlock Account Go to [GetBlock Dashboard](https://account.getblock.io) and sign up. You can register with email or via Google/GitHub OAuth. {% endstep %} {% step %} #### Create an Ethereum Endpoint Once logged in: 1. Click **"Shared Nodes"** in the left sidebar 2. Click **"Create New Endpoint"** or the **"+"** button
3. Configure your endpoint: * **Protocol:** Ethereum (ETH) * **Network:** Mainnet (or Sepolia/Holesky for testing) * **API Interface:** JSON-RPC (most common), WebSocket, or Beacon API * **Region:** Choose the closest — Frankfurt (EU), New York (US), or Singapore (APAC)
4. Click **"Create":** Your endpoint URL will be generated immediately. {% endstep %} {% step %} #### Copy Your Endpoint URL Your endpoint URL looks like this: ``` https://shared..getblock.io/a1b2c3d4e5f6789012345678abcdef01/ ``` {% hint style="warning" %} `` is `eu-central-1` (Frankfurt), `us-east-1` (New York), or `ap-southeast-1` (Singapore) — whichever you picked in step 2. The long string after the host is your **access token** — keep it private. {% endhint %} {% endstep %} {% step %} #### Test the Connection {% tabs %} {% tab title="cURL" %} ```bash curl -X POST https://shared.eu-central-1.getblock.io// \ -H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "method": "eth_blockNumber", "params": [], "id": "getblock.io" }' ``` {% endtab %} {% tab title="Response" %} ```json { "jsonrpc": "2.0", "id": "getblock.io", "result": "0x134A5B2" } // The result field contains the latest block number in hexadecimal. ``` {% endtab %} {% endtabs %} {% endstep %} {% endstepper %} ### Using Your Endpoint with Popular Libraries {% tabs %} {% tab title="ethers.js (v6)" %} {% code overflow="wrap" %} ```javascript import { JsonRpcProvider } from "ethers"; const provider = new JsonRpcProvider( "https://shared.eu-central-1.getblock.io//" ); // Get latest block number const blockNumber = await provider.getBlockNumber(); console.log("Latest block:", blockNumber); // Get ETH balance const balance = await provider.getBalance("0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"); console.log("Balance:", balance.toString(), "wei"); ``` {% endcode %} {% endtab %} {% tab title="Python (web3.py)" %} ```python from web3 import Web3 w3 = Web3(Web3.HTTPProvider("https://shared.eu-central-1.getblock.io//")) # Check connection print("Connected:", w3.is_connected()) # Get latest block block_number = w3.eth.block_number print(f"Latest block: {block_number}") # Get balance balance = w3.eth.get_balance("0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045") print(f"Balance: {w3.from_wei(balance, 'ether')} ETH") ``` {% endtab %} {% tab title="Python (requests — no SDK needed)" %} ```python import requests url = "https://shared.eu-central-1.getblock.io//" headers = {"Content-Type": "application/json"} # Get gas price payload = { "jsonrpc": "2.0", "method": "eth_gasPrice", "params": [], "id": "getblock.io" } response = requests.post(url, headers=headers, json=payload) gas_price = int(response.json()["result"], 16) print(f"Gas price: {gas_price / 1e9:.2f} Gwei") ``` {% endtab %} {% endtabs %} ### WebSocket Endpoint for Real-Time Data For real-time events (new blocks, pending transactions, log subscriptions), use a WebSocket connection: **WebSocket endpoint format:** ``` wss://shared..getblock.io// ``` #### Subscribe to new blocks {% tabs %} {% tab title="ethers.js" %} ```javascript import { WebSocketProvider } from "ethers"; const provider = new WebSocketProvider( "wss://shared.eu-central-1.getblock.io//" ); provider.on("block", (blockNumber) => { console.log("New block:", blockNumber); }); ``` {% endtab %} {% tab title="Python" %} ```python import asyncio import websockets import json async def listen_blocks(): uri = "wss://shared.eu-central-1.getblock.io//" async with websockets.connect(uri) as ws: # Subscribe to new block headers await ws.send(json.dumps({ "jsonrpc": "2.0", "method": "eth_subscribe", "params": ["newHeads"], "id": 1 })) print("Subscribed to new blocks") while True: response = json.loads(await ws.recv()) if "params" in response: block = response["params"]["result"] print(f"Block {int(block['number'], 16)}: {block['hash']}") asyncio.run(listen_blocks()) ``` {% endtab %} {% endtabs %} ### Ethereum Testnet Endpoints For development and testing, use testnet endpoints. GetBlock supports: | Testnet | Purpose | How to Get Tokens | | ----------- | ------------------------ | ---------------------------------------------- | | **Sepolia** | Primary Ethereum testnet | [Sepolia faucets](https://getblock.io/faucet/) | ### Archive Data Access Need to query the historical state at any past block? Enable **archive mode** on your endpoint. Archive data lets you: * Call `eth_getBalance` at any historical block * Execute `eth_call` against old contract state * Run `debug_traceTransaction` for any past transaction * Use `trace_block` and `trace_call` for deep analysis Archive mode is available on all paid plans and Dedicated Nodes. **Example — get balance at a specific historical block:** ```bash curl -X POST https://shared.eu-central-1.getblock.io// \ -H "Content-Type: application/json" \ -d '{ "jsonrpc": "2.0", "method": "eth_getBalance", "params": ["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045", "0xE8D4A5"], "id": "getblock.io" }' ``` ### What's Next? * [Full Ethereum API Reference](https://docs.getblock.io/api-reference/ethereum-eth) * [Using Ethers.js with GetBlock](https://docs.getblock.io/guides/using-web3-libraries/ethers.js-integration) *Need help choosing the right setup for your Ethereum project?* [*Contact our team*](mailto:support@getblock.io)*, and we'll help you find the best configuration.*