Ethereum Onchain Data API

Overview

Ethereum is the foundational smart contract platform powering the majority of DeFi, NFTs, and Web3 innovation. The most secure and decentralized programmable blockchain.

GoldRush offers the most comprehensive Ethereum Data API suite for developers, analysts, and enterprises. Whether you’re building a DeFi dashboard, a wallet, a trading bot, an AI agent or a compliance platform, our Ethereum Data APIs provide fast, accurate, and developer-friendly access to the essential onchain data you need.

Supported APIs

Foundational API

Access structured historical blockchain data across 100+ chains using REST APIs. Get token balances, transaction histories, decoded event logs, NFT assets, token holders and more.

Use cases: Wallets, portfolio trackers, crypto accounting & tax tools, and DeFi dashboards.

JSON-RPC

Low-latency EVM JSON-RPC with global failover and archive depth. Point your existing tooling at the GoldRush endpoint — no code changes required.

Use cases: dApps, wallets, indexers, bots, and trading infrastructure.

Mainnet

Property	Value
Chain Name	`eth-mainnet`
Chain ID	`1`
Network Type	Foundational Chain
Support Level	foundational
Block Explorer	Etherscan
Official Website	Ethereum Website
Native Gas Token	ETH

Testnets

Holesky Testnet

Property	Value
Chain Name	`eth-holesky`
Chain ID	`17000`
Purpose	Development and testing network
Support Level	frontier
Block Explorer	Holesky Etherscan
Official Website	Holesky Testnet Website
Native Gas Token	ETH

Ethereum Sepolia Testnet

Property	Value
Chain Name	`eth-sepolia`
Chain ID	`11155111`
Purpose	Development and testing network
Support Level	foundational
Block Explorer	Sepolia Etherscan
Official Website	Ethereum Sepolia Testnet Website
Native Gas Token	ETH

API Usage

To use this blockchain network in GoldRush API calls, use:

Chain Name

eth-mainnet (mainnet)
eth-holesky (testnet)
eth-sepolia (testnet)

Example API Calls

curl -X GET "https://api.covalenthq.com/v1/eth-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=<GOLDRUSH_API_KEY>"

curl -X GET "https://api.covalenthq.com/v1/eth-holesky/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=<GOLDRUSH_API_KEY>"

curl -X GET "https://api.covalenthq.com/v1/eth-sepolia/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=<GOLDRUSH_API_KEY>"

SDK Usage

import { GoldRushClient } from "@covalenthq/client-sdk";

const client = new GoldRushClient("<GOLDRUSH_API_KEY>");
const resp = await client.BalanceService.getTokenBalancesForWalletAddress({
    chainName: "eth-mainnet",
    walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
});

import { GoldRushClient } from "@covalenthq/client-sdk";

const client = new GoldRushClient("<GOLDRUSH_API_KEY>");
const resp = await client.BalanceService.getTokenBalancesForWalletAddress({
    chainName: "eth-holesky",
    walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
});

import { GoldRushClient } from "@covalenthq/client-sdk";

const client = new GoldRushClient("<GOLDRUSH_API_KEY>");
const resp = await client.BalanceService.getTokenBalancesForWalletAddress({
    chainName: "eth-sepolia",
    walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"
});

Foundational API Support

This chain supports 28 GoldRush Foundational APIs:

Wallet API

NFT API

Pricing API

Internal Transactions (`with-internal`)

Ethereum supports internal transactions (traces). The Transactions API endpoints marked with-traces above accept the with-internal=true query parameter, which includes internal transactions (the value transfers triggered by contract execution that are not recorded as standalone onchain transactions) in the response.

Internal transactions are included in the response by passing with-internal and cost 0.05 credits/item.

Example API Call

Recent transactions with internal transactions

curl -X GET "https://api.covalenthq.com/v1/eth-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/transactions_v3/?with-internal=true&key=<GOLDRUSH_API_KEY>"

JSON-RPC

Ethereum is available on the GoldRush JSON-RPC service. Point your existing EVM tooling (ethers.js, viem, web3.js, or raw HTTP) at the GoldRush endpoint — the standard eth_*, net_*, web3_*, debug_*, and trace_* methods are supported.

Endpoint

https://rpc.goldrushdata.com/v1/eth-mainnet

Example JSON-RPC Calls

curl https://rpc.goldrushdata.com/v1/eth-mainnet \
  -H "Authorization: Bearer <GOLDRUSH_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}'

curl https://rpc.goldrushdata.com/v1/eth-mainnet \
  -H "Authorization: Bearer <GOLDRUSH_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"eth_getBalance","params":["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","latest"]}'

Sample Methods

eth_blockNumber on Ethereum
eth_getBalance on Ethereum
eth_call on Ethereum
eth_getLogs on Ethereum
eth_getTransactionReceipt on Ethereum

See the full method list and per-method examples for Ethereum.

Overview

Popular Chains 🔥

Foundational Chains

Frontier Chains

Community Chains

Archived Chains

Overview

Supported APIs

Foundational API

JSON-RPC

Mainnet

Testnets

Holesky Testnet

Ethereum Sepolia Testnet

API Usage

Chain Name

Example API Calls

SDK Usage

Foundational API Support

Wallet API

NFT API

Pricing API

Security API

Transactions API

Block Explorer API

Internal Transactions (`with-internal`)

Example API Call

JSON-RPC

Endpoint

Example JSON-RPC Calls

Sample Methods

Additional Resources

​Overview

​Supported APIs

Foundational API

JSON-RPC

​Mainnet

​Testnets

​Holesky Testnet

​Ethereum Sepolia Testnet

​API Usage

​Chain Name

​Example API Calls

​SDK Usage

​Foundational API Support

​Wallet API

​NFT API

​Pricing API

​Security API

​Transactions API

​Block Explorer API

​Internal Transactions (with-internal)

​Example API Call

​JSON-RPC

​Endpoint

​Example JSON-RPC Calls

​Sample Methods

​Additional Resources

Overview

Supported APIs

Mainnet

Testnets

Holesky Testnet

Ethereum Sepolia Testnet

API Usage

Chain Name

Example API Calls

SDK Usage

Foundational API Support

Wallet API

NFT API

Pricing API

Security API

Transactions API

Block Explorer API

Internal Transactions (`with-internal`)

Example API Call

JSON-RPC

Endpoint

Example JSON-RPC Calls

Sample Methods

Additional Resources