Query storage entries at a specific block

POST

https://atleta.nownodes.io/state_queryStorageAt

Authorizations

ApiKeyAuthApiKeyAuth

API_key string

NOWNodes API key passed in the api-key header.

Queries storage entries by key starting at a specific block hash.

Body

application/json

API_keystring

jsonrpcstring

idinteger

methodstring

paramsarray

First parameter: array of state keys (hex-encoded) to query.
Second parameter: block hash to retrieve the state from.

Response

200OK

Successfully retrieved storage entries at the specified block

400Bad Request

Bad Request

500Internal Server Error

Internal Server Error

Query storage entries at a specific block

curl -X POST 'https://atleta.nownodes.io/state_queryStorageAt' \
  -H 'Content-Type: application/json' \
  -d '{
    "API_key": "your_API_key",
    "jsonrpc": "2.0",
    "id": 1,
    "method": "state_queryStorageAt",
    "params": [
      [
        "0x26aa394eea5630e07c48ae0c9558cef7"
      ],
      "0x298f8c5f8572a869abe215216c0b12b255bc325407dd115b410dd0224418baa4"
    ]
  }'

import { JsonRpcProvider } from "ethers";

const provider = new JsonRpcProvider("https://atleta.nownodes.io/state_queryStorageAt");
const result = await provider.send("state_queryStorageAt", [
  [
    "0x26aa394eea5630e07c48ae0c9558cef7"
  ],
  "0x298f8c5f8572a869abe215216c0b12b255bc325407dd115b410dd0224418baa4"
]);
console.log(result);

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

uri = URI('https://atleta.nownodes.io/state_queryStorageAt')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
  "jsonrpc": "2.0",
  "method": "state_queryStorageAt",
  "params": [
    [
      "0x26aa394eea5630e07c48ae0c9558cef7"
    ],
    "0x298f8c5f8572a869abe215216c0b12b255bc325407dd115b410dd0224418baa4"
  ],
  "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://atleta.nownodes.io/state_queryStorageAt"))
response = w3.provider.make_request("state_queryStorageAt", [
  [
    "0x26aa394eea5630e07c48ae0c9558cef7"
  ],
  "0x298f8c5f8572a869abe215216c0b12b255bc325407dd115b410dd0224418baa4"
])
print(response)

import { createPublicClient, http } from "viem";

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

const result = await client.request({
  method: "state_queryStorageAt",
  params: [
  [
    "0x26aa394eea5630e07c48ae0c9558cef7"
  ],
  "0x298f8c5f8572a869abe215216c0b12b255bc325407dd115b410dd0224418baa4"
],
});

console.log(result);

const endpoint = "https://atleta.nownodes.io/state_queryStorageAt";
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: [
  [
    "0x26aa394eea5630e07c48ae0c9558cef7"
  ],
  "0x298f8c5f8572a869abe215216c0b12b255bc325407dd115b410dd0224418baa4"
], id: 1 });
console.log(result);

const response = await fetch('https://atleta.nownodes.io/state_queryStorageAt', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "API_key": "your_API_key",
      "jsonrpc": "2.0",
      "id": 1,
      "method": "state_queryStorageAt",
      "params": [
        [
          "0x26aa394eea5630e07c48ae0c9558cef7"
        ],
        "0x298f8c5f8572a869abe215216c0b12b255bc325407dd115b410dd0224418baa4"
      ]
    }),
});

const data = await response.json();

import requests

payload = {
  "API_key": "your_API_key",
  "jsonrpc": "2.0",
  "id": 1,
  "method": "state_queryStorageAt",
  "params": [
    [
      "0x26aa394eea5630e07c48ae0c9558cef7"
    ],
    "0x298f8c5f8572a869abe215216c0b12b255bc325407dd115b410dd0224418baa4"
  ]
}

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

require 'net/http'
require 'json'

uri = URI('https://atleta.nownodes.io/state_queryStorageAt')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "API_key": "your_API_key",
    "jsonrpc": "2.0",
    "id": 1,
    "method": "state_queryStorageAt",
    "params": [
      [
        "0x26aa394eea5630e07c48ae0c9558cef7"
      ],
      "0x298f8c5f8572a869abe215216c0b12b255bc325407dd115b410dd0224418baa4"
    ]
  }'

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

Request Body

{
  "API_key": "your_API_key",
  "jsonrpc": "2.0",
  "id": 1,
  "method": "state_queryStorageAt",
  "params": [
    [
      "0x26aa394eea5630e07c48ae0c9558cef7"
    ],
    "0x298f8c5f8572a869abe215216c0b12b255bc325407dd115b410dd0224418baa4"
  ]
}

200

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": [
    [
      "0x26aa394eea5630e07c48ae0c9558cef7",
      "0x0000000000000000000000000000000000000000000000000000000000000000"
    ]
  ]
}

Documentation

How to migrate to NOWNodes

Query storage entries at a specific block

Authorizations

Body

Response