Skip to content

Latest commit

 

History

History

base

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

README.md

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

Base

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

{% hint style="info" %} 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. {% endhint %}

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

{% tabs %} {% tab title="Frankfurt, Germany" %}

https://shared.eu-central-1.getblock.io

{% endtab %}

{% tab title="New York, USA" %}

https://shared.us-east-1.getblock.io

{% endtab %}

{% tab title="Singapore, Singapore" %}

https://shared.ap-southeast-1.getblock.io

{% endtab %} {% endtabs %}

Supported Networks

{% include "../../.gitbook/includes/untitled.md" %}

Quickstart

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

  • Axios
  • Python

Quickstart with Axios

{% stepper %} {% step %}

Set up the project

Create a new project folder and initialize npm:

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

{% endstep %}

{% step %}

Install Axios

npm install axios

{% endstep %}

{% step %}

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. {% endstep %}

{% step %}

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://shared.eu-central-1.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));

{% endstep %}

{% step %}

Run the script

node index.js

The block number will log in your console similar to:

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

{% endstep %} {% endstepper %}

Quickstart with Python and Requests

{% stepper %} {% step %}

Set up the project folder

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

{% endstep %}

{% step %}

Create and activate a virtual environment

python -m venv venv
source venv/bin/activate

# On Windows, use venv\Scripts\activate

{% endstep %}

{% step %}

Install requests

pip install requests

{% endstep %}

{% step %}

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://shared.eu-central-1.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)

{% endstep %}

{% step %}

Run the script

python main.py

{% endstep %} {% endstepper %}

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:

See Also