BLblockscout
Contracts

Read contract

Calls a smart contract function (view/pure, or non-view/pure simulated via eth_call) and returns the decoded result.

get/read_contract

Request

Query parameters

chain_idstring required

The ID of the blockchain

addressstring required

Smart contract address

abistring required

The JSON ABI for the specific function being called. This should be a dictionary that defines the function's name, inputs, and outputs. The function ABI can be obtained using the get_contract_abi tool.

function_namestring required

The symbolic name of the function to be called. This must match the name field in the provided ABI.

argsstring

A JSON string containing an array of arguments. Order and types must match ABI inputs. For addresses use 0x-prefixed strings; For numbers use integers (not quoted); For bytes keep as 0x-hex strings.

blockstring

The block identifier to read the contract state from. Can be a block number (e.g., 19000000) or a string tag (e.g., 'latest'). Defaults to 'latest'.

Response

Contract function call result

data_descriptionstring[] nullable

Optional list of strings explaining the structure or fields of the data payload

notesstring[] nullable

Optional list of important warnings or contextual notes, such as data truncation alerts

instructionsstring[] nullable

Optional list of suggested follow-up actions for an AI agent

Changes

No recorded changes to this operation across all 15 revisions of this API.