Casper Node RPC API
v1.0.0https://casper.nownodes.ioAuthentication
api-keyAuthapiKeyAPI Key: api-key in header
Informational JSON-RPC Methods
chain_get_block_transfers
Returns all transfer transactions included in a given block identified by hash or height.
Body
idintegerrequiredJSON-RPC request id
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredRPC method name
paramsobjectrequiredResponse
Successful response with transfers in the block
Authorization
api-keyAuthapiKey in headerchain_get_block
Calls chain_get_block RPC method on a Casper Node and returns the block along with validator signatures.
Body
idintegerrequiredRequest identifier.
jsonrpcstringrequiredJSON-RPC protocol version.
methodstringrequiredRPC method name to call.
paramsobjectrequiredRequest parameters.
Response
Successful response with block data
Authorization
api-keyAuthapiKey in headerchain_get_state_root_hash
Returns the root hash of the global state at a given block identified by hash or height.
Body
idintegerrequiredJSON-RPC request identifier
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredRPC method name
paramsobjectrequiredResponse
Successful response returning the state root hash
Authorization
api-keyAuthapiKey in headerinfo_get_chainspec
Returns the chainspec bytes of the current network, including optional genesis accounts and global state bytes.
Body
idintegerrequiredJSON-RPC request identifier
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredRPC method name
paramsArray<any>requiredParameters for the method (empty for this RPC)
Response
Successful response returning the chainspec bytes
Authorization
api-keyAuthapiKey in headerinfo_get_peers
Executes the JSON-RPC method info_get_peers, which retrieves all known peers of the node, including their TLS identifiers and network addresses.
Body
idintegerrequiredJSON-RPC request ID
jsonrpcstringrequiredJSON-RPC protocol version
methodstringrequiredJSON-RPC method name
paramsarrayrequiredEmpty array for this method
Response
Successful response with the list of peers
Authorization
api-keyAuthapiKey in headerinfo_get_reward
Returns the reward amounts for a validator and its delegators for a given era.
Body
idintegerrequiredJSON-RPC request identifier
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredRPC method name
paramsobjectrequiredResponse
Successful response with rewards for validator and delegator
Authorization
api-keyAuthapiKey in headerinfo_get_status
Executes the JSON-RPC method info_get_status, which returns the node's status, including protocol version, peers, block info, upgrade information, uptime, sync status, and other system details.
Body
idintegerrequiredJSON-RPC request ID
jsonrpcstringrequiredJSON-RPC protocol version
methodstringrequiredJSON-RPC method name
paramsarrayrequiredEmpty array for this method
Response
Successful response containing node status information
Authorization
api-keyAuthapiKey in headerinfo_get_transaction
Returns detailed information about a transaction.
Body
idintegerrequiredJSON-RPC request identifier
jsonrpcstringrequiredmethodstringrequiredparamsobjectrequiredParameters for the transaction request
Response
Successful response
Authorization
api-keyAuthapiKey in headerquery_balance_details
Retrieves detailed balance information for a given purse under an account. Includes total balance, available balance, holds (if any), and cryptographic proof.
Body
idintegerrequiredUnique identifier for the JSON-RPC request
jsonrpcstringrequiredJSON-RPC version (should be "2.0")
methodstringrequiredThe method to call
paramsobjectrequiredParameters for the method
Response
Successful response with balance details
Authorization
api-keyAuthapiKey in headerquery_balance
Sends a JSON-RPC request to query the balance of a specific purse under an account
identified either by StateRootHash or BlockHash.
Body
idintegerrequiredThe request identifier
jsonrpcstringrequiredJSON-RPC version
methodstringrequiredThe JSON-RPC method name
paramsobjectrequiredResponse
Successful response with the balance
Authorization
api-keyAuthapiKey in headerquery_global_state
Executes the query_global_state RPC call to retrieve the value associated with a key in the global state.
Returns block header, stored value, and a Merkle proof.
Body
idintegerJSON-RPC request identifier
jsonrpcstringJSON-RPC version
methodstringRPC method name
paramsobjectParameters for the query_global_state RPC
Response
Successful query response
Authorization
api-keyAuthapiKey in headerstate_get_account_info
Returns detailed information about a specific account at a given block.
Body
idintegerUnique request ID.
jsonrpcstringJSON-RPC version.
methodstringRPC method name.
paramsobjectParameters for the query.
Response
Successful response with account information.
Authorization
api-keyAuthapiKey in headerstate_get_dictionary_item
Retrieves the value stored under a specific dictionary key in global state.
Body
idintegerUnique request identifier
jsonrpcstringJSON-RPC protocol version
methodstringRPC method to call
paramsobjectParameters for the dictionary query
Response
Successful response with dictionary item value
Authorization
api-keyAuthapiKey in headerProof-of-Stake JSON-RPC Methods
info_get_validator_changes
Retrieves the list of validator changes at the current block. This is a JSON-RPC call to the Casper node.
Body
JSON-RPC request object
jsonrpcstringrequiredJSON-RPC protocol version
methodstringrequiredThe RPC method to call
paramsobjectrequiredParameters for the method (empty object)
idintegerrequiredRequest identifier
Response
Successful response with validator changes
Authorization
api-keyAuthapiKey in headerTransactional JSON-RPC Methods
account_put_transaction
Submits a Version1 transaction to the Casper blockchain. Returns the hash of the accepted transaction.
Body
JSON-RPC request
jsonrpcstringrequiredJSON-RPC protocol version
methodstringrequiredRPC method
paramsobjectrequiredObject containing the transaction to submit
Response
Transaction submitted successfully
Authorization
api-keyAuthapiKey in headerspeculative_exec_txn
Executes a Version1 transaction locally without committing it to the blockchain. Returns the execution result.
Body
JSON-RPC request
jsonrpcstringrequiredJSON-RPC protocol version
methodstringrequiredRPC method
paramsobjectrequiredTransaction object to execute speculatively
Response
Speculative execution result
Authorization
api-keyAuthapiKey in header