Skip to main content

eth_call RPC Method

Executes a new message call immediately without creating a transaction on the block chain.

Updated on
Aug 31, 2026

Parameters

transaction
object
REQUIRED

The transaction call object which contains the following fields:

from
string

The address from which the transaction is sent

to
string
REQUIRED

The address to which the transaction is addressed

gas
string

The integer of gas provided for the transaction execution

gasPrice
string

The integer of gasPrice used for each paid gas encoded as hexadecimal

value
string

The integer of value sent with this transaction encoded as hexadecimal

data
string

The hash of the method signature and encoded parameters. For more information, see the Contract ABI description in the Solidity documentation

blockNumber/tag
string
REQUIRED

The block number in hexadecimal format or one of the tags latest, earliest, pending, safe, or finalized

Object
object

The State Override Set option allows you to change the state of a contract before executing the call, which means you can modify the values of variables stored in the contract, such as balances and approvals for that call without actually modifying the contract. Each address maps to an object containing:

balance
string

The fake balance to set for the account before executing the call

nonce
string

The fake nonce to set for the account before executing the call

code
string

The fake EVM bytecode to inject into the account before executing the call

state
string

The fake key-value mapping to override all slots in the account storage before executing the call

stateDiff
object

The fake key-value mapping to override individual slots in the account storage before executing the call

Returns

data
string

The return value of the executed contract method

Request
Response
1
{
2
"jsonrpc": "2.0",
3
"result": "0x0000000000000000000000000000000000000000000000000000000000000000",
4
"id": 1
5
}
1
{
2
"jsonrpc": "2.0",
3
"result": "0x0000000000000000000000000000000000000000000000000000000000000000",
4
"id": 1
5
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free