Staking

DelegatorDelegations queries all delegations of a given delegator address.

get

Path parameters

delegator_addrstringRequired

delegator_addr defines the delegator address to query for.

Query parameters

pagination.keystringOptional

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 · uint64Optional

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 · uint64Optional

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_totalbooleanOptional

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

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

Since: cosmos-sdk 0.43

Responses

get

HTTPcURLJavaScriptPython

GET /cosmos/staking/v1beta1/delegations/{delegator_addr} HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*

{
  "delegation_responses": [
    {
      "delegation": {
        "delegator_address": "text",
        "validator_address": "text",
        "shares": "text"
      },
      "balance": {
        "denom": "text",
        "amount": "text"
      }
    }
  ],
  "pagination": {
    "next_key": "text",
    "total": "text"
  }
}

Redelegations queries redelegations of given address.

get

Path parameters

delegator_addrstringRequired

delegator_addr defines the delegator address to query for.

Query parameters

src_validator_addrstringOptional

src_validator_addr defines the validator address to redelegate from.

dst_validator_addrstringOptional

dst_validator_addr defines the validator address to redelegate to.

pagination.keystringOptional

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 · uint64Optional

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 · uint64Optional

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_totalbooleanOptional

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

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

Since: cosmos-sdk 0.43

Responses

get

HTTPcURLJavaScriptPython

GET /cosmos/staking/v1beta1/delegators/{delegator_addr}/redelegations HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*

{
  "redelegation_responses": [
    {
      "redelegation": {
        "delegator_address": "text",
        "validator_src_address": "text",
        "validator_dst_address": "text",
        "entries": [
          {
            "creation_height": "text",
            "completion_time": "2025-04-26T10:39:49.179Z",
            "initial_balance": "text",
            "shares_dst": "text"
          }
        ]
      },
      "entries": [
        {
          "redelegation_entry": {
            "creation_height": "text",
            "completion_time": "2025-04-26T10:39:49.179Z",
            "initial_balance": "text",
            "shares_dst": "text"
          },
          "balance": "text"
        }
      ]
    }
  ],
  "pagination": {
    "next_key": "text",
    "total": "text"
  }
}

DelegatorUnbondingDelegations queries all unbonding delegations of a given delegator address.

get

Path parameters

delegator_addrstringRequired

delegator_addr defines the delegator address to query for.

Query parameters

pagination.keystringOptional

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 · uint64Optional

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 · uint64Optional

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_totalbooleanOptional

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

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

Since: cosmos-sdk 0.43

Responses

get

HTTPcURLJavaScriptPython

GET /cosmos/staking/v1beta1/delegators/{delegator_addr}/unbonding_delegations HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*

{
  "unbonding_responses": [
    {
      "delegator_address": "text",
      "validator_address": "text",
      "entries": [
        {
          "creation_height": "text",
          "completion_time": "2025-04-26T10:39:49.179Z",
          "initial_balance": "text",
          "balance": "text"
        }
      ]
    }
  ],
  "pagination": {
    "next_key": "text",
    "total": "text"
  }
}

DelegatorValidators queries all validators info for given delegator address.

get

Path parameters

delegator_addrstringRequired

delegator_addr defines the delegator address to query for.

Query parameters

pagination.keystringOptional

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 · uint64Optional

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 · uint64Optional

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_totalbooleanOptional

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

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

Since: cosmos-sdk 0.43

Responses

get

HTTPcURLJavaScriptPython

GET /cosmos/staking/v1beta1/delegators/{delegator_addr}/validators HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*

