Validators

Validators queries all validators that match the given status.

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

GEThttps://coreum.nownodes.io/cosmos/staking/v1beta1/validators

Query parameters

Response

200default

A successful response.

Body

application/json

validatorsarray of cosmos.staking.v1beta1.Validator (object)

validators contains all the queried validators.

paginationcosmos.base.query.v1beta1.PageResponse (object)

PageResponse is to be embedded in gRPC response messages where the corresponding request message has used PageRequest.

message SomeResponse { repeated Bar results = 1; PageResponse page = 2; }

Request

JavaScriptCurlPython

const response = await fetch('https://coreum.nownodes.io/cosmos/staking/v1beta1/validators', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200default

{
  "validators": [
    {
      "operator_address": "text",
      "consensus_pubkey": {
        "@type": "text"
      },
      "jailed": false,
      "status": "BOND_STATUS_UNSPECIFIED",
      "tokens": "text",
      "delegator_shares": "text",
      "description": {
        "moniker": "text",
        "identity": "text",
        "website": "text",
        "security_contact": "text",
        "details": "text"
      },
      "unbonding_height": "text",
      "unbonding_time": "2024-12-22T02:22:55.495Z",
      "commission": {
        "commission_rates": {
          "rate": "text",
          "max_rate": "text",
          "max_change_rate": "text"
        },
        "update_time": "2024-12-22T02:22:55.495Z"
      },
      "min_self_delegation": "text",
      "unbonding_on_hold_ref_count": "text",
      "unbonding_ids": [
        "text"
      ]
    }
  ],
  "pagination": {
    "next_key": "Ynl0ZXM=",
    "total": "text"
  }
}

Validator queries validator info for given validator address.

GEThttps://coreum.nownodes.io/cosmos/staking/v1beta1/validators/{validator_addr}

Path parameters

validator_addr*string

validator_addr defines the validator address to query for.

Response

200default

A successful response.

Body

application/json

validatorcosmos.staking.v1beta1.Validator (object)

Validator defines a validator, together with the total amount of the Validator's bond shares and their exchange rate to coins. Slashing results in a decrease in the exchange rate, allowing correct calculation of future undelegations without iterating over delegators. When coins are delegated to this validator, the validator is credited with a delegation whose number of bond shares is based on the amount of coins delegated divided by the current exchange rate. Voting power can be calculated as total bonded shares multiplied by exchange rate.

Request

JavaScriptCurlPython

const response = await fetch('https://coreum.nownodes.io/cosmos/staking/v1beta1/validators/{validator_addr}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200default

{
  "validator": {
    "operator_address": "text",
    "consensus_pubkey": {
      "@type": "text"
    },
    "jailed": false,
    "status": "BOND_STATUS_UNSPECIFIED",
    "tokens": "text",
    "delegator_shares": "text",
    "description": {
      "moniker": "text",
      "identity": "text",
      "website": "text",
      "security_contact": "text",
      "details": "text"
    },
    "unbonding_height": "text",
    "unbonding_time": "2024-12-22T02:22:55.495Z",
    "commission": {
      "commission_rates": {
        "rate": "text",
        "max_rate": "text",
        "max_change_rate": "text"
      },
      "update_time": "2024-12-22T02:22:55.495Z"
    },
    "min_self_delegation": "text",
    "unbonding_on_hold_ref_count": "text",
    "unbonding_ids": [
      "text"
    ]
  }
}