Documentation
Ethereum
Ethereum (chainId 1) is the original programmable smart-contract blockchain and the foundation of the decentralized web. Since the Merge in September 2022 it runs on Proof-of-Stake, finalizing blocks every ~12 seconds with ETH as its native gas token. It hosts the largest DeFi and NFT ecosystem — Uniswap, Aave, OpenSea, and thousands of protocols depend on it. TheRPC provides low-latency JSON-RPC access to Ethereum mainnet and testnets, with both full-node and archive endpoints so you can query any historical state from block 0.
Getting started
Quick StartGet a TheRPC API key and make your first Ethereum mainnet JSON-RPC call with curl, JavaScript, or Python, then wire up ethers/web3 against chain 1.
AuthenticationObtain, use, and secure a TheRPC API key for Ethereum mainnet (chain 1) requests — Bearer header, env-var setup, key rotation, and auth error handling.
Rate LimitsHow TheRPC rate-limits Ethereum requests and bills Compute Units, the -32029 error and headers, plus retries, batching, caching, and WebSocket strategies.
API OverviewTheRPC's Ethereum mainnet JSON-RPC 2.0 API: HTTP and WebSocket endpoints, request and response shapes, Bearer auth, namespaces, and error codes for chain 1.
FAQAnswers for the Ethereum mainnet API on TheRPC — API keys, JSON-RPC error codes, tracking transactions, reorgs and finality tags, EIP-1559 fees, and throughput.
Basic OperationsEveryday Ethereum mainnet operations on TheRPC: ETH balances in wei, transactions and receipts, fetching blocks, contract calls, gas price, and nonce.
All MethodsEvery Ethereum mainnet (chain 1) JSON-RPC method on TheRPC, grouped by namespace — eth_, debug_, trace_, net_, txpool_, web3_ — each with its CU cost.