{
  "validators": [
    {
      "operator_address": "text",
      "consensus_pubkey": {
        "@type": "text",
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "jailed": true,
      "status": "BOND_STATUS_UNSPECIFIED",
      "tokens": "text",
      "delegator_shares": "text",
      "description": {
        "moniker": "text",
        "identity": "text",
        "website": "text",
        "security_contact": "text",
        "details": "text"
      },
      "unbonding_height": "text",
      "unbonding_time": "2025-04-26T10:39:49.179Z",
      "commission": {
        "commission_rates": {
          "rate": "text",
          "max_rate": "text",
          "max_change_rate": "text"
        },
        "update_time": "2025-04-26T10:39:49.179Z"
      },
      "min_self_delegation": "text"
    }
  ],
  "pagination": {
    "next_key": "text",
    "total": "text"
  }
}

DelegatorValidator queries validator info for given delegator validator pair.

get

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

get

HTTPcURLJavaScriptPython

GET /cosmos/staking/v1beta1/delegators/{delegator_addr}/validators/{validator_addr} HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*

{
  "validator": {
    "operator_address": "text",
    "consensus_pubkey": {
      "@type": "text",
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "jailed": true,
    "status": "BOND_STATUS_UNSPECIFIED",
    "tokens": "text",
    "delegator_shares": "text",
    "description": {
      "moniker": "text",
      "identity": "text",
      "website": "text",
      "security_contact": "text",
      "details": "text"
    },
    "unbonding_height": "text",
    "unbonding_time": "2025-04-26T10:39:49.179Z",
    "commission": {
      "commission_rates": {
        "rate": "text",
        "max_rate": "text",
        "max_change_rate": "text"
      },
      "update_time": "2025-04-26T10:39:49.179Z"
    },
    "min_self_delegation": "text"
  }
}

HistoricalInfo queries the historical info for given height.

get

Path parameters

heightstring · int64Required

height defines at which height to query the historical info.

Responses

get

HTTPcURLJavaScriptPython

GET /cosmos/staking/v1beta1/historical_info/{height} HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*

{
  "hist": {
    "header": {
      "version": {
        "block": "text",
        "app": "text"
      },
      "chain_id": "text",
      "height": "text",
      "time": "2025-04-26T10:39:49.179Z",
      "last_block_id": {
        "hash": "text",
        "part_set_header": {
          "total": 1,
          "hash": "text"
        }
      },
      "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"
    },
    "valset": [
      {
        "operator_address": "text",
        "consensus_pubkey": {
          "@type": "text",
          "ANY_ADDITIONAL_PROPERTY": "anything"
        },
        "jailed": true,
        "status": "BOND_STATUS_UNSPECIFIED",
        "tokens": "text",
        "delegator_shares": "text",
        "description": {
          "moniker": "text",
          "identity": "text",
          "website": "text",
          "security_contact": "text",
          "details": "text"
        },
        "unbonding_height": "text",
        "unbonding_time": "2025-04-26T10:39:49.179Z",
        "commission": {
          "commission_rates": {
            "rate": "text",
            "max_rate": "text",
            "max_change_rate": "text"
          },
          "update_time": "2025-04-26T10:39:49.179Z"
        },
        "min_self_delegation": "text"
      }
    ]
  }
}

Parameters queries the staking parameters.

get

Responses

get

HTTPcURLJavaScriptPython

GET /cosmos/staking/v1beta1/params HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*

{
  "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"
  }
}

Pool queries the pool info.

get

Responses

get

HTTPcURLJavaScriptPython

GET /cosmos/staking/v1beta1/pool HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*

{
  "pool": {
    "not_bonded_tokens": "text",
    "bonded_tokens": "text"
  }
}

Validators queries all validators that match the given status.

get

Query parameters

statusstringOptional

status enables to query for validators matching a given status.

pagination.keystringOptional

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 · uint64Optional

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 · uint64Optional

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_totalbooleanOptional

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

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

Since: cosmos-sdk 0.43

Responses

get

HTTPcURLJavaScriptPython

GET /cosmos/staking/v1beta1/validators HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*

{
  "validators": [
    {
      "operator_address": "text",
      "consensus_pubkey": {
        "@type": "text",
        "ANY_ADDITIONAL_PROPERTY": "anything"
      },
      "jailed": true,
      "status": "BOND_STATUS_UNSPECIFIED",
      "tokens": "text",
      "delegator_shares": "text",
      "description": {
        "moniker": "text",
        "identity": "text",
        "website": "text",
        "security_contact": "text",
        "details": "text"
      },
      "unbonding_height": "text",
      "unbonding_time": "2025-04-26T10:39:49.179Z",
      "commission": {
        "commission_rates": {
          "rate": "text",
          "max_rate": "text",
          "max_change_rate": "text"
        },
        "update_time": "2025-04-26T10:39:49.179Z"
      },
      "min_self_delegation": "text"
    }
  ],
  "pagination": {
    "next_key": "text",
    "total": "text"
  }
}

Validator queries validator info for given validator address.

get

Path parameters

validator_addrstringRequired

validator_addr defines the validator address to query for.

Responses

get

HTTPcURLJavaScriptPython

GET /cosmos/staking/v1beta1/validators/{validator_addr} HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*

{
  "validator": {
    "operator_address": "text",
    "consensus_pubkey": {
      "@type": "text",
      "ANY_ADDITIONAL_PROPERTY": "anything"
    },
    "jailed": true,
    "status": "BOND_STATUS_UNSPECIFIED",
    "tokens": "text",
    "delegator_shares": "text",
    "description": {
      "moniker": "text",
      "identity": "text",
      "website": "text",
      "security_contact": "text",
      "details": "text"
    },
    "unbonding_height": "text",
    "unbonding_time": "2025-04-26T10:39:49.179Z",
    "commission": {
      "commission_rates": {
        "rate": "text",
        "max_rate": "text",
        "max_change_rate": "text"
      },
      "update_time": "2025-04-26T10:39:49.179Z"
    },
    "min_self_delegation": "text"
  }
}

ValidatorDelegations queries delegate info for given validator.

get

Path parameters

validator_addrstringRequired

validator_addr defines the validator address to query for.

Query parameters

pagination.keystringOptional

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 · uint64Optional

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 · uint64Optional

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_totalbooleanOptional

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

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

Since: cosmos-sdk 0.43

Responses

get

HTTPcURLJavaScriptPython

GET /cosmos/staking/v1beta1/validators/{validator_addr}/delegations HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*

{
  "delegation_responses": [
    {
      "delegation": {
        "delegator_address": "text",
        "validator_address": "text",
        "shares": "text"
      },
      "balance": {
        "denom": "text",
        "amount": "text"
      }
    }
  ],
  "pagination": {
    "next_key": "text",
    "total": "text"
  }
}

Delegation queries delegate info for given validator delegator pair.

get

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

get

HTTPcURLJavaScriptPython

GET /cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr} HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*

