Redelegations

Redelegations queries redelegations of given address.

get

When called from another module, this query might consume a high amount of gas if the pagination field is incorrectly set.

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
200
A successful response.
application/json
get
GET /cosmos/staking/v1beta1/delegators/{delegator_addr}/redelegations HTTP/1.1
Host: agoric.nownodes.io
Accept: */*
{
  "redelegation_responses": [
    {
      "redelegation": {
        "delegator_address": "text",
        "validator_src_address": "text",
        "validator_dst_address": "text",
        "entries": [
          {
            "creation_height": "text",
            "completion_time": "2025-06-27T04:43:27.835Z",
            "initial_balance": "text",
            "shares_dst": "text",
            "unbonding_id": "text",
            "unbonding_on_hold_ref_count": "text"
          }
        ]
      },
      "entries": [
        {
          "redelegation_entry": {
            "creation_height": "text",
            "completion_time": "2025-06-27T04:43:27.835Z",
            "initial_balance": "text",
            "shares_dst": "text",
            "unbonding_id": "text",
            "unbonding_on_hold_ref_count": "text"
          },
          "balance": "text"
        }
      ]
    }
  ],
  "pagination": {
    "next_key": "text",
    "total": "text"
  }
}

Last updated