Skip to main content
Node parameters allow validators to publish on-chain configuration that affects how delegated staking rewards are distributed. Delegators can query node parameters to select nodes based on reward fraction and metadata.
All endpoints return the following response headers:
  • X-Id — The node’s public key identifier
  • X-Session-Token — The current cluster session token
  • Request-Signature — Cryptographic signature of the response for verification

​
POST /node-params

Submits a signed node parameters update request. The new parameters take effect in the next global snapshot. 
curl -X POST https://<node-host>:9000/node-params \
  -H "Content-Type: application/json" \
  -d '{
    "value": {
      "nodeId": "<node-public-key-hex>",
      "rewardFraction": 500,
      "name": "My Validator Node",
      "description": "High-availability validator"
    },
    "proofs": [
      { "id": "<public-key-hex>", "signature": "<ecdsa-der-hex>" }
    ]
  }'
​
value
object
required
The node parameters payload
​
proofs
array
required
Cryptographic signature proofs. Must be signed by the node’s key.
Response 200 OK
​
hash
string
Hash of the accepted node parameters update request
Response 400 Bad Request — Invalid request format or signature. Response 503 Service Unavailable — Node not ready yet.
Use the wallet CLI create-node-params command to construct and sign the node parameters update:
java -jar wallet.jar --keystore ./key.p12 --alias alias --password pw \
  create-node-params \
  --reward-fraction 0.05 \
  --name "My Node" \
  --description "Main validator node"

​
GET /node-params

Returns a list of all node parameters registered on the network, with optional filtering and sorting. 
curl "https://<node-host>:9000/node-params?sort=totalAmountDelegated&sortOrder=DESC"
​
search
string
Filter results by node name or peer ID (partial match)
​
sort
string
Sort field. One of: name, peerID, address, totalAddressesAssigned, totalAmountDelegated
​
sortOrder
string
Sort direction. One of: ASC, DESC
Response 200 OK — Array of NodeParametersInfo objects
​
nodeId
string
Node public key identifier (hex)
​
address
string
DAG address of the node operator
​
rewardFraction
integer
Reward fraction kept by operator in basis points (out of 10000)
​
name
string
Node name
​
description
string
Node description
​
totalAddressesAssigned
integer
Number of delegator addresses currently delegating to this node
​
totalAmountDelegated
integer
Total amount delegated to this node in datums
Response 400 Bad Request — Invalid query parameters. Response 503 Service Unavailable — Node not ready yet.

​
GET /node-params/

Returns node parameters for a specific node. 
curl https://<node-host>:9000/node-params/<node-public-key-hex>
​
nodeId
string
required
The node’s public key identifier (hex)
Response 200 OK — Returns the UpdateNodeParameters object for the node
​
nodeId
string
Node public key identifier
​
rewardFraction
integer
Reward fraction kept by operator in basis points
​
name
string
Node name
​
description
string
Node description
Response 404 Not Found — No node parameters found for this node ID. Response 503 Service Unavailable — Node not ready yet.

Build docs developers (and LLMs) love

Get started for freeTalk to us