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`)

Getting Started

Chain

Products

Developer Tools

Token Operations

Smart Contracts

Local Development

Chain API

Launchpad API

Validators

Validators

List Validators

Bond Status Values

Key Fields

Get Specific Validator

Get Validator Delegations

Get Delegations for an Address

Get Staking Pool

Get Staking Parameters

​Validators

​List Validators

​Bond Status Values

​Key Fields

​Get Specific Validator

​Get Validator Delegations

​Get Delegations for an Address

​Get Staking Pool

​Get Staking Parameters

Validators

List Validators

Bond Status Values

Key Fields

Get Specific Validator

Get Validator Delegations

Get Delegations for an Address

Get Staking Pool

Get Staking Parameters