eth_callHTTP

Simulates a message call at a selected state without publishing a transaction or charging an on-chain fee. Execution can still consume node resources or revert; simulated state changes are discarded.

Chain EthereumTransport HTTPTry-it live

How to use

  1. Pick an API key (or paste one) in the Try it panel.
  2. Object params use a tall JSON editor — click Fill example if available.
  3. Send request — live against the gateway; counts toward daily quota.

Parameters

JSON-RPC positional arguments — order matches the array sent in params. Index badges below match array positions.

callObjectrequired

Transaction call object (JSON).

  • todestination; omit only for supported contract-creation simulations
  • inputhex call bytes; data is a supported alias, but do not send conflicting values
  • fromoptional simulated sender (affects msg.sender)
  • gasoptional execution gas ceiling as hex
  • valuenative-currency value in smallest units as hex
  • gasPricelegacy fee per gas; do not combine with dynamic-fee fields
  • maxFeePerGasdynamic-fee cap where supported
  • maxPriorityFeePerGasexecution tip cap where supported
  • accessListoptional addresses and storage keys to pre-warm where supported
blockQUANTITY|TAGoptional

Hex block number or tag; omitted means latest on clients following the current execution API. Send latest explicitly for compatibility. State is evaluated after that block. Historical state must remain available. Tags and finality guarantees vary by network. In Advanced JSON mode, clients supporting EIP-1898 also accept {"blockHash":"0x...","requireCanonical":true} or {"blockNumber":"0x..."}; do not combine both keys, and use requireCanonical only with blockHash.

Tags
latestearliestsafefinalizedpending
Defaultlatest

params array (shape)

eth_call · paramsjson
1[
2 {
3 "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
4 "data": "0x313ce567"
5 },
6 "latest"
7]

Response fields

The result row describes the complete result; other rows describe its object fields or array elements. Indented rows describe nested members. For subscriptions,params.* rows describe later notifications rather than the initial reply.

FieldTypeDescription
resultDATARaw return bytes; decode using the called contract's ABI. Empty 0x alone does not establish that the address contains the expected contract or that a particular ABI call succeeded.