Skip to main content

/api/v1/network/nodes REST API Endpoint

Returns the network's list of nodes used in consensus.

Updated on
Aug 23, 2024

/api/v1/network/nodes REST API Endpoint

Please note that this method is currently available only on the testnet and will be accessible on the mainnet soon.

Query Parameters

file.id
string
The ID of the file entity
limit
integer
The maximum number of items to return
order
string
The order in which items are listed (asc or desc)
node.id
string
The ID of the node

Returns

nodes
array
An array of objects, each representing a node on the Hedera network
description
string
A description of the node, including its hosting details and location
file_id
string
The unique identifier of the file associated with the node
max_stake
integer
The maximum amount of stake the node can have
memo
string
A memo associated with the node
min_stake
integer
The minimum amount of stake required for the node
node_id
integer
The unique identifier of the node
node_account_id
string
The account ID of the node
node_cert_hash
string
The hash of the node's certificate
public_key
string
The public key of the node
reward_rate_start
integer
The initial reward rate for staking
service_endpoints
array
An array of objects, each representing an endpoint through which the node can be accessed
ip_address_v4
string
The IPv4 address of the node
port
integer
The port number for accessing the node
stake
integer
The current total stake of HBAR on the node
stake_not_rewarded
integer
The amount of stake that does not earn rewards
stake_rewarded
integer
The amount of stake that earns rewards
staking_period
object
An object representing the period for which staking information is provided
from
string
The start time of the staking period
to
string
The end time of the staking period
timestamp
object
An object indicating the validity period of the node's information
from
string
The start time of the validity period
to
string
The end time of the validity period
links
object
An object containing pagination links
next
string
A URL to fetch the next set of result, if available
Request
1
curl 'https://docs-demo.hedera-mainnet.quiknode.pro/api/v1/network/nodes'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free