GetCandidates

post

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

Body
jsonrpcstringRequired
methodstringRequired
paramsstring[]Required
idinteger · int32Required
Responses
200
Successful Operation
post
POST //getCandidates HTTP/1.1
Host: tomo.nownodes.io
Content-Type: application/json
Accept: */*
Content-Length: 73

{
  "jsonrpc": "2.0",
  "method": "eth_getCandidates",
  "params": [
    "latest"
  ],
  "id": 1
}
No content
PreviousGetBlockFinalityByHashNextGetCandidateStatus