> ## 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, transactions, and OHLCV pricing data for Ethereum. 39 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. Subscribe to real-time blockchain events with sub-second latency using GraphQL over WebSockets. Track token transfers, DEX activity, wallet movements, and OHLCV candlestick data across fast chains like Base and Solana.

Use cases: Trading bots & dashboards, gaming, and AI Agents. Stream blockchain data directly to your own infrastructure. Push decoded blocks, transactions, event logs, and protocol-specific data into your database, warehouse, queue, or webhook with ABI decoding and SQL transforms built in.

Use cases: Data warehousing, analytics dashboards, ETL pipelines, and backend indexing. ## Mainnet | Property | Value | | -------------------- | ---------------------------------------------------------------- | | **Chain Name** | `eth-mainnet` (Foundational API) / `ETH_MAINNET` (Streaming API) | | **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` / `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)](/api-reference/foundational-api/balances/get-token-holders-as-of-any-block-height-v2/)** * **[Get historical token balances for address](/api-reference/foundational-api/balances/get-historical-token-balances-for-address/)** * **[Get token balances for address](/api-reference/foundational-api/balances/get-token-balances-for-address/)** * **[Get native token balance for address](/api-reference/foundational-api/balances/get-native-token-balance/)** * **[Get historical portfolio value over time](/api-reference/foundational-api/balances/get-historical-portfolio-value-over-time/)** * **[Get ERC20 token transfers for address](/api-reference/foundational-api/balances/get-erc20-token-transfers-for-address/)** #### NFT API * **[Get NFTs for address](/api-reference/foundational-api/nft/get-nfts-for-address/)** * **[Check ownership in NFT collection](/api-reference/foundational-api/nft/check-ownership-in-nft-collection/)** * **[Check ownership in NFT collection for specific token](/api-reference/foundational-api/nft/check-ownership-in-nft-collection-token/)** #### Pricing API * **[Get pool spot prices](/api-reference/foundational-api/utility/get-pool-spot-prices/)** * **[Get historical token prices](/api-reference/foundational-api/utility/get-historical-token-prices/)** #### Security API * **[Get token approvals for address](/api-reference/foundational-api/security/get-token-approvals-for-address/)** #### Transactions API * **[Get a transaction](/api-reference/foundational-api/transactions/get-a-transaction/)** `with-traces` * **[Get transaction summary for address](/api-reference/foundational-api/transactions/get-transaction-summary-for-address/)** * **[Get earliest transactions for address (v3) ](/api-reference/foundational-api/transactions/get-earliest-transactions-for-address-v3/)** `with-traces` * **[Get recent transactions for address (v3)](/api-reference/foundational-api/transactions/get-recent-transactions-for-address-v3/)** `with-traces` * **[Get paginated transactions for address (v3)](/api-reference/foundational-api/transactions/get-paginated-transactions-for-address-v3/)** `with-traces` * **[Get bulk time bucket transactions for address (v3)](/api-reference/foundational-api/transactions/get-time-bucket-transactions-for-address-v3/)** * **[Get all transactions in a block (v3)](/api-reference/foundational-api/transactions/get-all-transactions-in-a-block/)** * **[Get all transactions in a block by page (v3) ](/api-reference/foundational-api/transactions/get-all-transactions-in-a-block-by-page/)** #### Block Explorer API * **[Get a block](/api-reference/foundational-api/utility/get-a-block/)** * **[Get all chain statuses](/api-reference/foundational-api/utility/get-all-chain-statuses/)** * **[Get all chains](/api-reference/foundational-api/utility/get-all-chains/)** * **[Get block heights](/api-reference/foundational-api/utility/get-block-heights/)** * **[Get gas prices](/api-reference/foundational-api/utility/get-gas-prices/)** * **[Get log events by contract address](/api-reference/foundational-api/utility/get-log-events-by-contract-address/)** * **[Get log events by topic hash(es)](/api-reference/foundational-api/utility/get-log-events-by-topic-hash/)** * **[Get logs](/api-reference/foundational-api/utility/get-logs/)** ## Streaming API Support This chain supports **11** GoldRush Streaming APIs: * [New DEX Pairs Stream](/api-reference/streaming-api/subscriptions/new-dex-pairs-stream/) * [OHLCV Pairs Stream](/api-reference/streaming-api/subscriptions/ohlcv-pairs-stream/) * [OHLCV Tokens Stream](/api-reference/streaming-api/subscriptions/ohlcv-tokens-stream/) * [Update Pairs Stream](/api-reference/streaming-api/subscriptions/update-pairs-stream/) * [Update Tokens Stream](/api-reference/streaming-api/subscriptions/update-tokens-stream/) * [Wallet Activity Stream](/api-reference/streaming-api/subscriptions/wallet-activity-stream/) * [OHLCV Pairs Query](/api-reference/streaming-api/queries/ohlcv-pairs-query/) * [OHLCV Tokens Query](/api-reference/streaming-api/queries/ohlcv-tokens-query/) * [Token Search Query](/api-reference/streaming-api/queries/token-search-query/) * [Top Trader Wallets for Token Query](/api-reference/streaming-api/queries/upnl-for-token-query/) * [Wallet PnL by Token Query](/api-reference/streaming-api/queries/upnl-for-wallet-query/) ## Pipeline API Support This chain supports **4** GoldRush Pipeline API data objects that can be streamed to your infrastructure: * [Blocks](/goldrush-pipeline-api/supported-chains#ethereum-evm) * [Transactions](/goldrush-pipeline-api/supported-chains#ethereum-evm) * [Logs](/goldrush-pipeline-api/supported-chains#ethereum-evm) * [Transfers](/goldrush-pipeline-api/supported-chains#ethereum-evm) ## Additional Resources * [GoldRush API Documentation](https://goldrush.dev/docs/) * [Supported Chains List](https://goldrush.dev/chains/) * [API Reference](https://goldrush.dev/docs/api-reference/)