Skip to main content

Validators

API docs by Redocly

Blockchain Integration Data Query Apis Protocol Rest Queries Validators (v1.0.0)

Download OpenAPI specification:Download

NUVA Labs: inbound@nuvalabs.com URL: https://nuvalabs.com/ License: Apache 2.0 Terms of Service

API Documentation for Blockchain Integration Data Query Apis Protocol Rest Queries Validators

ValidatorDistributionInfo

ValidatorDistributionInfo queries validator commission and self-delegation rewards for validator

Authorizations:
bearerAuth
path Parameters
validator_address
required
string (validator_address)

validator_address defines the validator address to query for.

Responses

Response samples

Content type
application/json
{
  • "operatorAddress": "string",
  • "selfBondRewards": [
    ],
  • "commission": [
    ]
}

ValidatorCommission

ValidatorCommission queries accumulated commission for a validator.

Authorizations:
bearerAuth
path Parameters
validator_address
required
string (validator_address)

validator_address defines the validator address to query for.

Responses

Response samples

Content type
application/json
{
  • "commission": {
    }
}

ValidatorOutstandingRewards

ValidatorOutstandingRewards queries rewards of a validator address.

Authorizations:
bearerAuth
path Parameters
validator_address
required
string (validator_address)

validator_address defines the validator address to query for.

Responses

Response samples

Content type
application/json
{
  • "rewards": {
    }
}

ValidatorSlashes

ValidatorSlashes queries slash events of a validator.

Authorizations:
bearerAuth
path Parameters
validator_address
required
string (validator_address)

validator_address defines the validator address to query for.

query Parameters
startingHeight
integer or string <int64> (starting_height)

starting_height defines the optional starting height to query the slashes.

endingHeight
integer or string <int64> (ending_height)

starting_height defines the optional ending height to query the slashes.

pagination.key
string <byte> (key)

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset
integer or string <int64> (offset)

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

pagination.limit
integer or string <int64> (limit)

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

pagination.countTotal
boolean (count_total)

count_total is set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set.

pagination.reverse
boolean (reverse)

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Responses

Response samples

Content type
application/json
{
  • "slashes": [
    ],
  • "pagination": {
    }
}

HistoricalInfo

HistoricalInfo queries the historical info for given height.

Authorizations:
bearerAuth
path Parameters
height
required
integer or string <int64> (height)

height defines at which height to query the historical info.

Responses

Response samples

Content type
application/json
{
  • "hist": {
    }
}

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.

Authorizations:
bearerAuth
query Parameters
status
string (status)

status enables to query for validators matching a given status.

pagination.key
string <byte> (key)

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset
integer or string <int64> (offset)

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

pagination.limit
integer or string <int64> (limit)

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

pagination.countTotal
boolean (count_total)

count_total is set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set.

pagination.reverse
boolean (reverse)

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Responses

Response samples

Content type
application/json
{
  • "validators": [
    ],
  • "pagination": {
    }
}

Validator

Validator queries validator info for given validator address.

Authorizations:
bearerAuth
path Parameters
validator_addr
required
string (validator_addr)

validator_addr defines the validator address to query for.

Responses

Response samples

Content type
application/json
{
  • "validator": {
    }
}

GetLatestValidatorSet

GetLatestValidatorSet queries latest validator-set.

Authorizations:
bearerAuth
query Parameters
pagination.key
string <byte> (key)

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset
integer or string <int64> (offset)

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

pagination.limit
integer or string <int64> (limit)

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

pagination.countTotal
boolean (count_total)

count_total is set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set.

pagination.reverse
boolean (reverse)

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Responses

Response samples

Content type
application/json
{
  • "blockHeight": 0,
  • "validators": [
    ],
  • "pagination": {
    }
}

GetValidatorSetByHeight

GetValidatorSetByHeight queries validator-set at a given height.

Authorizations:
bearerAuth
path Parameters
height
required
integer or string <int64> (height)

(proto int64)

query Parameters
pagination.key
string <byte> (key)

key is a value returned in PageResponse.next_key to begin querying the next page most efficiently. Only one of offset or key should be set.

pagination.offset
integer or string <int64> (offset)

offset is a numeric offset that can be used when key is unavailable. It is less efficient than using key. Only one of offset or key should be set.

pagination.limit
integer or string <int64> (limit)

limit is the total number of results to be returned in the result page. If left empty it will default to a value to be set by each app.

pagination.countTotal
boolean (count_total)

count_total is set to true to indicate that the result set should include a count of the total number of items available for pagination in UIs. count_total is only respected when offset is used. It is ignored when key is set.

pagination.reverse
boolean (reverse)

reverse is set to true if results are to be returned in the descending order.

Since: cosmos-sdk 0.43

Responses

Response samples

Content type
application/json
{
  • "blockHeight": 0,
  • "validators": [
    ],
  • "pagination": {
    }
}