GetCandidateStatus

Returns the status of the candidate of given COINBASE_ADDRESS at a specific epoch

Parameters

• COINBASE_ADDRESS [required] - a string representing a COINBASE_ADDRESS (length: 40, start with 0x )

• 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

Example

params: [ '0x1d50df657b6dce50bac634bf18e2d986d807e940', 'latest' ]

Returns

• STATUS - a string representing status of the candicate of given COINBASE_ADDRESS

  • 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 candidate

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

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

POSThttps://tomo.nownodes.io/getCandidateStatus

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/getCandidateStatus', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getCandidateStatus",
      "params": [
        "0x1d50df657b6dce50bac634bf18e2d986d807e940",
        "latest"
      ],
      "id": 1
    }),
});
const data = await response.json();