Skip to main content

eth_call

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

Gas parameter is capped

To prevent API abuse, the gas parameter in eth_estimateGas and this eth_call method is capped at 10x (1000%) the current block gas limit.

For Growth and Custom service plans

This JSON-RPC method allows a request to be forwarded to a partner service provider if Infura should experience a service issue or outage. See Failover protection and Enable API request forwarding for complete details.

If you would like failover protection but don't qualify under your current plan, then either self-upgrade to the Growth plan or contact a sales representative to upgrade to a Custom plan.

Parameters​

  • from: 20 bytes [Required] Address the transaction is sent from.
  • to: 20 bytes - Address the transaction is directed to.
  • gas: Hexadecimal value of the gas provided for the transaction execution. eth_call consumes zero gas, but this parameter may be needed by some executions.
  • gasPrice: Hexadecimal value of the gasPrice used for each paid gas.
  • maxPriorityFeePerGas: Maximum fee, in Wei, the sender is willing to pay per gas above the base fee. See EIP-1559 transactions.
  • maxFeePerGas: Maximum total fee (base fee + priority fee), in Wei, the sender is willing to pay per gas. See EIP-1559 transactions.
  • value: Hexadecimal of the value sent with this transaction.
  • data: Hash of the method signature and encoded parameters. See Ethereum contract ABI specification.
  • block parameter: [Required] A hexadecimal block number, or one of the string tags latest, earliest, pending, safe, or finalized. See the default block parameter.

Returns​

The returned value of the executed contract.

If this call causes the EVM to execute a REVERT operation, an error response of the following form is returned, with the revert reason pre-decoded as a string:

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": 3,
    "message": "execution reverted: Dai/insufficient-balance",
    "data": "0x08c379a0000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000184461692f696e73756666696369656e742d62616c616e63650000000000000000"
  }
}

Example​

Replace YOUR-API-KEY with an API key from your Infura dashboard.

Request​

curl https://polygon-mainnet.infura.io/v3/YOUR-API-KEY \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc": "2.0", "method": "eth_call", "params": [{"from": "0xb60e8dd61c5d32be8058bb8eb970870f07233155", "to": "0xd46e8dd67c5d32be8058bb8eb970870f07244567", "gas": "0x76c0", "gasPrice": "0x9184e72a000", "value": "0x9184e72a", "data": "0xd46e8dd67c5d32be8d46e8dd67c5d32be8058bb8eb970870f072445675058bb8eb970870f072445675"}, "latest"], "id": 1}'

Response​

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x"
}