GetCandidates

Returns the statuses of all candidates at a specific epoch

Parameters

• EPOCH_NUMBER [required] - a hex code of an integer representing the EPOCH_NUMBER or the following special param:

  • latest: get the status of candidate at the current time

params: [ 'latest' ]

Returns

• EPOCH - the epoch number of the query of this request

• CANDIDATES - list of candidates along with their statuses and capacities

  • STATUS - a string representing status of the corresponding candidate

  • MASTERNODE - if the candidate is a masternode

  • SLASHED - if the candidate is slashed

  • PROPOSED - if the candidate is proposed, have not been a masternode yet

  • empty string - if it's not a candidate

• CAPACITY - capacity of the corresponding candidate

• SUCCESS - true if the request is successful, otherwise it's false

POSThttps://tomo.nownodes.io/getCandidates

Body

application/json

jsonrpc*string

method*string

params*array of string

id*integer (int32)

Response

200500

Successful Operation

Request

JavaScriptCurlPython

const response = await fetch('https://tomo.nownodes.io/getCandidates', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getCandidates",
      "params": [
        "latest"
      ],
      "id": 1
    }),
});
const data = await response.json();