For the complete documentation index, see llms.txt. This page is also available as Markdown.

Ethereum API

Ethereum JSON-RPC API on RPC Fast: HTTPS and WebSocket endpoints, limits and the list of supported methods.

RPC Fast serves the Ethereum JSON-RPC API over HTTPS and WebSocket.

Endpoints

Protocol
URL

HTTPS

https://eth-mainnet.rpcfast.com/?api_key=<API_KEY>

WebSocket

wss://eth-mainnet.rpcfast.com/?api_key=<API_KEY>

Your API key is in the dashboard, see Getting Started. You can also send it in the X-API-KEY header instead of the URL.

Limits

  • A batch request carries at most 4 calls. A larger batch is rejected with error -32600 and is not billed.

  • debug_trace* methods accept the built-in tracers callTracer, flatCallTracer, prestateTracer and 4byteTracer, with a timeout of at most 10s.

  • Methods that sign or manage the node (eth_sign*, eth_sendTransaction, personal_*, admin_*, miner_*, engine_*) are not available.

  • Every method has its own price in Compute Units, see Compute Units.

Methods

Chain and network

  • eth_accounts — Returns the accounts held by the node.

  • eth_blockNumber — Returns the number of the most recent block.

  • eth_chainId — Returns the chain ID used to sign transactions (EIP-155).

  • eth_config — Returns the fork configuration of the chain: the current, next and last scheduled forks (EIP-7910).

  • eth_protocolVersion — Returns the version of the Ethereum wire protocol the node speaks.

  • eth_syncing — Reports whether the node is still syncing with the network.

  • net_listening — Tells whether the node is listening for peer connections.

  • net_version — Returns the network ID of the chain.

  • web3_clientVersion — Returns the name and version of the client software behind the endpoint.

  • web3_sha3 — Returns the Keccak-256 hash of the given data.

Gas and fees

  • eth_blobBaseFee — Returns the current base fee per blob gas (EIP-4844).

  • eth_feeHistory — Returns base fees, gas usage ratios and priority fee percentiles for a range of recent blocks.

  • eth_gasPrice — Returns the node's estimate of a gas price for a legacy transaction.

  • eth_maxPriorityFeePerGas — Returns a suggested priority fee (tip) for an EIP-1559 transaction.

Accounts and state

  • eth_getAccount — Returns the account record of an address: balance, nonce, code hash and storage root.

  • eth_getAccountInfo — Returns the balance, nonce and code of an address in one call.

  • eth_getBalance — Returns the balance of an address in wei.

  • eth_getCode — Returns the bytecode deployed at an address.

  • eth_getProof — Returns the account and storage values of an address together with their Merkle proofs (EIP-1186).

  • eth_getStorageAt — Returns the value of one storage slot of a contract.

  • eth_getTransactionCount — Returns the number of transactions sent from an address, which is its next nonce.

Execution and simulation

  • eth_call — Executes a message call against the chain state without creating a transaction. Use it to read contract data.

  • eth_callMany — Executes several bundles of calls one after another on top of a block, each call seeing the state left by the previous ones.

  • eth_createAccessList — Builds an EIP-2930 access list for a transaction and estimates its gas with that list.

  • eth_estimateGas — Estimates the gas a transaction needs to execute.

  • eth_simulateV1 — Simulates a sequence of calls across one or more blocks, with optional state and block overrides.

Blocks

Transactions

Logs and filters

WebSocket subscriptions

  • eth_subscribe — Opens a subscription over WebSocket. The node then pushes an eth_subscription notification for every event.

  • eth_unsubscribe — Closes a subscription opened with eth_subscribe.

Debug

Trace

  • trace_block — Returns the traces of every transaction in a block.

  • trace_call — Executes a call on top of a block and returns the requested traces, without creating a transaction.

  • trace_callMany — Executes several calls one after another on top of a block and returns their traces.

  • trace_filter — Returns the traces that match a filter over a block range.

  • trace_get — Returns one trace of a transaction, by its position in the call tree.

  • trace_rawTransaction — Executes a signed transaction on top of the latest block and returns its traces, without broadcasting it.

  • trace_replayBlockTransactions — Replays every transaction of a block and returns the requested traces.

  • trace_replayTransaction — Replays a mined transaction and returns the requested traces.

  • trace_transaction — Returns all actions of a mined transaction as a flat list of traces.

Last updated