Ethereum Onchain Data API

Get token balances and transactions for Ethereum. 28 endpoints supported. Testnet supported.

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.

Read docs

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.

Read docs

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

Chain Name (Mainnet)

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

SDK Usage

TypeScript SDK (Mainnet)

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

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

Foundational API Support

This chain supports 28 GoldRush Foundational APIs:

Wallet API

• Get token holders as of any block height (v2) on Ethereum
• Get historical token balances for address on Ethereum
• Get token balances for address on Ethereum
• Get native token balance for address on Ethereum
• Get historical portfolio value over time on Ethereum
• Get ERC20 token transfers for address on Ethereum

NFT API

• Get NFTs for address on Ethereum
• Check ownership in NFT collection on Ethereum
• Check ownership in NFT collection for specific token on Ethereum

Pricing API

• Get pool spot prices on Ethereum
• Get historical token prices on Ethereum

Security API

• Get token approvals for address on Ethereum

Transactions API

• Get a transaction on Ethereum with-traces
• Get transaction summary for address on Ethereum
• Get earliest transactions for address (v3) on Ethereum with-traces
• Get recent transactions for address (v3) on Ethereum with-traces
• Get paginated transactions for address (v3) on Ethereum with-traces
• Get bulk time bucket transactions for address (v3) on Ethereum
• Get all transactions in a block (v3) on Ethereum
• Get all transactions in a block by page (v3) on Ethereum

Block Explorer API

• Get a block on Ethereum
• Get all chain statuses on Ethereum
• Get all chains on Ethereum
• Get block heights on Ethereum
• Get gas prices on Ethereum
• Get log events by contract address on Ethereum
• Get log events by topic hash(es) on Ethereum
• Get logs on Ethereum

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

eth_blockNumber

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":[]}'

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.

Additional Resources

• GoldRush API Documentation
• Supported Chains List
• API Reference