eth_getStorageValues
curl --request POST \
--url https://optimism-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e \
--header 'Content-Type: application/json' \
--data '
{
"method": "eth_getStorageValues",
"params": [
{
"0x4200000000000000000000000000000000000006": [
"0x0000000000000000000000000000000000000000000000000000000000000000",
"0x0000000000000000000000000000000000000000000000000000000000000001",
"0x0000000000000000000000000000000000000000000000000000000000000002"
]
},
"latest"
],
"id": 1,
"jsonrpc": "2.0"
}
'import requests
url = "https://optimism-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e"
payload = {
"method": "eth_getStorageValues",
"params": [{ "0x4200000000000000000000000000000000000006": ["0x0000000000000000000000000000000000000000000000000000000000000000", "0x0000000000000000000000000000000000000000000000000000000000000001", "0x0000000000000000000000000000000000000000000000000000000000000002"] }, "latest"],
"id": 1,
"jsonrpc": "2.0"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
method: 'eth_getStorageValues',
params: [
{
'0x4200000000000000000000000000000000000006': [
'0x0000000000000000000000000000000000000000000000000000000000000000',
'0x0000000000000000000000000000000000000000000000000000000000000001',
'0x0000000000000000000000000000000000000000000000000000000000000002'
]
},
'latest'
],
id: 1,
jsonrpc: '2.0'
})
};
fetch('https://optimism-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://optimism-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'method' => 'eth_getStorageValues',
'params' => [
[
'0x4200000000000000000000000000000000000006' => [
'0x0000000000000000000000000000000000000000000000000000000000000000',
'0x0000000000000000000000000000000000000000000000000000000000000001',
'0x0000000000000000000000000000000000000000000000000000000000000002'
]
],
'latest'
],
'id' => 1,
'jsonrpc' => '2.0'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://optimism-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e"
payload := strings.NewReader("{\n \"method\": \"eth_getStorageValues\",\n \"params\": [\n {\n \"0x4200000000000000000000000000000000000006\": [\n \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"0x0000000000000000000000000000000000000000000000000000000000000001\",\n \"0x0000000000000000000000000000000000000000000000000000000000000002\"\n ]\n },\n \"latest\"\n ],\n \"id\": 1,\n \"jsonrpc\": \"2.0\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://optimism-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e")
.header("Content-Type", "application/json")
.body("{\n \"method\": \"eth_getStorageValues\",\n \"params\": [\n {\n \"0x4200000000000000000000000000000000000006\": [\n \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"0x0000000000000000000000000000000000000000000000000000000000000001\",\n \"0x0000000000000000000000000000000000000000000000000000000000000002\"\n ]\n },\n \"latest\"\n ],\n \"id\": 1,\n \"jsonrpc\": \"2.0\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://optimism-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"method\": \"eth_getStorageValues\",\n \"params\": [\n {\n \"0x4200000000000000000000000000000000000006\": [\n \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"0x0000000000000000000000000000000000000000000000000000000000000001\",\n \"0x0000000000000000000000000000000000000000000000000000000000000002\"\n ]\n },\n \"latest\"\n ],\n \"id\": 1,\n \"jsonrpc\": \"2.0\"\n}"
response = http.request(request)
puts response.read_body{
"jsonrpc": "<string>",
"id": 123,
"result": {}
}Optimism node API
eth_getStorageValues | Optimism
Optimism API method that returns the values of up to 1,024 storage slots across one or more smart contracts in a single call. Use it on Optimism via Chainstack.
POST
/
mt_c524ad9781ae5dccd9ac6f5b0370e
eth_getStorageValues
curl --request POST \
--url https://optimism-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e \
--header 'Content-Type: application/json' \
--data '
{
"method": "eth_getStorageValues",
"params": [
{
"0x4200000000000000000000000000000000000006": [
"0x0000000000000000000000000000000000000000000000000000000000000000",
"0x0000000000000000000000000000000000000000000000000000000000000001",
"0x0000000000000000000000000000000000000000000000000000000000000002"
]
},
"latest"
],
"id": 1,
"jsonrpc": "2.0"
}
'import requests
url = "https://optimism-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e"
payload = {
"method": "eth_getStorageValues",
"params": [{ "0x4200000000000000000000000000000000000006": ["0x0000000000000000000000000000000000000000000000000000000000000000", "0x0000000000000000000000000000000000000000000000000000000000000001", "0x0000000000000000000000000000000000000000000000000000000000000002"] }, "latest"],
"id": 1,
"jsonrpc": "2.0"
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
method: 'eth_getStorageValues',
params: [
{
'0x4200000000000000000000000000000000000006': [
'0x0000000000000000000000000000000000000000000000000000000000000000',
'0x0000000000000000000000000000000000000000000000000000000000000001',
'0x0000000000000000000000000000000000000000000000000000000000000002'
]
},
'latest'
],
id: 1,
jsonrpc: '2.0'
})
};
fetch('https://optimism-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://optimism-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'method' => 'eth_getStorageValues',
'params' => [
[
'0x4200000000000000000000000000000000000006' => [
'0x0000000000000000000000000000000000000000000000000000000000000000',
'0x0000000000000000000000000000000000000000000000000000000000000001',
'0x0000000000000000000000000000000000000000000000000000000000000002'
]
],
'latest'
],
'id' => 1,
'jsonrpc' => '2.0'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://optimism-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e"
payload := strings.NewReader("{\n \"method\": \"eth_getStorageValues\",\n \"params\": [\n {\n \"0x4200000000000000000000000000000000000006\": [\n \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"0x0000000000000000000000000000000000000000000000000000000000000001\",\n \"0x0000000000000000000000000000000000000000000000000000000000000002\"\n ]\n },\n \"latest\"\n ],\n \"id\": 1,\n \"jsonrpc\": \"2.0\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://optimism-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e")
.header("Content-Type", "application/json")
.body("{\n \"method\": \"eth_getStorageValues\",\n \"params\": [\n {\n \"0x4200000000000000000000000000000000000006\": [\n \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"0x0000000000000000000000000000000000000000000000000000000000000001\",\n \"0x0000000000000000000000000000000000000000000000000000000000000002\"\n ]\n },\n \"latest\"\n ],\n \"id\": 1,\n \"jsonrpc\": \"2.0\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://optimism-mainnet.core.chainstack.com/mt_c524ad9781ae5dccd9ac6f5b0370e")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"method\": \"eth_getStorageValues\",\n \"params\": [\n {\n \"0x4200000000000000000000000000000000000006\": [\n \"0x0000000000000000000000000000000000000000000000000000000000000000\",\n \"0x0000000000000000000000000000000000000000000000000000000000000001\",\n \"0x0000000000000000000000000000000000000000000000000000000000000002\"\n ]\n },\n \"latest\"\n ],\n \"id\": 1,\n \"jsonrpc\": \"2.0\"\n}"
response = http.request(request)
puts response.read_body{
"jsonrpc": "<string>",
"id": 123,
"result": {}
}Optimism API method that returns the values stored at multiple storage slots, across one or more smart contracts, in a single call. It replaces a batch of eth_getStorageAt requests when you read several slots at the same block, for example to snapshot a contract’s state.
The examples read slots
Get your own node endpoint todayStart for free and get your app to production levels immediately. No credit card required.You can sign up with your GitHub, X, Google, or Microsoft account.
Parameters
object— an object that maps each contract address to an array of storage slot keys. Pass each key as a full 32-byte hex value, such as0x0000000000000000000000000000000000000000000000000000000000000001.quantity or tag— the block number encoded as hexadecimal, or a block tag such aslatest.
Response
result — an object that maps each requested contract address, in lowercase, to an array of 32-byte storage values in the same order as the requested slots.
A request with no slots returns -32602 with empty request, and a request with more than 1,024 slots returns -32602 with total slot count <count> exceeds limit 1024.
eth_getStorageValues code examples
The examples read slots 0, 1, and 2 of the WETH contract, which hold the token name, symbol, and decimals, in one call.
const { ethers } = require("ethers");
const provider = new ethers.JsonRpcProvider("YOUR_CHAINSTACK_ENDPOINT");
const slot = (n) => ethers.zeroPadValue(ethers.toBeHex(n), 32);
const getStorageValues = async () => {
const values = await provider.send("eth_getStorageValues", [
{
"0x4200000000000000000000000000000000000006": [slot(0), slot(1), slot(2)],
},
"latest",
]);
console.log(values);
};
getStorageValues();
from web3 import Web3
w3 = Web3(Web3.HTTPProvider("YOUR_CHAINSTACK_ENDPOINT"))
def slot(n):
return "0x" + format(n, "064x")
response = w3.provider.make_request("eth_getStorageValues", [
{
"0x4200000000000000000000000000000000000006": [slot(0), slot(1), slot(2)],
},
"latest",
])
print(response["result"])
Use case
One use case foreth_getStorageValues is reading a consistent snapshot of several contracts’ internal state. All slots come from the same block in one round trip, so a monitoring service that tracks owners, balances, or configuration slots across many contracts avoids both the request overhead of separate eth_getStorageAt calls and the risk of reading different slots at different blocks.Body
application/json
Last modified on November 13, 2026
Was this page helpful?