Staking

DelegatorDelegations queries all delegations of a given delegator address.

get

/cosmos/staking/v1beta1/delegations/{delegator_addr}

Path parameters
delegator_addrstringrequired

delegator_addr defines the delegator address to query for.

Query parameters
pagination.keystring · byte

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.offsetstring · uint64

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.limitstring · uint64

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.count_totalboolean

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.reverseboolean

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

Since: cosmos-sdk 0.43

Responses
curl -L \
  --url 'https://lcd.uno.sentry.testnet.v3.kiivalidator.com/cosmos/staking/v1beta1/delegations/{delegator_addr}'
{
  "pagination": {
    "next_key": "text",
    "total": "text"
  },
  "delegation_responses": [
    {
      "delegation": {
        "delegator_address": "text",
        "validator_address": "text",
        "shares": "text"
      },
      "balance": {
        "denom": "text",
        "amount": "text"
      }
    }
  ]
}

A successful response.

Redelegations queries redelegations of given address.

get

/cosmos/staking/v1beta1/delegators/{delegator_addr}/redelegations

Path parameters
delegator_addrstringrequired

delegator_addr defines the delegator address to query for.

Query parameters
src_validator_addrstring

src_validator_addr defines the validator address to redelegate from.

dst_validator_addrstring

dst_validator_addr defines the validator address to redelegate to.

pagination.keystring · byte

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.offsetstring · uint64

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.limitstring · uint64

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.count_totalboolean

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.reverseboolean

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

Since: cosmos-sdk 0.43

Responses
curl -L \
  --url 'https://lcd.uno.sentry.testnet.v3.kiivalidator.com/cosmos/staking/v1beta1/delegators/{delegator_addr}/redelegations'
{
  "pagination": {
    "next_key": "text",
    "total": "text"
  },
  "redelegation_responses": [
    {
      "redelegation": {
        "delegator_address": "text",
        "validator_src_address": "text",
        "validator_dst_address": "text",
        "entries": [
          {
            "creation_height": "text",
            "completion_time": "2025-02-20T19:22:52.149Z",
            "initial_balance": "text",
            "shares_dst": "text"
          }
        ]
      },
      "entries": [
        {
          "balance": "text",
          "redelegation_entry": {
            "creation_height": "text",
            "completion_time": "2025-02-20T19:22:52.149Z",
            "initial_balance": "text",
            "shares_dst": "text"
          }
        }
      ]
    }
  ]
}

A successful response.

DelegatorUnbondingDelegations queries all unbonding delegations of a given delegator address.

get

/cosmos/staking/v1beta1/delegators/{delegator_addr}/unbonding_delegations

Path parameters
delegator_addrstringrequired

delegator_addr defines the delegator address to query for.

Query parameters
pagination.keystring · byte

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.offsetstring · uint64

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.limitstring · uint64

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.count_totalboolean

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.reverseboolean

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

Since: cosmos-sdk 0.43

Responses
curl -L \
  --url 'https://lcd.uno.sentry.testnet.v3.kiivalidator.com/cosmos/staking/v1beta1/delegators/{delegator_addr}/unbonding_delegations'
{
  "pagination": {
    "next_key": "text",
    "total": "text"
  },
  "unbonding_responses": [
    {
      "delegator_address": "text",
      "validator_address": "text",
      "entries": [
        {
          "creation_height": "text",
          "completion_time": "2025-02-20T19:22:52.149Z",
          "initial_balance": "text",
          "balance": "text"
        }
      ]
    }
  ]
}

A successful response.

DelegatorValidators queries all validators info for given delegator address.

get

/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators

Path parameters
delegator_addrstringrequired

delegator_addr defines the delegator address to query for.

Query parameters
pagination.keystring · byte

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.offsetstring · uint64

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.limitstring · uint64

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.count_totalboolean

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.reverseboolean

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

Since: cosmos-sdk 0.43

