Celo API

Token balances with prices, transaction history and token approvals for any Celo address, indexed from genesis to the latest block, plus JSON-RPC for Celo with archive depth. One API key, no nodes to run.

Get a free API keyRead the Celo docs
// Token balances on Celo: 1 credit
const chain = "celo-mainnet";
const address = "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045";
const url = "https://api.covalenthq.com/v1/" + chain +
  "/address/" + address + "/balances_v2/";

const key = process.env.GOLDRUSH_API_KEY;
const res = await fetch(url, {
  headers: { Authorization: `Bearer ${key}` },
});
const { data } = await res.json();

for (const token of data.items) {
  // balance, quote (USD value), quote_rate …
  console.log(token.contract_ticker_symbol, token.pretty_quote);
}

Used by EY, Fidelity and Consensys

  • EY
  • Fidelity
  • Consensys
  • Jump
  • Ondo
  • ThorWallet
  • Rainbow
  • Matcha
  • Velora
  • AtomicWallet
  • Atlas Wallet
  • OneKey
Read the case studies

Query Celo data

REST endpoints that return decoded, priced Celo data in one call, billed in credits per request. The same key works on every other chain GoldRush supports.

Every endpoint supported on Celo

Celo RPC endpoint

Standard eth_*, net_* and web3_* methods plus debug_* and trace_*, with archive depth, drop-in for viem, ethers, web3.js and web3.py. GoldRush routes each call to the best of several upstream providers, from regional edge locations, with a 99.9% production SLA. It uses the same API key and credits as the rest of GoldRush.

  • Standard: eth_*, net_* and web3_* methods0.01 credits per call
  • Trace: debug_* and trace_* methods0.015 credits per call
JSON-RPC quickstartMigrate from Infura, Alchemy or AnkrJSON-RPC pricing
// ethers v6, pointed at the GoldRush endpoint
import { ethers } from "ethers";

const url = "https://rpc.goldrushdata.com/v1/celo-mainnet";
const req = new ethers.FetchRequest(url);
const key = process.env.GOLDRUSH_API_KEY;
req.setHeader("Authorization", `Bearer ${key}`);
const provider = new ethers.JsonRpcProvider(req);

console.log(await provider.getBlockNumber());

Celo on GoldRush

GoldRush serves decoded Celo data through one REST API. Network covered: celo-mainnet (chain ID 42220, 5-second blocks), with block explorer data from explorer.celo.org. The Foundational API returns token balances, historical transactions and wallet activity, and token approvals data.

celo-mainnetCommunity chain
Chain name
celo-mainnet
Chain ID
42220
Block time
5 s
Gas token
CELO
Block explorer
explorer.celo.org
Last synced block
Loading...
JSON-RPC endpoint
https://rpc.goldrushdata.com/v1/celo-mainnet
Data last updated . The last synced block refreshes every 5 seconds.

Chain details from the Celo chain reference.

What teams build on Celo

  • Wallets and portfolio trackers

    Show what any Celo address holds, priced in USD, next to its full transaction history.

    Crypto wallet API

  • Crypto tax and accounting

    Pull every Celo transaction for a client's addresses and reconcile it into reports.

    Tax and accounting data

  • DeFi dashboards

    Track Celo positions, tokens and protocol activity without running an indexer.

    DeFi data

  • Risk and compliance

    Review Celo counterparties and their activity before you onboard or pay them.

    Risk and compliance data

  • Analytics and research

    Answer questions about Celo wallets and tokens from indexed history instead of raw RPC.

    Analytics data

  • AI agents

    Give Claude, Cursor and other agents Celo data through the hosted GoldRush MCP server.

    GoldRush MCP server

Start building on Celo

Every account starts with a 14-day free trial: 25,000 credits at 4 requests per second, no credit card. After that, Vibe Coding is $10 a month for prototypes and side projects, and Professional is $250 a month with 50 requests per second for production.

Get a free API keySee pricing

Celo FAQ

Yes. https://rpc.goldrushdata.com/v1/celo-mainnet serves Celo JSON-RPC on your GoldRush API key, sent as an Authorization: Bearer header. Standard methods cost 0.01 credits per call and debug and trace methods 0.015. See the JSON-RPC quickstart.

Celo API docs

Start here

Reference

More