| 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 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.
- 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 %}
| 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 |
{% 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 %}
{% include "../../.gitbook/includes/untitled.md" %}
In this section, you will learn how to make your first call with either:
- Axios
- Python
{% stepper %} {% step %}
Create a new project folder and initialize npm:
mkdir base-api-quickstart
cd base-api-quickstart
npm init --yes{% endstep %}
{% step %}
npm install axios{% endstep %}
{% step %}
Create a file named index.js. Also set the ES module type in your package.json:
Add "type": "module" to package.json.
{% endstep %}
{% step %}
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 %}
node index.jsThe block number will log in your console similar to:
{
"jsonrpc": "2.0",
"id": "getblock.io",
"result": "0x2640163"
}{% endstep %} {% endstepper %}
{% stepper %} {% step %}
mkdir base-api-quickstart
cd base-api-quickstart{% endstep %}
{% step %}
python -m venv venv
source venv/bin/activate
# On Windows, use venv\Scripts\activate{% endstep %}
{% step %}
pip install requests{% endstep %}
{% step %}
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 %}
python main.py{% endstep %} {% endstepper %}
GetBlock provides access to standard Ethereum JSON-RPC methods for the Base network.
| 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 |
| 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 |
| 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 |
| 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 |
| Method | Description |
|---|---|
| eth_getLogs | Returns logs matching filter criteria |
| Method | Description |
|---|---|
| eth_chainId | Returns the chain ID |
| eth_syncing | Returns sync status |
| net_version | Returns the network ID |
| web3_clientVersion | Returns client version |
| Method | Description |
|---|---|
| debug_traceTransaction | Returns transaction trace |
| debug_traceBlockByHash | Traces all transactions in a block by hash |
| debug_traceBlockByNumber | Traces block by number |
For technical support and questions:
- Support: [email protected]