Query storage at specific block

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 at a specific block.

The state_queryStorageAt method retrieves the values of multiple storage keys at an optional block hash. This is useful for batch queries and fetching related storage entries efficiently in a single request.

This method is essential for:

Batch storage queries
Fetching related data efficiently
Building complex data views
Optimizing application performance

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_queryStorageAtrequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<Array<string> | string>required

Array containing storage keys and optional block hash.

Show child attributes

One of

Array<string>

Optional block hash to query storage at specific block. If omitted, uses the latest finalized block.

string

Response

200OK

Storage values retrieved successfully

400Bad Request

Invalid storage keys or block hash

500Internal Server Error

Internal server error

Query storage at specific block

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

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://dot.nownodes.io/");
const result = await provider.send("state_queryStorageAt", [
  [
    "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
    "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
  ],
  "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_queryStorageAt",
  "params": [
    [
      "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
      "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
    ],
    "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_queryStorageAt", [
  [
    "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
    "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
  ],
  "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
])
print(response)

import { createPublicClient, http } from "viem";

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

const result = await client.request({
  method: "state_queryStorageAt",
  params: [
  [
    "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
    "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
  ],
  "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_queryStorageAt", params: [
  [
    "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
    "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
  ],
  "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_queryStorageAt",
      "id": 1,
      "params": [
        [
          "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
          "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
        ],
        "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "state_queryStorageAt",
  "id": 1,
  "params": [
    [
      "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
      "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
    ],
    "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_queryStorageAt",
    "id": 1,
    "params": [
      [
        "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
        "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
      ],
      "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_queryStorageAt",
  "id": 1,
  "params": [
    [
      "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
      "0x1a4c15312a6e6e5a7a6b4b5a4c3b2a1a0a9a8a7a6a5a4a3a2a1a0a9a8a7a6a5a4"
    ],
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

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

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

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

Documentation

How to migrate to NOWNodes

Query storage at specific block

Authorizations

Body

Response