eth_call - Robinhood

Example code for the eth_call JSON-RPC method. Complete guide to using the eth_call JSON-RPC method in GetBlock.io Web3 documentation.

Executes a read-only contract call without creating a transaction. The canonical way to call view/pure functions on contracts — including reading Stock Token balances via balanceOf(address). Does not consume gas (gas estimate is informational only) and does not modify state.

Parameters

Parameter	Type	Required	Description
callObject	object	Yes	Call params: from (optional), to, gas (optional), gasPrice (optional), value (optional), data
block	QUANTITY	TAG	Yes

Request Example

cURL

curl --location --request POST 'https://shared.us-east-1.getblock.io/<ACCESS-TOKEN>/' \
--header 'Content-Type: application/json' \
--data-raw '{
    "jsonrpc": "2.0",
    "method": "eth_call",
    "params": [
        {
            "to": "0x9c8f0e4f8d2e7c6b5a4f3e2d1c0b9a8e7f6d5c4b",
            "data": "0x70a082310000000000000000000000007a25d0f0Ff6a25f36De0a19C3d5f6dC2C6EAeD6a"
        },
        "latest"
    ],
    "id": "getblock.io"
}'

JavaScript (Axios)

import axios from 'axios';

const data = JSON.stringify({
    "jsonrpc": "2.0",
    "method": "eth_call",
    "params": [
        {
            "to": "0x9c8f0e4f8d2e7c6b5a4f3e2d1c0b9a8e7f6d5c4b",
            "data": "0x70a082310000000000000000000000007a25d0f0Ff6a25f36De0a19C3d5f6dC2C6EAeD6a"
        },
        "latest"
    ],
    "id": "getblock.io"
});

const config = {
    method: 'post',
    url: 'https://shared.us-east-1.getblock.io/<ACCESS-TOKEN>/',
    headers: {
        'Content-Type': 'application/json'
    },
    data: data
};

axios(config)
    .then(response => console.log(JSON.stringify(response.data, null, 2)))
    .catch(error => console.log(error));

Python (Requests)

import requests
import json

url = "https://shared.us-east-1.getblock.io/<ACCESS-TOKEN>/"

payload = json.dumps({
    "jsonrpc": "2.0",
    "method": "eth_call",
    "params": [
        {
            "to": "0x9c8f0e4f8d2e7c6b5a4f3e2d1c0b9a8e7f6d5c4b",
            "data": "0x70a082310000000000000000000000007a25d0f0Ff6a25f36De0a19C3d5f6dC2C6EAeD6a"
        },
        "latest"
    ],
    "id": "getblock.io"
})

headers = {
    'Content-Type': 'application/json'
}

response = requests.post(url, headers=headers, data=payload)
print(response.text)

Rust (Reqwest)

use reqwest::Client;
use serde_json::json;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();

    let payload = json!({
        "jsonrpc": "2.0",
        "method": "eth_call",
        "params": [
                {
                        "to": "0x9c8f0e4f8d2e7c6b5a4f3e2d1c0b9a8e7f6d5c4b",
                        "data": "0x70a082310000000000000000000000007a25d0f0Ff6a25f36De0a19C3d5f6dC2C6EAeD6a"
                },
                "latest"
        ],
        "id": "getblock.io"
});

    let response = client
        .post("https://shared.us-east-1.getblock.io/<ACCESS-TOKEN>/")
        .header("Content-Type", "application/json")
        .json(&payload)
        .send()
        .await?;

    let result: serde_json::Value = response.json().await?;
    println!("{:#?}", result);

    Ok(())
}

Response Example

{
    "jsonrpc": "2.0",
    "id": "getblock.io",
    "result": "0x000000000000000000000000000000000000000000000000016345785d8a0000"
}

Response Parameters

Field	Type	Description
result	DATA	ABI-encoded return value

Use Cases

• Reading Stock Token balances, total supply, name, symbol, decimals

• Calling view/pure functions on any contract

• Pre-flight simulation of state-changing calls (with caveats)

Error Handling

Status Code	Error Message	Cause
403	Forbidden	Missing or invalid <ACCESS-TOKEN>
-32602	Invalid params	Request parameters are missing or malformed
-32603	Internal error	Server-side error while processing the request
429	Too Many Requests	Rate limit exceeded for your plan
3	execution reverted	Contract execution reverted — the contract's logic rejected the call
-32602	Invalid call object	Malformed call parameters

SDK Integration

ethers.js

import { ethers } from 'ethers';

const provider = new ethers.JsonRpcProvider('https://shared.us-east-1.getblock.io/<ACCESS-TOKEN>/');

// Generic JSON-RPC call (works for any method):
const result = await provider.send('eth_call', [{"to": "0x9c8f0e4f8d2e7c6b5a4f3e2d1c0b9a8e7f6d5c4b", "data": "0x70a082310000000000000000000000007a25d0f0Ff6a25f36De0a19C3d5f6dC2C6EAeD6a"}, "latest"]);
console.log(result);

// Many standard methods have typed wrappers on ethers Provider,
// e.g. provider.getBalance(addr), provider.getBlock(n), provider.getTransaction(hash).

viem

import { createPublicClient, http } from 'viem';

const client = createPublicClient({
    transport: http('https://shared.us-east-1.getblock.io/<ACCESS-TOKEN>/')
});

// Generic JSON-RPC request (works for any method):
const result = await client.request({
    method: 'eth_call',
    params: [{"to": "0x9c8f0e4f8d2e7c6b5a4f3e2d1c0b9a8e7f6d5c4b", "data": "0x70a082310000000000000000000000007a25d0f0Ff6a25f36De0a19C3d5f6dC2C6EAeD6a"}, "latest"]
});
console.log(result);

// Many standard methods have typed wrappers on PublicClient,
// e.g. client.getBalance({ address }), client.getBlock({ blockNumber }).