Responses
curl -L \
  --url 'https://lcd.uno.sentry.testnet.v3.kiivalidator.com/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators'
{
  "pagination": {
    "next_key": "text",
    "total": "text"
  },
  "validators": [
    {
      "operator_address": "text",
      "jailed": true,
      "tokens": "text",
      "delegator_shares": "text",
      "unbonding_height": "text",
      "unbonding_time": "2025-02-20T19:22:52.149Z",
      "min_self_delegation": "text",
      "status": "BOND_STATUS_UNSPECIFIED",
      "consensus_pubkey": {
        "@type": "text",
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "description": {
        "moniker": "text",
        "identity": "text",
        "website": "text",
        "security_contact": "text",
        "details": "text"
      },
      "commission": {
        "update_time": "2025-02-20T19:22:52.149Z",
        "commission_rates": {
          "rate": "text",
          "max_rate": "text",
          "max_change_rate": "text"
        }
      }
    }
  ]
}

A successful response.

DelegatorValidator queries validator info for given delegator validator pair.

get

/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators/{validator_addr}

Path parameters
delegator_addrstringrequired

delegator_addr defines the delegator address to query for.

validator_addrstringrequired

validator_addr defines the validator address to query for.

Responses
curl -L \
  --url 'https://lcd.uno.sentry.testnet.v3.kiivalidator.com/cosmos/staking/v1beta1/delegators/{delegator_addr}/validators/{validator_addr}'
{
  "validator": {
    "operator_address": "text",
    "jailed": true,
    "tokens": "text",
    "delegator_shares": "text",
    "unbonding_height": "text",
    "unbonding_time": "2025-02-20T19:22:52.149Z",
    "min_self_delegation": "text",
    "status": "BOND_STATUS_UNSPECIFIED",
    "consensus_pubkey": {
      "@type": "text",
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "description": {
      "moniker": "text",
      "identity": "text",
      "website": "text",
      "security_contact": "text",
      "details": "text"
    },
    "commission": {
      "update_time": "2025-02-20T19:22:52.149Z",
      "commission_rates": {
        "rate": "text",
        "max_rate": "text",
        "max_change_rate": "text"
      }
    }
  }
}

A successful response.

HistoricalInfo queries the historical info for given height.

get

/cosmos/staking/v1beta1/historical_info/{height}

Path parameters
heightstring · int64required

height defines at which height to query the historical info.

Responses
curl -L \
  --url 'https://lcd.uno.sentry.testnet.v3.kiivalidator.com/cosmos/staking/v1beta1/historical_info/{height}'
{
  "hist": {
    "header": {
      "chain_id": "text",
      "height": "text",
      "time": "2025-02-20T19:22:52.149Z",
      "last_commit_hash": "text",
      "data_hash": "text",
      "validators_hash": "text",
      "next_validators_hash": "text",
      "consensus_hash": "text",
      "app_hash": "text",
      "last_results_hash": "text",
      "evidence_hash": "text",
      "proposer_address": "text",
      "version": {
        "block": "text",
        "app": "text"
      },
      "last_block_id": {
        "hash": "text",
        "part_set_header": {
          "total": 1,
          "hash": "text"
        }
      }
    },
    "valset": [
      {
        "operator_address": "text",
        "jailed": true,
        "tokens": "text",
        "delegator_shares": "text",
        "unbonding_height": "text",
        "unbonding_time": "2025-02-20T19:22:52.149Z",
        "min_self_delegation": "text",
        "status": "BOND_STATUS_UNSPECIFIED",
        "consensus_pubkey": {
          "@type": "text",
          "ANY_ADDITIONAL_PROPERTY": "anything"
        },
        "description": {
          "moniker": "text",
          "identity": "text",
          "website": "text",
          "security_contact": "text",
          "details": "text"
        },
        "commission": {
          "update_time": "2025-02-20T19:22:52.149Z",
          "commission_rates": {
            "rate": "text",
            "max_rate": "text",
            "max_change_rate": "text"
          }
        }
      }
    ]
  }
}

A successful response.

Parameters queries the staking parameters.

get

/cosmos/staking/v1beta1/params

Responses
curl -L \
  --url 'https://lcd.uno.sentry.testnet.v3.kiivalidator.com/cosmos/staking/v1beta1/params'
{
  "params": {
    "unbonding_time": "text",
    "max_validators": 1,
    "max_entries": 1,
    "historical_entries": 1,
    "bond_denom": "text",
    "min_commission_rate": "text",
    "max_voting_power_ratio": "text",
    "max_voting_power_enforcement_threshold": "text"
  }
}

A successful response.

Pool queries the pool info.

get

/cosmos/staking/v1beta1/pool

Responses
curl -L \
  --url 'https://lcd.uno.sentry.testnet.v3.kiivalidator.com/cosmos/staking/v1beta1/pool'
{
  "pool": {
    "not_bonded_tokens": "text",
    "bonded_tokens": "text"
  }
}

A successful response.

Validators queries all validators that match the given status.

get

/cosmos/staking/v1beta1/validators

Query parameters
statusstring

status enables to query for validators matching a given status.

pagination.keystring · byte

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.offsetstring · uint64

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.limitstring · uint64

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.count_totalboolean

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.reverseboolean

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

Since: cosmos-sdk 0.43

Responses
curl -L \
  --url 'https://lcd.uno.sentry.testnet.v3.kiivalidator.com/cosmos/staking/v1beta1/validators'
{
  "pagination": {
    "next_key": "text",
    "total": "text"
  },
  "validators": [
    {
      "operator_address": "text",
      "jailed": true,
      "tokens": "text",
      "delegator_shares": "text",
      "unbonding_height": "text",
      "unbonding_time": "2025-02-20T19:22:52.149Z",
      "min_self_delegation": "text",
      "status": "BOND_STATUS_UNSPECIFIED",
      "consensus_pubkey": {
        "@type": "text",
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "description": {
        "moniker": "text",
        "identity": "text",
        "website": "text",
        "security_contact": "text",
        "details": "text"
      },
      "commission": {
        "update_time": "2025-02-20T19:22:52.149Z",
        "commission_rates": {
          "rate": "text",
          "max_rate": "text",
          "max_change_rate": "text"
        }
      }
    }
  ]
}

A successful response.

Validator queries validator info for given validator address.

get

/cosmos/staking/v1beta1/validators/{validator_addr}

Path parameters
validator_addrstringrequired

validator_addr defines the validator address to query for.

Responses
curl -L \
  --url 'https://lcd.uno.sentry.testnet.v3.kiivalidator.com/cosmos/staking/v1beta1/validators/{validator_addr}'
{
  "validator": {
    "operator_address": "text",
    "jailed": true,
    "tokens": "text",
    "delegator_shares": "text",
    "unbonding_height": "text",
    "unbonding_time": "2025-02-20T19:22:52.149Z",
    "min_self_delegation": "text",
    "status": "BOND_STATUS_UNSPECIFIED",
    "consensus_pubkey": {
      "@type": "text",
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "description": {
      "moniker": "text",
      "identity": "text",
      "website": "text",
      "security_contact": "text",
      "details": "text"
    },
    "commission": {
      "update_time": "2025-02-20T19:22:52.149Z",
      "commission_rates": {
        "rate": "text",
        "max_rate": "text",
        "max_change_rate": "text"
      }
    }
  }
}

A successful response.

ValidatorDelegations queries delegate info for given validator.

get

/cosmos/staking/v1beta1/validators/{validator_addr}/delegations

Path parameters
validator_addrstringrequired

validator_addr defines the validator address to query for.

Query parameters
pagination.keystring · byte

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.offsetstring · uint64

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.limitstring · uint64

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.count_totalboolean

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.reverseboolean

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

Since: cosmos-sdk 0.43

Responses
curl -L \
  --url 'https://lcd.uno.sentry.testnet.v3.kiivalidator.com/cosmos/staking/v1beta1/validators/{validator_addr}/delegations'
{
  "pagination": {
    "next_key": "text",
    "total": "text"
  },
  "delegation_responses": [
    {
      "delegation": {
        "delegator_address": "text",
        "validator_address": "text",
        "shares": "text"
      },
      "balance": {
        "denom": "text",
        "amount": "text"
      }
    }
  ]
}

A successful response.

Delegation queries delegate info for given validator delegator pair.

get

/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}

Path parameters
validator_addrstringrequired

validator_addr defines the validator address to query for.

delegator_addrstringrequired

delegator_addr defines the delegator address to query for.

Responses
curl -L \
  --url 'https://lcd.uno.sentry.testnet.v3.kiivalidator.com/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}'
{
  "delegation_response": {
    "delegation": {
      "delegator_address": "text",
      "validator_address": "text",
      "shares": "text"
    },
    "balance": {
      "denom": "text",
      "amount": "text"
    }
  }
}

A successful response.

UnbondingDelegation queries unbonding info for given validator delegator pair.

get

/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}/unbonding_delegation

Path parameters
validator_addrstringrequired

validator_addr defines the validator address to query for.

delegator_addrstringrequired

delegator_addr defines the delegator address to query for.

Responses
curl -L \
  --url 'https://lcd.uno.sentry.testnet.v3.kiivalidator.com/cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}/unbonding_delegation'
{
  "unbond": {
    "delegator_address": "text",
    "validator_address": "text",
    "entries": [
      {
        "creation_height": "text",
        "completion_time": "2025-02-20T19:22:52.149Z",
        "initial_balance": "text",
        "balance": "text"
      }
    ]
  }
}

A successful response.

ValidatorUnbondingDelegations queries unbonding delegations of a validator.

get

/cosmos/staking/v1beta1/validators/{validator_addr}/unbonding_delegations

Path parameters
validator_addrstringrequired

validator_addr defines the validator address to query for.

Query parameters
pagination.keystring · byte

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.offsetstring · uint64

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.limitstring · uint64

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.count_totalboolean

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.reverseboolean

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

Since: cosmos-sdk 0.43

Responses
curl -L \
  --url 'https://lcd.uno.sentry.testnet.v3.kiivalidator.com/cosmos/staking/v1beta1/validators/{validator_addr}/unbonding_delegations'
{
  "pagination": {
    "next_key": "text",
    "total": "text"
  },
  "unbonding_responses": [
    {
      "delegator_address": "text",
      "validator_address": "text",
      "entries": [
        {
          "creation_height": "text",
          "completion_time": "2025-02-20T19:22:52.149Z",
          "initial_balance": "text",
          "balance": "text"
        }
      ]
    }
  ]
}

A successful response.

PreviousSlashingNextTx

Last updated