Masternodes

How to create, manage or delete a masternode on the NodeHub.io platform via API.

Get all nodes

GET https://api.nodehub.io/v1/nodes

This endpoint returns list of your nodes with their related information.

Headers

Name	Type	Description
Authorization*	string	Authentication token you've generated in your account

200

[
  {
    "active_time": null,
    "collateral": 40000,
    // config_file will be returned for PIVX based masternodes
    "config_file": "FemaleLikelyWolverine 116.202.110.71:6214 5Jysm2juutq1jePaMG1Ft413KiofKZ5SyZNBB4LreehrsN8Az6U babbcbd5e85b6ff1cbeed414c05bf3402eb4e72fac4b3ceb02795046fb390aff 1",
    // start_command will be returned for DASH DIP003 based masternodes
    "start_command": "signmessage yR3w86S6hkNdBvaTw4Rko6N4ZfBxwZpHJr yR3w86S6hkNdBvaTw4Rko6N4ZfBxwZpHJr|0|ygu6i5v5HB9MesG88g86RbLCtkPpSDfz8C|ygu6i5v5HB9MesG88g86RbLCtkPpSDfz8C|621dc6fe90fa257bbbb10ba9435dcc58b27408a4f4084d2352a90be99b6f3f22",
    // start_command will be returned for XMR based masternodes
    "start_command": "register_master_node 18446744073709551612 bxcZashCa9BZN6ibWb6HRLFB38ZiqF1SMbwesk6tKXDkhwz897qx8Z12YUYRM6CZ9nAX2sWw4sUFvFKpDXnGwY1u1eyvZyhX6 18446744073709551612 1713362114 08cad075d2452a54c8479bf18426f2202c3d4cba4a7c92c3d7aa9f788d411afb cc483a77a756cffe055ddfed32faaee4c6fd594f808f28a66aa548c974582a0ddc311d0a27a01335f534517a3604494b023d56c95179ab9b56f264ef8f03af03",
    "creation_date": "2019/07/17 09:24:50",
    "currency": "nix",
    "id": "FemaleLikelyWolverine",
    "ip": "116.202.110.71",
    "last_reward": null,
    "network_status": "UNKNOWN",
    "nodehub_status": "start required",
    "package": "cloud",
    "reward_address": "GVLGb7odP1o85sCHkPKMfPj25UHnDLnMaM",
    "sync_status": "done",
    "ticker": "NIX"
  }
]

Get a specific node

GET https://api.nodehub.io/v1/nodes/:id

This endpoint returns information about the node that you've specified.

Path Parameters

Name	Type	Description
id*	string	ID of the node

Headers

Name	Type	Description
Authorization*	string	Authentication token you've generated in your account

200

{
  "active_time": null, 
  "collateral": 40000, 
  // config_file will be returned for PIVX based masternodes
  "config_file": "FemaleLikelyWolverine 116.202.110.71:6214 5Jysm2juutq1jePaMG1Ft413KiofKZ5SyZNBB4LreehrsN8Az6U babbcbd5e85b6ff1cbeed414c05bf3402eb4e72fac4b3ceb02795046fb390aff 1",
  // start_command will be returned for DASH DIP003 based masternodes
  "start_command": "signmessage yR3w86S6hkNdBvaTw4Rko6N4ZfBxwZpHJr yR3w86S6hkNdBvaTw4Rko6N4ZfBxwZpHJr|0|ygu6i5v5HB9MesG88g86RbLCtkPpSDfz8C|ygu6i5v5HB9MesG88g86RbLCtkPpSDfz8C|621dc6fe90fa257bbbb10ba9435dcc58b27408a4f4084d2352a90be99b6f3f22",
  // start_command will be returned for XMR based masternodes
  "start_command": "register_master_node 18446744073709551612 bxcZashCa9BZN6ibWb6HRLFB38ZiqF1SMbwesk6tKXDkhwz897qx8Z12YUYRM6CZ9nAX2sWw4sUFvFKpDXnGwY1u1eyvZyhX6 18446744073709551612 1713362114 08cad075d2452a54c8479bf18426f2202c3d4cba4a7c92c3d7aa9f788d411afb cc483a77a756cffe055ddfed32faaee4c6fd594f808f28a66aa548c974582a0ddc311d0a27a01335f534517a3604494b023d56c95179ab9b56f264ef8f03af03",
  "creation_date": "2019/07/17 09:24:50", 
  "currency": "nix", 
  "id": "FemaleLikelyWolverine", 
  "ip": "116.202.110.71", 
  "last_reward": null, 
  "network_status": "UNKNOWN", 
  "nodehub_status": "start required", 
  "package": "cloud", 
  "reward_address": "GVLGb7odP1o85sCHkPKMfPj25UHnDLnMaM", 
  "sync_status": "done", 
  "ticker": "NIX"
}

Create a node

POST https://api.nodehub.io/v1/nodes

This endpoint allows you to create a node.

Headers

Name	Type	Description
Authorization*	string	Authentication token you've generated in your account

Request Body

Name	Type	Description
currency*	string	NodeHub ID of the project
txid*	string	Transaction ID of the collateral
outputid	integer	Optional output id. If not provided it will auto detect the first output. This option must be used for sendmany transactions.
payee	string	Optional custom payout address for DIP003 based masternodes
burntxid*	string	Required for Sinovate
package*	string	Dedicated or Cloud plan.
address*	string	Required for Horizen and XMR based masternodes
secretkey	string	Optional for DIP003 and XMR based masternodes. Allows migration of the masternode with the given secret key / BLS key / operator key.

200

{
    "node_id": "FemaleLikelyWolverine"
}

Start a node

POST https://api.nodehub.io/v1/nodes/:id/start

This endpoint allows you to start your DIP003 masternodes by sending the signmessage data.

Headers

Name	Type	Description
Authorization*	string	Authentication token you've generated in your account

Path Parameters

Name	Type	Description
id*	string	ID of the node

Request Body

Name	Type	Description
output*	string	Sign message

Delete a node

DELETE https://api.nodehub.io/v1/nodes/:id

This endpoint deletes your specified node.

Headers

Name	Type	Description
Authorization*	string	Authentication token you've generated in your account

Path Parameters

Name	Type	Description
id*	string	ID of the node

200

{
    "success": true
}