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
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
-32600and is not billed.debug_trace*methods accept the built-in tracerscallTracer,flatCallTracer,prestateTracerand4byteTracer, with atimeoutof at most10s.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
eth_getBlockByHash — Returns a block by its hash.
eth_getBlockByNumber — Returns a block by its number.
eth_getBlockReceipts — Returns the receipts of every transaction in a block.
eth_getBlockTransactionCountByHash — Returns the number of transactions in a block, by block hash.
eth_getBlockTransactionCountByNumber — Returns the number of transactions in a block, by block number.
eth_getHeaderByHash — Returns only the header of a block, by hash.
eth_getHeaderByNumber — Returns only the header of a block, by number.
eth_getUncleByBlockHashAndIndex — Returns an uncle of a block, by block hash and uncle index.
eth_getUncleByBlockNumberAndIndex — Returns an uncle of a block, by block number and uncle index.
eth_getUncleCountByBlockHash — Returns the number of uncles in a block, by block hash.
eth_getUncleCountByBlockNumber — Returns the number of uncles in a block, by block number.
Transactions
eth_getRawTransactionByBlockHashAndIndex — Returns the signed, RLP-encoded bytes of a transaction, by block hash and index.
eth_getRawTransactionByBlockNumberAndIndex — Returns the signed, RLP-encoded bytes of a transaction, by block number and index.
eth_getRawTransactionByHash — Returns the signed, RLP-encoded bytes of a transaction, by hash.
eth_getTransactionByBlockHashAndIndex — Returns a transaction by block hash and its index in the block.
eth_getTransactionByBlockNumberAndIndex — Returns a transaction by block number and its index in the block.
eth_getTransactionByHash — Returns a transaction by its hash.
eth_getTransactionBySenderAndNonce — Returns the transaction an address sent with a given nonce.
eth_getTransactionReceipt — Returns the receipt of a mined transaction.
eth_pendingTransactions — Returns the transactions in the node's mempool that were sent from the node's own accounts.
eth_sendRawTransaction — Submits a signed transaction to the network.
eth_sendRawTransactionSync — Submits a signed transaction and waits until it is included in a block (EIP-7966).
Logs and filters
eth_getFilterChanges — Returns what a filter collected since it was last polled.
eth_getFilterLogs — Returns all logs that match a log filter, not only the new ones.
eth_getLogs — Returns the event logs that match a filter.
eth_newBlockFilter — Creates a filter that collects the hashes of new blocks.
eth_newFilter — Creates a log filter on the node. Poll it with
eth_getFilterChangesto receive new matching logs.eth_newPendingTransactionFilter — Creates a filter that collects the hashes of transactions entering the mempool.
eth_uninstallFilter — Removes a filter from the node.
WebSocket subscriptions
eth_subscribe — Opens a subscription over WebSocket. The node then pushes an
eth_subscriptionnotification for every event.eth_unsubscribe — Closes a subscription opened with
eth_subscribe.
Debug
debug_getRawBlock — Returns a block as RLP-encoded bytes.
debug_getRawHeader — Returns a block header as RLP-encoded bytes.
debug_getRawReceipts — Returns the receipts of a block as consensus-encoded bytes.
debug_getRawTransaction — Returns the signed, RLP-encoded bytes of a transaction.
debug_traceBlockByHash — Re-executes every transaction of a block and returns their traces, by block hash.
debug_traceBlockByNumber — Re-executes every transaction of a block and returns their traces, by block number.
debug_traceCall — Executes a call on top of a block and returns its trace, without creating a transaction.
debug_traceTransaction — Re-executes a mined transaction and returns a trace of its execution.
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