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.Response
Response
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Query the validator set, delegations, and staking pool
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"
}
}
| 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 |
| 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 |
curl http://67.205.164.156:1317/cosmos/staking/v1beta1/validators/xyzvaloper1abc123...
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"
}
}
]
}
curl http://67.205.164.156:1317/cosmos/staking/v1beta1/delegations/xyz1delegator...
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 |
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) |