Validators

Query the validator set, delegations, and staking pool

Validators

XYZ Chain uses Proof of Stake consensus with a set of validators. Query validator details, their delegators, and the overall staking pool.

List Validators

Returns all validators filtered by bond status.

curl "http://67.205.164.156:1317/cosmos/staking/v1beta1/validators?status=BOND_STATUS_BONDED&pagination.limit=100"

Response

{
  "validators": [
    {
      "operator_address": "xyzvaloper1abc123...",
      "consensus_pubkey": {
        "@type": "/cosmos.crypto.ed25519.PubKey",
        "key": "..."
      },
      "status": "BOND_STATUS_BONDED",
      "tokens": "50000000000000",
      "delegator_shares": "50000000000000.000000000000000000",
      "description": {
        "moniker": "Validator-1",
        "identity": "",
        "website": "",
        "details": ""
      },
      "commission": {
        "commission_rates": {
          "rate": "0.100000000000000000",
          "max_rate": "0.200000000000000000",
          "max_change_rate": "0.010000000000000000"
        }
      },
      "min_self_delegation": "1"
    }
  ],
  "pagination": {
    "next_key": null,
    "total": "3"
  }
}

Bond Status Values

Status	Meaning
BOND_STATUS_BONDED	Active validators participating in consensus
BOND_STATUS_UNBONDING	Validators in the unbonding period (21 days)
BOND_STATUS_UNBONDED	Inactive validators not producing blocks

Key Fields

Field	Description
operator_address	Validator operator address (prefix xyzvaloper)
tokens	Total staked tokens in uxyz
delegator_shares	Total shares held by all delegators
commission.commission_rates.rate	Current commission rate (e.g., 0.1 = 10%)
description.moniker	Validator’s display name

Get Specific Validator

curl http://67.205.164.156:1317/cosmos/staking/v1beta1/validators/xyzvaloper1abc123...

Returns the same structure as above for a single validator.

Get Validator Delegations

List all delegators for a specific validator.

curl "http://67.205.164.156:1317/cosmos/staking/v1beta1/validators/xyzvaloper1abc123.../delegations?pagination.limit=100"

{
  "delegation_responses": [
    {
      "delegation": {
        "delegator_address": "xyz1delegator...",
        "validator_address": "xyzvaloper1abc123...",
        "shares": "10000000000.000000000000000000"
      },
      "balance": {
        "denom": "uxyz",
        "amount": "10000000000"
      }
    }
  ]
}

Get Delegations for an Address

List all validators a given address has delegated to.

curl http://67.205.164.156:1317/cosmos/staking/v1beta1/delegations/xyz1delegator...

Get Staking Pool

Returns the total bonded and not-bonded token amounts across the entire chain.

curl http://67.205.164.156:1317/cosmos/staking/v1beta1/pool

{
  "pool": {
    "bonded_tokens": "100000000000000",
    "not_bonded_tokens": "5000000000000"
  }
}

Field	Description
bonded_tokens	Total uxyz staked with active validators
not_bonded_tokens	Total uxyz in unbonding or unbonded state

Get Staking Parameters

curl http://67.205.164.156:1317/cosmos/staking/v1beta1/params

{
  "params": {
    "unbonding_time": "1814400s",
    "max_validators": 100,
    "max_entries": 7,
    "bond_denom": "uxyz"
  }
}

Parameter	Description
unbonding_time	Time to undelegate (21 days = 1,814,400 seconds)
max_validators	Maximum number of active validators
bond_denom	The staking token denomination (uxyz)