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
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
}