Get storage entry value

POST

https://dot-assethub.nownodes.io/

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the value of a storage entry.

The state_getStorage method retrieves the actual value of a specific storage entry at an optional block. This is the primary method for reading chain state data including account balances, staking information, and other on-chain data.

This method is essential for:

Reading account balances and information
Querying staking and governance data
Accessing smart contract state
Building blockchain explorers

Body

application/json

jsonrpcstring2.0required

JSON-RPC version identifier

methodstringstate_getStoragerequired

The method to be invoked

idinteger | stringrequired

Request identifier for matching responses

paramsArray<string | string>required

Array containing storage key and optional block hash.

Show child attributes

One of

Storage key in hex format

string

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

string

Response

200OK

Storage value retrieved successfully

400Bad Request

Invalid storage key or block hash

500Internal Server Error

Internal server error

Get storage entry value

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

import { JsonRpcProvider } from "ethers";

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

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

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

import { createPublicClient, http } from "viem";

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

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

console.log(result);

const endpoint = "https://dot-assethub.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_getStorage", params: [
  "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
  "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
], id: 1 });
console.log(result);

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

const data = await response.json();

import requests

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

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

require 'net/http'
require 'json'

uri = URI('https://dot-assethub.nownodes.io/')
request = Net::HTTP::Post.new(uri)
request['Content-Type'] = 'application/json'
request.body = '{
    "jsonrpc": "2.0",
    "method": "state_getStorage",
    "id": 1,
    "params": [
      "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
      "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_getStorage",
  "id": 1,
  "params": [
    "0x26aa394eea5630e07c48ae0c9558cef7b99d880ec681799c0cf30e8886371da9",
    "0xabcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890"
  ]
}

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

{
  "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 retrieving storage value"
  }
}

Documentation

How to migrate to NOWNodes

Get storage entry value

Authorizations

Body

Response