Updated on 2023-12-15 GMT+08:00

eth_call

Introduction

This API executes a new message call immediately without creating a transaction on the blockchain. It consumes 20 CUs. In the dedicated edition, the throughput is 15,000 per second for 8 vCPUs and 32 GB memory and 37,000 per second for 16 vCPUs and 64 GB memory.

Parameter Description

It consists of transaction-related fields and the block number.

Parameter

Type

Description

from

String

(Optional) The address from which the transaction is sent.

to

String

The address to which the transaction is directed.

gas

Integer

(Optional) The integer of gas provided for the transaction execution.

gasPrice

Integer

(Optional) The integer of gasPrice used for each paid gas encoded as hexadecimal.

value

Integer

(Optional) The integer of value sent with this transaction encoded as hexadecimal.

data

String

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

Block number

String

A hexadecimal block number, or the string (earliest, latest, or pending).

Return Value

The return value of the executed contract method.

Request

curl https://your-http-endpoint/v1/<API-KEY> \
  -X POST \
  -H "Content-Type: application/json" \
  --data '{"method":"eth_call","params":[{"from":null,"to":"0x6b175474e89094c44da98b954eedeac495271d0f","data":"0x70a082310000000000000000000000006E0d01A76C3Cf4288372a29124A26D4353EE51BE"}, "latest"],"id":1,"jsonrpc":"2.0"}'