state_getStorage

Returns a storage entry at a specific key on Polkadot.

Why Polkadot? Build on the heterogeneous multi-chain protocol with $300M+ DeFi TVL and JAM supercomputer upgrade incoming with shared relay chain security, XCM cross-chain messaging, JAM upgrade targeting 1M TPS, and 2.1B DOT supply cap.

Use Cases

• State queries - Read on-chain storage values
• Account balances - Query account data for cross-chain DeFi, parachain deployment, XCM interoperability, and DOT staking (8-10% APY)
• Pallet storage - Access runtime storage items
• Historical state - Query state at specific blocks

Parameters

Parameter	Type	Required	Description
key	String	Yes	Storage key (hex-encoded)
blockHash	String	No	Block hash for historical query

Request

{
  "jsonrpc": "2.0",
  "method": "state_getStorage",
  "params": [""],
  "id": 1
}

Code Examples

cURL

curl https://api-polkadot.n.dwellir.com/YOUR_API_KEY \
  -X POST \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "method": "state_getStorage",
    "params": [""],
    "id": 1
  }'

JavaScript

import { ApiPromise, WsProvider } from '@polkadot/api';

const provider = new WsProvider('wss://api-polkadot.n.dwellir.com/YOUR_API_KEY');
const api = await ApiPromise.create({ provider });

// Query account balance
const account = '5GrwvaEF5zXb26Fz9rcQpDWS57CtERHpNehXCPcNoHGKutQY';
const accountInfo = await api.query.system.account(account);
console.log('Free balance:', accountInfo.data.free.toString());

// Query at specific block
const blockHash = '0x91b171bb158e2d3848fa23a9f1c25182fb8e20313b2c1eb49219da7a70ce90c3';
const historicalBalance = await api.query.system.account.at(blockHash, account);
console.log('Historical balance:', historicalBalance.data.free.toString());

await api.disconnect();

Python

import requests

def get_storage(key, block_hash=None):
    url = 'https://api-polkadot.n.dwellir.com/YOUR_API_KEY'
    params = [key] if block_hash is None else [key, block_hash]

    payload = {
        'jsonrpc': '2.0',
        'method': 'state_getStorage',
        'params': params,
        'id': 1
    }

    response = requests.post(url, json=payload)
    return response.json()['result']

# Query :code storage (runtime wasm)
storage_key = ''
value = get_storage(storage_key)
print(f'Storage value: {value[:66]}...' if value else 'None')

Related Methods

• state_getMetadata - Get runtime metadata
• state_getKeysPaged - Enumerate storage keys