Returns information of all stakers (registered validators) and if they are active, ordered by their holding stake.

GET 
/api/core/v3/validators

Returns information of all stakers (registered validators) and if they are active, ordered by their holding stake.

Request

Query Parameters

pageSize integer
The page number of stakers.
Example: 1
cursor string
Starts the search from the cursor (requested slot index+start index).
Example: 16,20

Responses

200

Successful operation.

application/json

Schema

Schema

validators object[]
Array [
oneOf
Validator
address stringrequired
The account address of the staker.
stakingEndEpoch integerrequired
The epoch index until which the staker registered to stake.
poolStake stringrequired
The total stake of the pool, including delegators.
validatorStake stringrequired
The stake of a staker.
fixedCost stringrequired
The fixed cost of the staker, which it receives as part of its Mana rewards.
active booleanrequired
Shows whether staker was active recently.
latestSupportedProtocolVersion integerrequired
The latest protocol version the staker supported.
latestSupportedProtocolHash stringrequired
The latest protocol hash the staker supported.
]
pageSize integer

The number of registerd validators returned per one API request with pagination.

cursor string

The cursor that needs to be provided as cursor query parameter to request the next page. Cursor is absent if the last page is returned.

Example (from schema)

{
  "validators": [
    null
  ],
  "pageSize": 0,
  "cursor": "string"
}

ValidatorsResponse

{
  "validators": [
    {
      "address": "rms1pp4wuuz0y42caz48vv876qfpmffswsvg40zz8v79sy8cp0jfxm4kunflcgt",
      "stakingEndEpoch": 100,
      "poolStake": "200000",
      "validatorStake": "100000",
      "fixedCost": "50000",
      "active": false,
      "latestSupportedProtocolVersion": 3,
      "latestSupportedProtocolHash": "0x0c00425134785bf2dbe42e4ec7e288009ebdc38ced797beaa45d5213092021cb"
    },
    {
      "address": "rms1pqm4xk8e9ny5w5rxjkvtp249tfhlwvcshyr3pc0665jvp7g3hc875k538hl",
      "stakingEndEpoch": 10,
      "poolStake": "205000",
      "validatorStake": "90000",
      "fixedCost": "52000",
      "active": true,
      "latestSupportedProtocolVersion": 3,
      "latestSupportedProtocolHash": "0x0c00425134785bf2dbe42e4ec7e288009ebdc38ced797beaa45d5213092021cb"
    }
  ],
  "pageSize": 50
}

400

Unsuccessful operation: indicates that the provided data is invalid.

application/json

Schema

Schema

error objectrequired

code stringrequired

The application error code.

message stringrequired

The error reason.

Example (from schema)

{
  "error": {
    "code": 400,
    "message": "invalid data provided"
  }
}

403

Unsuccessful operation: indicates that the endpoint is not available for public use.

application/json

Schema

Schema

error objectrequired

code stringrequired

The application error code.

message stringrequired

The error reason.

Example (from schema)

{
  "error": {
    "code": 403,
    "message": "not available for public use"
  }
}

500

Unsuccessful operation: indicates that an unexpected, internal server error happened which prevented the node from fulfilling the request.

application/json

Schema

Schema

error objectrequired

code stringrequired

The application error code.

message stringrequired

The error reason.

Example (from schema)

{
  "error": {
    "code": 500,
    "message": "internal server error"
  }
}

503

Unsuccessful operation: indicates that the node is not synced.

application/json

Schema

Schema

error objectrequired

code stringrequired

The application error code.

message stringrequired

The error reason.

Example (from schema)

{
  "error": {
    "code": 503,
    "message": "service unavailable"
  }
}

Loading...