Return information about a staker (registered validator).

GET 
/api/core/v3/validators/:bech32Address

Return information about a staker (registered validator).

Request

Path Parameters

bech32Address stringrequired
The Account Address of the staker.
Example: rms1pqm4xk8e9ny5w5rxjkvtp249tfhlwvcshyr3pc0665jvp7g3hc875k538hl

Responses

200

Successful operation.

application/json

Schema

Schema

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.

Example (from schema)

{
  "address": "string",
  "stakingEndEpoch": 0,
  "poolStake": "string",
  "validatorStake": "string",
  "fixedCost": "string",
  "active": true,
  "latestSupportedProtocolVersion": 0,
  "latestSupportedProtocolHash": "string"
}

AccountStakingResponse

{
  "address": "rms1pqm4xk8e9ny5w5rxjkvtp249tfhlwvcshyr3pc0665jvp7g3hc875k538hl",
  "stakingEndEpoch": 100,
  "poolStake": "205000",
  "validatorStake": "90000",
  "fixedCost": "52000",
  "active": true,
  "latestSupportedProtocolVersion": 3,
  "latestSupportedProtocolHash": "0x0c00425134785bf2dbe42e4ec7e288009ebdc38ced797beaa45d5213092021cb"
}

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