Celo

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

Celo is a mobile-first, carbon-negative Ethereum Layer 2 blockchain designed to make financial tools accessible to anyone with a smartphone. Originally launched as an EVM-compatible Layer 1 in 2020, Celo completed its transition to an Ethereum L2 using the OP Stack in March 2025. The network features 1-second block times, one-block finality, sub-cent transaction fees, and the unique ability to pay gas fees in stablecoins (cUSD, cEUR, USDC, USDT) in addition to CELO.

Key Features

• Ethereum Layer 2: Built on OP Stack, leveraging Ethereum's security with fast, low-cost transactions

• Mobile-First Design: Ultralight clients (Plumo) enable blockchain access on low-powered smartphones

• Fee Abstraction: Pay transaction fees in CELO or stablecoins (cUSD, cEUR, cREAL, USDC, USDT)

• Phone Number Identity: Map phone numbers to wallet addresses for easy payments

• Native Stablecoins: cUSD, cEUR, and cREAL via the Mento Protocol for stable payments

• One-Block Finality: ~1 second block times with instant transaction finality

• Carbon-Negative: First carbon-negative blockchain through on-chain offsets

• Full EVM Compatibility: Deploy Ethereum smart contracts without modification

• CELO Token: Native token for gas fees, staking, and governance (18 decimals)

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	Celo Mainnet
Chain ID	42220
Native Currency	CELO
Decimals	18
RPC URL	https://forno.celo.org
Network Type	Ethereum Layer 2 (OP Stack)
Block Time	~1 second
Finality	One-block finality

Base URL

Frankfurt, Germany

https://go.getblock.io

Singapore, Singapore

New York, USA

Supported Networks

Network	Chain ID	JSON RPC	WSS	Frankfurt, Germany	New York, USA	Singapore, Singapore
Mainnet	42220	✅	✅	✅	✅	✅
Sepolia	11142220	✅	✅	✅	✅	✅

Quickstart

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

• Axios

• Python

Before you begin, you must have already installed npm or yarn on your local machine (for the Axios example) or Python and pip (for the Python example).

Quickstart with Axios

1

Setup project

Create and initialize a new project:

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

2

Install Axios

npm install axios

3

Create file

Create a new file named index.js. This is where you will make your first call.

4

Set ES module type

Set the ES module "type": "module" in your package.json.

5

Add code

Add the following code to index.js:

index.js

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));

Replace <ACCESS-TOKEN> with your actual access token from GetBlock.

6

Run the script

node index.js

Expected output (example):

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

Quickstart with Python and Requests

1

Setup the project directory

mkdir celo-api-quickstart
cd celo-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 script

Create a file called main.py with the following content:

main.py

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)

Replace <ACCESS-TOKEN> with your actual access token from GetBlock.

5

Run the script

python main.py

Available API Methods

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

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_getTransactionCount	Returns the transaction count (nonce)
eth_getTransactionReceipt	Returns the receipt of a transaction
eth_sendRawTransaction	Submits a signed transaction

Block Methods

Method	Description
eth_blockNumber	Returns the current block number
eth_getBlockByHash	Returns block by hash
eth_getBlockByNumber	Returns block 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

Account/State Methods

Method	Description
eth_getBalance	Returns the CELO balance of an address
eth_getStorageAt	Returns the value at a storage position
eth_getCode	Returns the code at an address
eth_call	Executes a call without creating a transaction
eth_getProof	Returns account and storage proof
eth_accounts	Returns a list of addresses owned by client

Gas and Fee Methods

Method	Description
eth_gasPrice	Returns the current gas price
eth_estimateGas	Estimates gas for a transaction
eth_feeHistory	Returns historical gas information
eth_maxPriorityFeePerGas	Returns current max priority fee

Filter Methods

Method	Description
eth_getLogs	Returns logs matching filter criteria
eth_newFilter	Creates a log filter
eth_newBlockFilter	Creates a block filter
eth_getFilterChanges	Returns filter changes since last poll
eth_getFilterLogs	Returns all logs matching filter
eth_uninstallFilter	Removes a filter

Subscription Methods (WebSocket)

Method	Description
eth_subscribe	Creates a subscription for events
eth_unsubscribe	Cancels an existing subscription

Network/Chain Methods

Method	Description
eth_chainId	Returns the chain ID (42220)
eth_syncing	Returns sync status
net_version	Returns the network ID
net_listening	Returns listening status
net_peerCount	Returns number of connected peers
web3_clientVersion	Returns client version
web3_sha3	Returns Keccak-256 hash of data

Debug Methods

Method	Description
debug_traceBlockByHash	Traces all transactions in a block by hash
debug_traceBlockByNumber	Traces block by number
debug_traceTransaction	Traces a specific transaction
debug_traceCall	Traces a call without creating transaction

Support

For technical support and questions:

• Support: [email protected]

See Also

• Celo Developer docs

• Celo Explorer

• Get Celo Faucet

• Ethereum JSON RPC API

• Celo Website