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

[
  {
    "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

{
  "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.

{
    "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

{
    "success": true
}

Last updated