Query storage changes over a range of blocks

POST

https://dot.nownodes.io/

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns storage entries for multiple keys over a range of blocks.

The state_queryStorage method retrieves the historical changes of storage keys between two blocks. This is essential for tracking state changes over time, building historical data views, and analyzing storage evolution.

This method is essential for:

Historical data analysis
State change tracking
Building time-series data
Audit and compliance reporting

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_queryStoragerequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<Array<string> | string | string>required

Array containing storage keys, start block hash, and optional end block hash.

Show child attributes

One of

Array<string>

Start block hash for the query range

string

Optional end block hash for the query range. If omitted, uses the latest finalized block.

string

Response

200OK

Storage changes retrieved successfully

400Bad Request

Invalid parameters

500Internal Server Error

Internal server error

Query storage changes over a range of blocks

curl -X POST 'https://dot.nownodes.io/' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "state_queryStorage",
    "id": 1,
    "params": [
      [
        "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
        "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
      ],
      "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
      "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
    ]
  }'

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://dot.nownodes.io/");
const result = await provider.send("state_queryStorage", [
  [
    "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
    "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
  ],
  "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
]);
console.log(result);

require 'eth'
require 'json'
require 'net/http'

uri = URI('https://dot.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
  "jsonrpc": "2.0",
  "method": "state_queryStorage",
  "params": [
    [
      "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
      "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
    ],
    "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ],
  "id": 1
}'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end

puts JSON.parse(response.body)

from web3 import Web3

w3 = Web3(Web3.HTTPProvider("https://dot.nownodes.io/"))
response = w3.provider.make_request("state_queryStorage", [
  [
    "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
    "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
  ],
  "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
])
print(response)

import { createPublicClient, http } from "viem";

const client = createPublicClient({
  transport: http("https://dot.nownodes.io/"),
});

const result = await client.request({
  method: "state_queryStorage",
  params: [
  [
    "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
    "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
  ],
  "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
],
});

console.log(result);

const endpoint = "https://dot.nownodes.io/";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({ jsonrpc: "2.0", method: "state_queryStorage", params: [
  [
    "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
    "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
  ],
  "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
  "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
], id: 1 });
console.log(result);

const response = await fetch('https://dot.nownodes.io/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "state_queryStorage",
      "id": 1,
      "params": [
        [
          "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
          "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
        ],
        "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
        "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "state_queryStorage",
  "id": 1,
  "params": [
    [
      "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
      "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
    ],
    "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

response = requests.post('https://dot.nownodes.io/', json=payload)
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://dot.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "jsonrpc": "2.0",
    "method": "state_queryStorage",
    "id": 1,
    "params": [
      [
        "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
        "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
      ],
      "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
      "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
    ]
  }'

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

Request Body

{
  "jsonrpc": "2.0",
  "method": "state_queryStorage",
  "id": 1,
  "params": [
    [
      "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
      "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
    ],
    "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    {
      "block": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
      "changes": [
        [
          "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
          "0x0000000000000000000000000000000000000000000000000000000000000000"
        ],
        [
          "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4",
          null
        ]
      ]
    },
    {
      "block": "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
      "changes": [
        [
          "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
          "0x0100000000000000000000000000000000000000000000000000000000000000"
        ],
        [
          "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4",
          "0x0200000000000000000000000000000000000000000000000000000000000000"
        ]
      ]
    }
  ]
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "Invalid params",
    "data": "Invalid block hash format"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32603,
    "message": "Internal error",
    "data": "Error querying storage history"
  }
}

Documentation

How to migrate to NOWNodes

Query storage changes over a range of blocks

Authorizations

Body

Response