Ethereum JSON-RPC
v1.0.0https://moonbeam.nownodes.ioAuthentication
api-keyAuthapiKeyAPI Key: api-key in header
ApiKeyAuthapiKeyAPI Key: api-key in header
MAINNET / EVM
eth_accounts
Ethereum method - eth_accounts
Returns an array of addresses controlled by the client.
Body
jsonrpcstringrequiredJSON-RPC version identifier
methodstringrequiredName of the JSON-RPC method
paramsarrayrequiredNo parameters are required for this method. This must be an empty array.
idintegerrequiredUnique identifier for the JSON-RPC request
Response
A list of Ethereum addresses
Authorization
api-keyAuthapiKey in headereth_blockNumber
Ethereum method - eth_blockNumber
Returns the number of the latest block on the chain in hexadecimal format.
Body
jsonrpcstringrequiredThe JSON-RPC protocol version
methodstringrequiredName of the method being called
paramsarrayrequiredThis method does not take parameters; always send an empty array.
idintegerrequiredA unique ID for the request
Response
The latest block number
Authorization
api-keyAuthapiKey in headereth_call
Ethereum method - eth_call
Executes a call to a contract or address and returns the result without broadcasting a transaction.
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<object | string>requiredThe first object specifies the call transaction object. The second (optional) parameter specifies the block context.
idintegerrequiredResponse
Result of the call
Authorization
api-keyAuthapiKey in headereth_chainId
Ethereum method - eth_chainId
Returns the hexadecimal string of the current chain ID.
Body
jsonrpcstringrequiredJSON-RPC protocol version
methodstringrequiredName of the method to call
paramsarrayrequiredThis method does not require parameters. Use an empty array.
idintegerrequiredUnique identifier for the request
Response
Chain ID response
Authorization
api-keyAuthapiKey in headereth_coinbase
eth_coinbase
Returns the Ethereum coinbase address (i.e., the address that receives mining rewards).
Body
jsonrpcstringrequiredmethodstringeth_coinbaserequiredparamsarrayrequiredThis method takes no parameters.
idintegerrequiredResponse
JSON-RPC Response with the coinbase address
Authorization
api-keyAuthapiKey in headereth_estimateGas
Estimate Gas for Transaction
Simulates a transaction and returns an estimate of how much gas would be used.
Body
jsonrpcstringrequiredJSON-RPC protocol version
methodstringrequiredThe method name
paramsArray<object | string>requiredThe transaction call object and an optional block tag.
idintegerrequiredRequest identifier
Response
Estimated gas amount
Authorization
api-keyAuthapiKey in headereth_feeHistory
eth_feeHistory
Returns fee market information for a range of blocks. This is typically used by wallets and other tools to estimate appropriate gas prices.
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string | integer | Array<number>>requiredParameters:
blockCount— number of blocks in the requested range.newestBlock— highest block number in the requested range (can be "latest").rewardPercentiles— list of percentile values to sample priority fees from each block (optional).
idintegerrequiredResponse
JSON-RPC Response with fee history data
Authorization
api-keyAuthapiKey in headereth_gasPrice
Get Suggested Gas Price
Returns the current gas price in wei as a hexadecimal string. This value is a node estimate based on recent blocks and mempool activity.
Body
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredJSON-RPC method name
paramsarrayrequiredThis method takes an empty array.
idintegerrequiredRequest identifier
Response
Suggested gas price in wei
Authorization
api-keyAuthapiKey in headereth_getBalance
Get ETH Balance of an Address
Retrieves the balance (in wei) of a given Ethereum address. You can specify the block parameter to get the balance at a specific block.
Body
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredJSON-RPC method name
paramsArray<string>requiredArray with 2 parameters:
- Address (20-byte hex string with '0x' prefix)
- Block tag (e.g., 'latest', 'earliest', 'pending', or block number in hex)
idintegerrequiredRequest ID
Response
Balance (in wei) as hex string
Authorization
api-keyAuthapiKey in headereth_getBlockByHash
Get Block by Hash
Returns the block information for the specified block hash. The second parameter indicates whether to return full transaction objects or just transaction hashes.
Body
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredJSON-RPC method name
paramsArray<string>requiredArray of parameters:
- Block hash (string)
- Boolean flag — if true, return full transactions; if false, only hashes.
idintegerrequiredRequest ID
Response
Block information
Authorization
api-keyAuthapiKey in headereth_getBlockByNumber
Get Block by Number
Returns the block information for the specified block number. The second parameter indicates whether to return full transaction objects or just transaction hashes.
Body
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredJSON-RPC method name
paramsArray<string>requiredArray of parameters:
- Block number (hex string, e.g., "0x1b4") or special tags ("latest", "earliest", "pending")
- Boolean flag — if true, return full transactions; if false, only hashes.
idintegerrequiredRequest ID
Response
Block information
Authorization
api-keyAuthapiKey in headereth_getBlockReceipts
Get All Transaction Receipts for a Block
Returns an array of transaction receipts for every transaction in the block specified by block number or block hash.
Body
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredJSON-RPC method name
paramsArray<string>requiredOne parameter:
- Block identifier, which can be either:
- block number as hex string (e.g. "0x10d4f")
- or block hash as hex string (0x-prefixed)
idintegerrequiredRequest identifier
Response
Array of transaction receipts in the block
Authorization
api-keyAuthapiKey in headereth_getBlockTransactionCountByHash
Get Transaction Count by Block Hash
Returns the number of transactions contained in the block with the given hash.
Body
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredJSON-RPC method name
paramsArray<string>requiredArray containing a single parameter:
- Block hash as a hex string (32 bytes with 0x prefix)
idintegerrequiredRequest ID
Response
Number of transactions in the block
Authorization
api-keyAuthapiKey in headereth_getBlockTransactionCountByNumber
Get Transaction Count by Block Number
Returns the number of transactions contained in the block with the given block number.
Body
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredJSON-RPC method name
paramsArray<string>requiredArray containing a single parameter:
- Block number as a hex string (e.g. "0x10d4f" for block 69007) or
- predefined block tags such as "latest", "earliest", or "pending"
idintegerrequiredRequest ID
Response
Number of transactions in the block
Authorization
api-keyAuthapiKey in headereth_getCode
Get Contract Bytecode at Address
Returns the contract code stored at a given address. If the address is an externally owned account (EOA), it returns "0x".
Body
jsonrpcstringrequiredJSON-RPC version.
methodstringrequiredJSON-RPC method name.
paramsArray<string>requiredParameters array with two elements:
- The address to get the code for (hex string, 0x-prefixed).
- The block number or block tag (e.g., "latest", "earliest", "pending").
idintegerrequiredRequest identifier.
Response
Contract bytecode in hex format
Authorization
api-keyAuthapiKey in headereth_getFilterChanges
Get Filter Changes
Returns an array of logs that occurred since the last poll for the specified filter ID. The filter must have been previously created with eth_newFilter or eth_newBlockFilter or eth_newPendingTransactionFilter.
Body
jsonrpcstringrequiredJSON-RPC version.
methodstringrequiredJSON-RPC method name.
paramsArray<string>requiredParameters array with a single element:
- The filter ID (hex string).
idintegerrequiredRequest identifier.
Response
Array of log objects or transaction hashes depending on filter type
Authorization
api-keyAuthapiKey in headereth_getFilterLogs
Get Filter Logs
Returns all logs matching a filter with the specified filter ID. The filter must have been previously created with eth_newFilter.
Body
jsonrpcstringrequiredJSON-RPC version.
methodstringrequiredJSON-RPC method name.
paramsArray<string>requiredParameters array with one element:
- The filter ID (hex string).
idintegerrequiredRequest identifier.
Response
Array of log objects matching the filter
Authorization
api-keyAuthapiKey in headereth_getLogs
Get Logs
Returns an array of logs that match the filter criteria specified in the params. The filter object supports filtering by block range, addresses, and topics.
Body
jsonrpcstringrequiredJSON-RPC version.
methodstringrequiredJSON-RPC method name.
paramsArray<object>requiredParameters array with one element: the filter object.
idintegerrequiredRequest identifier.
Response
Array of log objects matching the filter
Authorization
api-keyAuthapiKey in headereth_getStorageAt
Get Storage At
Returns the value stored at position in the storage of the contract at address at the given blockNumber.
Body
jsonrpcstringrequiredJSON-RPC version.
methodstringrequiredJSON-RPC method name.
paramsArray<string>requiredParameters array:
- address: string - Contract address to query storage from.
- position: string - Storage slot position (hex string).
- block number: string - Block number or keywords ("latest", "earliest", "pending").
idintegerrequiredRequest identifier.
Response
Storage slot value at the specified position
Authorization
api-keyAuthapiKey in headereth_getTransactionByBlockHashAndIndex
Get Transaction by Block Hash and Index
Retrieves the transaction from a block using the block's hash and the transaction's index position within the block.
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>requiredParameters:
- blockHash (string): The 32-byte hash of the block.
- transactionIndex (string): The transaction index (hex).
idintegerrequiredResponse
A transaction object or null if no transaction was found.
Authorization
api-keyAuthapiKey in headereth_getTransactionByBlockNumberAndIndex
Get Transaction by Block Number and Index
Returns the information about a transaction using the block number and the transaction index within the block.
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>requiredParameters:
- Block number in hex format (e.g., "0x5daf3b")
- Transaction index in the block (e.g., "0x0")
idintegerrequiredResponse
A transaction object, or null if not found.
Authorization
api-keyAuthapiKey in headereth_getTransactionByHash
Get transaction by hash
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>requiredArray containing a single transaction hash
idintegerrequiredResponse
Transaction object or null
Authorization
api-keyAuthapiKey in headereth_getTransactionCount
Get transaction count (nonce) for address
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>required- address: The address to check for transaction count.
- block: The block parameter (e.g., "latest", "earliest", "pending").
idintegerrequiredResponse
Hex encoded nonce (transaction count)
Authorization
api-keyAuthapiKey in headereth_getTransactionReceipt
Get transaction receipt by hash
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>requiredidintegerrequiredResponse
Transaction receipt if mined, otherwise null
Authorization
api-keyAuthapiKey in headereth_getUncleByBlockHashAndIndex
Get uncle block by block hash and index
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>requiredblockHash: 32-byte block hashindex: the uncle index as hex (e.g., "0x0" for the first uncle)
idintegerrequiredResponse
Uncle block object or null
Authorization
api-keyAuthapiKey in headereth_getUncleByBlockNumberAndIndex
Get uncle block by block number and index
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>requiredblockNumber: The block number as hex string (e.g., "0x10fb78"), or "latest", "earliest", "pending".index: The uncle index as hex (e.g., "0x0" for the first uncle).
idintegerrequiredResponse
Uncle block object or null
Authorization
api-keyAuthapiKey in headereth_getUncleCountByBlockHash
Get the number of uncle blocks by block hash
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>requiredAn array containing the block hash.
idintegerrequiredResponse
Number of uncles in the block
Authorization
api-keyAuthapiKey in headereth_getUncleCountByBlockNumber
Get the number of uncle blocks by block number
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>requiredAn array containing the block number as a hex string.
idintegerrequiredResponse
Number of uncle blocks in the block
Authorization
api-keyAuthapiKey in headereth_hashrate
eth_hashrate
Returns the current mining hashrate reported by the client.
Body
jsonrpcstringrequiredmethodstringeth_hashraterequiredparamsarrayrequiredThis method takes no parameters.
idintegerrequiredResponse
JSON-RPC response with the current mining hashrate
Authorization
api-keyAuthapiKey in headereth_maxPriorityFeePerGas
Get recommended maxPriorityFeePerGas value
Body
jsonrpcstringrequiredmethodstringrequiredparamsarrayrequiredNo parameters are required.
idintegerrequiredResponse
Returns the suggested maxPriorityFeePerGas value
Authorization
api-keyAuthapiKey in headereth_mining
eth_mining
Checks whether the Ethereum client is actively mining.
Body
jsonrpcstringrequiredmethodstringeth_miningrequiredparamsarrayrequiredThis method does not accept parameters.
idintegerrequiredResponse
JSON-RPC Response indicating mining status
Authorization
api-keyAuthapiKey in headereth_newBlockFilter
Create a new block filter
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<any>requiredThis method does not require any parameters.
idintegerrequiredResponse
Filter ID created successfully
Authorization
api-keyAuthapiKey in headereth_newFilter
Create a new log filter
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<object>requiredArray with one object describing the filter options.
idintegerrequiredResponse
Filter ID created successfully
Authorization
api-keyAuthapiKey in headereth_newPendingTransactionFilter
Create a filter for pending transactions
Body
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredJSON-RPC method name
paramsArray<any>requiredNo parameters required for this method
idintegerrequiredRequest identifier
Response
Filter ID created successfully
Authorization
api-keyAuthapiKey in headereth_sendRawTransaction
Send a raw signed transaction
Body
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredMethod name
paramsArray<string>requiredArray containing a single signed transaction data (hex string)
idintegerrequiredRequest ID
Response
Transaction successfully sent
Authorization
api-keyAuthapiKey in headereth_sendTransaction
Send a transaction using node-managed account
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<object>requiredTransaction object
idintegerrequiredResponse
Transaction successfully sent
Authorization
api-keyAuthapiKey in headereth_sign
Sign arbitrary data using eth_sign
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>required[address, data]
- address: The account that will sign the data
- data: The data to be signed (must be a hex string)
idintegerrequiredResponse
Returns the signature of the message
Authorization
api-keyAuthapiKey in headereth_signTransaction
eth_signTransaction
Signs a transaction locally with the private key of the specified account.
Body
jsonrpcstringrequiredmethodstringeth_signTransactionrequiredparamsArray<object>requiredArray with a single object representing the transaction to sign.
idintegerrequiredResponse
JSON-RPC response with the signed transaction data
Authorization
api-keyAuthapiKey in headereth_syncing
Check if node is syncing
Body
jsonrpcstringrequiredmethodstringrequiredparamsarrayrequiredMust be an empty array.
idintegerrequiredResponse
Returns sync status object or false
Authorization
api-keyAuthapiKey in headereth_uninstallFilter
Uninstall an existing filter
Body
jsonrpcstringrequiredmethodstringrequiredparamsArray<string>requiredidintegerrequiredResponse
Success or failure of the uninstall operation
Authorization
api-keyAuthapiKey in headernet_listening
net_listening
Checks if the client is listening for network connections.
Body
jsonrpcstringrequiredmethodstringnet_listeningrequiredparamsarrayrequiredThis method takes no parameters.
idintegerrequiredResponse
JSON-RPC response with listening status
Authorization
api-keyAuthapiKey in headernet_peerCount
net_peerCount
Returns the number of peers currently connected to the client.
Body
jsonrpcstringrequiredmethodstringnet_peerCountrequiredparamsarrayrequiredThis method takes no parameters.
idintegerrequiredResponse
JSON-RPC response with the number of connected peers
Authorization
api-keyAuthapiKey in headernet_version
net_version
Returns the current network ID of the Ethereum client.
Body
jsonrpcstringrequiredmethodstringnet_versionrequiredparamsarrayrequiredThis method takes no parameters.
idintegerrequiredResponse
JSON-RPC response with the current network ID
Authorization
api-keyAuthapiKey in headerweb3_clientVersion
web3_clientVersion
Returns the current Ethereum client version.
Body
jsonrpcstringrequiredmethodstringweb3_clientVersionrequiredparamsarrayrequiredThis method takes no parameters.
idintegerrequiredResponse
JSON-RPC response with the client version string
Authorization
api-keyAuthapiKey in headerweb3_sha3
web3_sha3
Computes the Keccak-256 (SHA-3) hash of the given hex-encoded data.
Body
jsonrpcstringrequiredmethodstringweb3_sha3requiredparamsArray<string>requiredArray containing a single hex-encoded data string to hash.
idintegerrequiredResponse
JSON-RPC response with the Keccak-256 hash of the input data
Authorization
api-keyAuthapiKey in headerMAINNET / NODE
chain_getBlockHash
Get block hash by block number
Get the hash of a specific block by its block number.
The chain_getBlockHash method returns the hash of the block header for the specified block number. If no block number is provided, it returns the hash of the latest finalized block.
This method is essential for:
- Navigating the blockchain by block height
- Verifying block existence and integrity
- Building block explorers
- Cross-referencing blocks across different queries
Body
jsonrpcstring2.0requiredJSON-RPC version identifier
methodstringchain_getBlockHashrequiredThe method to be invoked
idinteger | stringrequiredRequest identifier for matching responses
paramsArray<integer | string>requiredArray containing optional block number
Response
Block hash retrieved successfully
Invalid block number or request
Internal server error
Authorization
ApiKeyAuthapiKey in headerchain_getBlock
Get block by hash
Get a block by its hash.
The chain_getBlock method returns the full block data including the block header and all contained extrinsics (transactions). If no block hash is provided, it returns the latest finalized block.
This method provides complete information about a block including:
- Block header with metadata
- All extrinsics (transactions) in the block
- Block production details
- Parent-child relationships
Body
jsonrpcstring2.0requiredJSON-RPC version identifier
methodstringchain_getBlockrequiredThe method to be invoked
idinteger | stringrequiredRequest identifier for matching responses
paramsArray<string>requiredArray containing optional block hash
Response
Block data retrieved successfully
Invalid block hash or request
Block not found
Internal server error
Authorization
ApiKeyAuthapiKey in headerchain_getFinalizedHead
Get latest finalized block hash
Get the hash of the most recent finalized block.
The chain_getFinalizedHead method returns the block hash of the latest block that has been finalized by the GRANDPA finality gadget. Finalized blocks are irreversible and cannot be reorganized, providing the highest level of security for applications.
This method is crucial for:
- Determining safe block height for transactions
- Building applications that require finality guarantees
- Monitoring chain progression and stability
- Ensuring data consistency across services
Body
jsonrpcstring2.0requiredJSON-RPC version identifier
methodstringchain_getFinalizedHeadrequiredThe method to be invoked
idinteger | stringrequiredRequest identifier for matching responses
paramsArray<any>requiredEmpty parameters array for this method
Response
Finalized block hash retrieved successfully
Internal server error
Authorization
ApiKeyAuthapiKey in headerchain_getHeader
Get Block Header
Returns the header of the most recent (best) block in the Polkadot blockchain.
This method is part of the Polkadot JSON-RPC 2.0 specification for chain-related operations. The header contains critical information about the block including hashes, roots, and consensus data.
Body
jsonrpcstring2.0requiredThe JSON-RPC protocol version. Must be exactly "2.0".
methodstringchain_getHeaderrequiredThe JSON-RPC method to call. For this endpoint, must be "chain_getHeader".
paramsArray<any>requiredParameters for the method. For chain_getHeader, this should be an empty array as it retrieves the latest block header without additional parameters.
idinteger<int32>requiredRequest identifier that will be returned in the response. Used to match requests with responses when making multiple concurrent calls.
Response
Successful response containing the block header information.
The header represents the most recent block in the best chain and contains cryptographic commitments to the block's contents and state.
Bad Request - Invalid JSON-RPC request Possible reasons:
- Invalid JSON syntax
- Missing required fields
- Invalid method name
- Invalid parameters
Internal Server Error The node encountered an internal error while processing the request.
Service Unavailable The node is currently unavailable, possibly due to maintenance or synchronization.
Authorization
ApiKeyAuthapiKey in headerpayment_queryInfo
Query transaction fee information
Retrieve the transaction fee information for an extrinsic.
The payment_queryInfo method estimates the transaction fees (including weight fees, length fees, and tips) for a given extrinsic without actually submitting it to the chain. This allows applications to display accurate fee estimates to users before they sign and submit transactions.
This method is essential for:
- Wallet applications showing fee estimates
- DApps calculating transaction costs
- Users verifying transaction affordability
- Batch transaction cost optimization
Body
jsonrpcstring2.0requiredJSON-RPC version identifier
methodstringpayment_queryInforequiredThe method to be invoked
idinteger | stringrequiredRequest identifier for matching responses
paramsArray<string>requiredArray containing the hex-encoded extrinsic
Response
Fee information retrieved successfully
Invalid extrinsic or request
Internal server error
Authorization
ApiKeyAuthapiKey in headerstate_getMetadata
Get runtime metadata
Returns the runtime metadata as a hex-encoded string.
The state_getMetadata method provides the complete runtime metadata for the chain. This metadata describes all the types, storage entries, extrinsics, and events available in the runtime. It's essential for building type-safe applications and understanding the chain's capabilities.
This method is crucial for:
- Generating type definitions for applications
- Understanding available storage items and extrinsics
- Building dynamic DApp interfaces
- Runtime version compatibility checking
Body
jsonrpcstring2.0requiredJSON-RPC version identifier
methodstringstate_getMetadatarequiredThe method to be invoked
idinteger | stringrequiredRequest identifier for matching responses
paramsArray<string>requiredOptional parameters array. Can be empty or contain an optional block hash for historical metadata.
Response
Runtime metadata retrieved successfully
Invalid request parameters
Internal server error
Authorization
ApiKeyAuthapiKey in headerstate_getReadProof
Get read proof for storage keys
Returns proof of storage entries at a specific block.
The state_getReadProof method generates a Merkle proof for the specified storage keys at a given block. This proof can be used to verify the existence and values of storage entries without needing to trust the node providing the data.
This method is essential for:
- Light client verification
- Cross-chain bridge operations
- Trustless data verification
- State proof generation
Body
jsonrpcstring2.0requiredJSON-RPC version identifier
methodstringstate_getReadProofrequiredThe method to be invoked
idinteger | stringrequiredRequest identifier for matching responses
paramsArray<Array<string> | string>requiredArray containing storage keys and optional block hash.
Response
Read proof generated successfully
Invalid storage keys or block hash
Internal server error
Authorization
ApiKeyAuthapiKey in headerstate_getRuntimeVersion
Get runtime version
Returns the version information of the runtime.
The state_getRuntimeVersion method provides detailed version information about the current runtime, including spec version, transaction version, and supported APIs. This information is crucial for compatibility checking and ensuring clients interact correctly with the chain.
This method is essential for:
- Client compatibility verification
- Runtime upgrade detection
- Transaction version validation
- Network protocol compatibility
Body
jsonrpcstring2.0requiredJSON-RPC version identifier
methodstringstate_getRuntimeVersionrequiredThe method to be invoked
idinteger | stringrequiredRequest identifier for matching responses
paramsArray<string>requiredOptional parameters array. Can be empty or contain an optional block hash for historical runtime version.
Response
Runtime version information retrieved successfully
Invalid block hash or request
Internal server error
Authorization
ApiKeyAuthapiKey in headerstate_getStorageHash
Get storage entry hash
Returns the hash of a storage entry.
The state_getStorageHash method retrieves the hash of a specific storage entry at an optional block. This is useful for verifying storage contents without retrieving the full value, or for checking if a storage entry has changed.
This method is useful for:
- Efficient storage change detection
- Light client verification
- Cache validation
- Storage synchronization
Body
jsonrpcstring2.0requiredJSON-RPC version identifier
methodstringstate_getStorageHashrequiredThe method to be invoked
idinteger | stringrequiredRequest identifier for matching responses
paramsArray<string | string>requiredArray containing storage key and optional block hash.
Response
Storage hash retrieved successfully
Invalid storage key or block hash
Internal server error
Authorization
ApiKeyAuthapiKey in headerstate_getStorageSize
Get storage entry size
Returns the size of a storage entry in bytes.
The state_getStorageSize method retrieves the byte size of a specific storage entry at an optional block. This is useful for estimating storage costs, monitoring storage growth, and optimizing data structures.
This method is useful for:
- Storage cost estimation
- Data structure optimization
- Storage growth monitoring
- Resource planning
Body
jsonrpcstring2.0requiredJSON-RPC version identifier
methodstringstate_getStorageSizerequiredThe method to be invoked
idinteger | stringrequiredRequest identifier for matching responses
paramsArray<string | string>requiredArray containing storage key and optional block hash.
Response
Storage size retrieved successfully
Invalid storage key or block hash
Internal server error
Authorization
ApiKeyAuthapiKey in headerstate_getStorage
Get storage entry value
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
jsonrpcstring2.0requiredJSON-RPC version identifier
methodstringstate_getStoragerequiredThe method to be invoked
idinteger | stringrequiredRequest identifier for matching responses
paramsArray<string | string>requiredArray containing storage key and optional block hash.
Response
Storage value retrieved successfully
Invalid storage key or block hash
Internal server error
Authorization
ApiKeyAuthapiKey in headerstate_queryStorageAt
Query storage at specific block
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
jsonrpcstring2.0requiredJSON-RPC version identifier
methodstringstate_queryStorageAtrequiredThe method to be invoked
idinteger | stringrequiredRequest identifier for matching responses
paramsArray<Array<string> | string>requiredArray containing storage keys and optional block hash.
Response
Storage values retrieved successfully
Invalid storage keys or block hash
Internal server error
Authorization
ApiKeyAuthapiKey in headerstate_queryStorage
Query storage changes over a range of blocks
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
jsonrpcstring2.0requiredJSON-RPC version identifier
methodstringstate_queryStoragerequiredThe method to be invoked
idinteger | stringrequiredRequest identifier for matching responses
paramsArray<Array<string> | string | string>requiredArray containing storage keys, start block hash, and optional end block hash.
Response
Storage changes retrieved successfully
Invalid parameters
Internal server error
Authorization
ApiKeyAuthapiKey in headersystem_chain
Get chain name
Returns the chain name.
The system_chain method retrieves the human-readable name of the chain the node is connected to. This helps identify the network and ensure applications are interacting with the correct blockchain.
This method is useful for:
- Network identification
- Multi-chain applications
- User interface display
- Configuration validation
Body
jsonrpcstring2.0requiredJSON-RPC version identifier
methodstringsystem_chainrequiredThe method to be invoked
idinteger | stringrequiredRequest identifier for matching responses
paramsArray<any>requiredEmpty parameters array for this method
Response
Chain name retrieved successfully
Internal server error
Authorization
ApiKeyAuthapiKey in headersystem_properties
Get system properties
Returns custom properties of the chain.
The system_properties method retrieves a collection of chain-specific properties that define the network's configuration and characteristics. These properties are essential for applications to properly interact with the chain.
This method is essential for:
- Chain configuration discovery
- Token decimal and SS58 format configuration
- Network-specific feature detection
- Wallet and application setup
Body
jsonrpcstring2.0requiredJSON-RPC version identifier
methodstringsystem_propertiesrequiredThe method to be invoked
idinteger | stringrequiredRequest identifier for matching responses
paramsArray<any>requiredEmpty parameters array for this method
Response
System properties retrieved successfully
Internal server error
Authorization
ApiKeyAuthapiKey in header