{
  "delegation_response": {
    "delegation": {
      "delegator_address": "text",
      "validator_address": "text",
      "shares": "text"
    },
    "balance": {
      "denom": "text",
      "amount": "text"
    }
  }
}

UnbondingDelegation queries unbonding info for given validator delegator pair.

get

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

get

HTTPcURLJavaScriptPython

GET /cosmos/staking/v1beta1/validators/{validator_addr}/delegations/{delegator_addr}/unbonding_delegation HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*

{
  "unbond": {
    "delegator_address": "text",
    "validator_address": "text",
    "entries": [
      {
        "creation_height": "text",
        "completion_time": "2025-04-26T10:39:49.179Z",
        "initial_balance": "text",
        "balance": "text"
      }
    ]
  }
}

ValidatorUnbondingDelegations queries unbonding delegations of a validator.

get

Path parameters

validator_addrstringRequired

validator_addr defines the validator address to query for.

Query parameters

pagination.keystringOptional

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 · uint64Optional

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 · uint64Optional

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_totalbooleanOptional

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

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

Since: cosmos-sdk 0.43

Responses

get

HTTPcURLJavaScriptPython

GET /cosmos/staking/v1beta1/validators/{validator_addr}/unbonding_delegations HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*

{
  "unbonding_responses": [
    {
      "delegator_address": "text",
      "validator_address": "text",
      "entries": [
        {
          "creation_height": "text",
          "completion_time": "2025-04-26T10:39:49.179Z",
          "initial_balance": "text",
          "balance": "text"
        }
      ]
    }
  ],
  "pagination": {
    "next_key": "text",
    "total": "text"
  }
}