> ## Documentation Index > Fetch the complete documentation index at: https://goldrush.dev/docs/llms.txt > Use this file to discover all available pages before exploring further. # 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 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. 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](https://etherscan.io/) | | **Official Website** | [Ethereum Website](https://ethereum.org) | | **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](https://holesky.etherscan.io/) | | **Official Website** | [Holesky Testnet Website](https://github.com/eth-clients/holesky) | | **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](https://sepolia.etherscan.io/) | | **Official Website** | [Ethereum Sepolia Testnet Website](https://ethereum.org/en/developers/docs/networks/#ethereum-testnets) | | **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 ```bash Chain Name (Mainnet) theme={null} curl -X GET "https://api.covalenthq.com/v1/eth-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=" ``` ```bash Chain Name (Holesky Testnet) theme={null} curl -X GET "https://api.covalenthq.com/v1/eth-holesky/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=" ``` ```bash theme={null} ``` ```bash Chain Name (Ethereum Sepolia Testnet) theme={null} curl -X GET "https://api.covalenthq.com/v1/eth-sepolia/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/balances_v2/?key=" ``` ```bash theme={null} ``` #### SDK Usage ```typescript TypeScript SDK (Mainnet) theme={null} import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient(""); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "eth-mainnet", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); ``` ```typescript TypeScript SDK (Holesky Testnet) theme={null} import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient(""); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "eth-holesky", walletAddress: "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045" }); ``` ```typescript TypeScript SDK (Ethereum Sepolia Testnet) theme={null} import { GoldRushClient } from "@covalenthq/client-sdk"; const client = new GoldRushClient(""); const resp = await client.BalanceService.getTokenBalancesForWalletAddress({ chainName: "eth-sepolia", 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](/docs/api-reference/foundational-api/balances/get-token-holders-as-of-any-block-height-v2/)** * **[Get historical token balances for address on Ethereum](/docs/api-reference/foundational-api/balances/get-historical-token-balances-for-address/)** * **[Get token balances for address on Ethereum](/docs/api-reference/foundational-api/balances/get-token-balances-for-address/)** * **[Get native token balance for address on Ethereum](/docs/api-reference/foundational-api/balances/get-native-token-balance/)** * **[Get historical portfolio value over time on Ethereum](/docs/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time/)** * **[Get ERC20 token transfers for address on Ethereum](/docs/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address/)** #### NFT API * **[Get NFTs for address on Ethereum](/docs/api-reference/foundational-api/nft/get-nfts-for-address/)** * **[Check ownership in NFT collection on Ethereum](/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection/)** * **[Check ownership in NFT collection for specific token on Ethereum](/docs/api-reference/foundational-api/nft/check-ownership-in-nft-collection-token/)** #### Pricing API * **[Get pool spot prices on Ethereum](/docs/api-reference/foundational-api/utility/get-pool-spot-prices/)** * **[Get historical token prices on Ethereum](/docs/api-reference/foundational-api/utility/get-historical-token-prices/)** #### Security API * **[Get token approvals for address on Ethereum](/docs/api-reference/foundational-api/security/get-token-approvals-for-address/)** #### Transactions API * **[Get a transaction on Ethereum](/docs/api-reference/foundational-api/transactions/get-a-transaction/)** `with-traces` * **[Get transaction summary for address on Ethereum](/docs/api-reference/foundational-api/transactions/get-transaction-summary-for-address/)** * **[Get earliest transactions for address (v3) on Ethereum](/docs/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3/)** `with-traces` * **[Get recent transactions for address (v3) on Ethereum](/docs/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3/)** `with-traces` * **[Get paginated transactions for address (v3) on Ethereum](/docs/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3/)** `with-traces` * **[Get bulk time bucket transactions for address (v3) on Ethereum](/docs/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3/)** * **[Get all transactions in a block (v3) on Ethereum](/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block/)** * **[Get all transactions in a block by page (v3) on Ethereum](/docs/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page/)** #### Block Explorer API * **[Get a block on Ethereum](/docs/api-reference/foundational-api/utility/get-a-block/)** * **[Get all chain statuses on Ethereum](/docs/api-reference/foundational-api/utility/get-all-chain-statuses/)** * **[Get all chains on Ethereum](/docs/api-reference/foundational-api/utility/get-all-chains/)** * **[Get block heights on Ethereum](/docs/api-reference/foundational-api/utility/get-block-heights/)** * **[Get gas prices on Ethereum](/docs/api-reference/foundational-api/utility/get-gas-prices/)** * **[Get log events by contract address on Ethereum](/docs/api-reference/foundational-api/utility/get-log-events-by-contract-address/)** * **[Get log events by topic hash(es) on Ethereum](/docs/api-reference/foundational-api/utility/get-log-events-by-topic-hash/)** * **[Get logs on Ethereum](/docs/api-reference/foundational-api/utility/get-logs/)** ## 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 ```bash Recent transactions with internal transactions theme={null} curl -X GET "https://api.covalenthq.com/v1/eth-mainnet/address/0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045/transactions_v3/?with-internal=true&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 ```bash eth_blockNumber theme={null} curl https://rpc.goldrushdata.com/v1/eth-mainnet \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"eth_blockNumber","params":[]}' ``` ```bash eth_getBalance theme={null} curl https://rpc.goldrushdata.com/v1/eth-mainnet \ -H "Authorization: Bearer " \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"eth_getBalance","params":["0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045","latest"]}' ``` #### Sample Methods * **[eth\_blockNumber on Ethereum](/docs/api-reference/json-rpc/ethereum/eth-blocknumber)** * **[eth\_getBalance on Ethereum](/docs/api-reference/json-rpc/ethereum/eth-getbalance)** * **[eth\_call on Ethereum](/docs/api-reference/json-rpc/ethereum/eth-call)** * **[eth\_getLogs on Ethereum](/docs/api-reference/json-rpc/ethereum/eth-getlogs)** * **[eth\_getTransactionReceipt on Ethereum](/docs/api-reference/json-rpc/ethereum/eth-gettransactionreceipt)** See the [full method list and per-method examples for Ethereum](/docs/api-reference/json-rpc/chains/ethereum). ## Additional Resources * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/)