Base

GetBlock provides fast and reliable access to Base nodes via JSON-RPC API. Connect to the Base network without running your own infrastructure.

Base is a secure, low-cost, and developer-friendly Ethereum Layer 2 blockchain built by Coinbase using the OP Stack, the same technology powering Optimism. It leverages optimistic rollup technology to deliver fast transactions at a fraction of Ethereum mainnet costs while inheriting Ethereum's security through data availability on L1.

Key Features

• Full EVM Compatibility: Deploy Ethereum smart contracts without modification

• OP Stack Architecture: Built on Optimism's battle-tested Bedrock release

• 2-Second Block Time: Fast block production for responsive applications

• Low Transaction Fees: Significantly cheaper than Ethereum mainnet

• Ethereum Security: Inherits security from Ethereum L1 through optimistic rollups

• Coinbase Integration: Seamless access to Coinbase ecosystem and fiat on-ramps

• EIP-1559 Support: Dynamic fee mechanism with base fee and priority fee

• Fraud Proof Security: Invalid state transitions can be challenged during dispute window

TECHNICAL DISCLAIMER: AUTHORITATIVE JSON-RPC API SPECIFICATION.

GetBlock's RPC API reference documentation is provided exclusively for informational purposes and streamlined developer experience optimization. The canonical and normative specification for Ethereum Virtual Machine (EVM) JSON-RPC methods is solely maintained and published through the official Ethereum Foundation documentation portal at ethereum.org. This resource constitutes the sole authoritative reference implementation of the JSON-RPC 2.0 protocol interface across EVM-compatible execution clients.

Network Information

Property	Value
Network Name	Base Mainnet
Chain ID	8453
Native Currency	ETH
Block Time	~2 seconds
Gas Limit	25,000,000 per transaction
EVM Compatibility	Full bytecode compatibility
Consensus	Optimistic Rollup (OP Stack)
Settlement Layer	Ethereum L1

Base URL

Frankfurt, Germany

https://go.getblock.io

New York, USA

Singapore, Singapore

Supported Networks

Network	Chain ID	JSON RPC	WSS	MEV Protected (JSON RPC)	MEV Protected (WSS)	Graph QL	New York, USA	Frankfurt, Germany	Singapore, Singapore
Mainnet	8453	✅	✅	✅	✅	❌	✅	✅	✅
Sepolia	84532	✅	✅	❌	❌	✅	✅	❌	❌

Quickstart

In this section, you will learn how to make your first call with either:

• Axios

• Python

Quickstart with Axios

1

Set up the project

Create a new project folder and initialize npm:

mkdir base-api-quickstart
cd base-api-quickstart
npm init --yes

2

Install Axios

npm install axios

3

Create the script file

Create a file named index.js. Also set the ES module type in your package.json:

Add "type": "module" to package.json.

4

Add the request code

Put the following code into index.js (replace <ACCESS-TOKEN> with your GetBlock access token):

import axios from 'axios';

const data = JSON.stringify({
    "jsonrpc": "2.0",
    "method": "eth_blockNumber",
    "params": [],
    "id": "getblock.io"
});

const config = {
    method: 'post',
    url: 'https://go.getblock.io/<ACCESS-TOKEN>/',
    headers: {
        'Content-Type': 'application/json'
    },
    data: data
};

axios(config)
    .then(response => console.log(JSON.stringify(response.data)))
    .catch(error => console.log(error));

5

Run the script

node index.js

The block number will log in your console similar to:

{
    "jsonrpc": "2.0",
    "id": "getblock.io",
    "result": "0x2640163"
}

Quickstart with Python and Requests

1

Set up the project folder

mkdir base-api-quickstart
cd base-api-quickstart

2

Create and activate a virtual environment

python -m venv venv
source venv/bin/activate

# On Windows, use venv\Scripts\activate

3

Install requests

pip install requests

4

Create the script

Create a file called main.py with the following code (replace <ACCESS-TOKEN> with your GetBlock access token):

import requests
import json

url = "https://go.getblock.io/<ACCESS-TOKEN>/"

payload = json.dumps({
    "jsonrpc": "2.0",
    "method": "eth_blockNumber",
    "params": [],
    "id": "getblock.io"
})

headers = {
    'Content-Type': 'application/json'
}

response = requests.post(url, headers=headers, data=payload)
print(response.text)

5

Run the script

python main.py

Available API Methods

GetBlock provides access to standard Ethereum JSON-RPC methods for the Base network.

Reading Data (State Methods)

Method	Description
eth_blockNumber	Returns the current block number
eth_getBalance	Returns the balance of an address
eth_getStorageAt	Returns the value at a storage position
eth_getTransactionCount	Returns the transaction count (nonce)
eth_getCode	Returns the code at an address
eth_call	Executes a call without creating a transaction

Block Information

Method	Description
eth_getBlockByHash	Returns block information by hash
eth_getBlockByNumber	Returns block information by number
eth_getBlockReceipts	Returns all receipts for a block
eth_getBlockTransactionCountByHash	Returns transaction count by block hash
eth_getBlockTransactionCountByNumber	Returns transaction count by block number

Transaction Methods

Method	Description
eth_getTransactionByHash	Returns transaction by hash
eth_getTransactionByBlockHashAndIndex	Returns transaction by block hash and index
eth_getTransactionByBlockNumberAndIndex	Returns transaction by block number and index
eth_getTransactionReceipt	Returns the receipt of a transaction
eth_sendRawTransaction	Submits a signed transaction

Gas and Fee Estimation

Method	Description
eth_gasPrice	Returns the current gas price
eth_maxPriorityFeePerGas	Returns suggested priority fee
eth_feeHistory	Returns fee history for blocks
eth_estimateGas	Estimates gas for a transaction

Logs and Events

Method	Description
eth_getLogs	Returns logs matching filter criteria

Chain Information

Method	Description
eth_chainId	Returns the chain ID
eth_syncing	Returns sync status
net_version	Returns the network ID
web3_clientVersion	Returns client version

Debug Methods

Method	Description
debug_traceTransaction	Returns transaction trace
debug_traceBlockByHash	Traces all transactions in a block by hash
debug_traceBlockByNumber	Traces block by number

Support

For technical support and questions:

• Support: [email protected]

See Also

• Base Developer Documentation

• Base Block Explorer - Basescan

• Base Bridge

• OP Stack Documentation

• Ethereum JSON-RPC Specification