Skip to main content
POST
eth_getStorageValues
Ronin 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.
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 as 0x0000000000000000000000000000000000000000000000000000000000000001.
  • quantity or tag — the block number encoded as hexadecimal, or a block tag such as latest.

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 USDC token contract in one call.

Use case

One use case for eth_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
method
string
default:eth_getStorageValues
params
(Slots by contract · object | string)[]

An object that maps each contract address to an array of 32-byte storage slot keys. Up to 1,024 slots in total per request.

id
integer
default:1
jsonrpc
string
default:2.0

Response

200 - application/json

The storage values for each requested contract, in the order of the requested slots.

jsonrpc
string
id
integer
result
object

An object that maps each contract address (lowercase) to an array of 32-byte storage values, in the order of the requested slots.

Last modified on November 13, 2026