staking/delegators/{delegatorAddr}/unbonding_delegations

Submit an unbonding delegation

Parameters

  • base_req - The delegation object
KeyRequiredTypeDetail
fromStringAccount the transaction originates from. This account is used to sign the transaction.
memoStringThe memo or additional address necessary for identifying the recipient beyond the wallet address.
chain_idStringThe unique identifier of the blockchain the transaction pertains to.
account_numberIntegerThe account number
sequenceIntegerThe value of a counter measuring how many transactions have been sent from the account.
gasIntegerThe gas consumed for this transaction.
gas_adjustmentIntegerThe integer use to scale up gas to avoid underestimating.
feeArrayHow much in fees the user is willing to pay in total.
simulateBooleanInstructs the application to ignore gas and simulate the transaction running without broadcasting.

delegator_address

KeyRequiredTypeDetail
delegator_addressStringAccount address of delegator.

validator_address

KeyRequiredTypeDetail
validator_addressStringAccount address of validator.
  • shares
KeyRequiredTypeDetail
sharesIntegerThe total number of tokens delegated to the validator
{
  "base_req": {
    "from": "cosmos1g9ahr6xhht5rmqven628nklxluzyv8z9jqjcmc",
    "memo": "Sent via Cosmos VoyagerŸš€",
    "chain_id": "Cosmos-Hub",
    "account_number": "0",
    "sequence": "1",
    "gas": "200000",
    "gas_adjustment": "1.2",
    "fees": [
      {
        "denom": "stake",
        "amount": "50"
      }
    ],
    "simulate": false
  },
  "delegator_address": "cosmos1depk54cuajgkzea6zpgkq36tnjwdzv4afc3d27",
  "validator_address": "cosmosvaloper16xyempempp92x9hyzz9wrgf94r6j9h5f2w4n2l",
  "shares": "100"
}

Result

Transaction broadcasting result.

Example

Request

curl <your-rest-endpoint>/staking/delegators/cosmos16xyempempp92x9hyzz9wrgf94r6j9h5f06pxxv/unbonding_delegations \
  -X POST \
  -H "accept: application/json" \
  -H "Content-Type: application/json" \
  -d "{\"base_req\": {\"from\": \"cosmos1g9ahr6xhht5rmqven628nklxluzyv8z9jqjcmc\",\"memo\": \"Sent via Cosmos Voyager\",\"chain_id\": \"Cosmos-Hub\",\"account_number\": \"0\",\"sequence\": \"1\",\"gas\": \"200000\",\"gas_adjustment\": \"1.2\",\"fees\": [{\"denom\": \"stake\",\"amount\": \"50\"}],\"simulate\": false},\"delegator_address\": \"cosmos1depk54cuajgkzea6zpgkq36tnjwdzv4afc3d27\",\"validator_address\": \"cosmosvaloper16xyempempp92x9hyzz9wrgf94r6j9h5f2w4n2l\",\"shares\": \"100\"}"

Return

{
  "msg": [
    "string"
  ],
  "fee": {
    "gas": "string",
    "amount": [
      {
        "denom": "stake",
        "amount": "50"
      }
    ]
  },
  "memo": "string",
  "signature": {
    "signature": "MEUCIQD02fsDPra8MtbRsyB1w7bqTM55Wu138zQbFcWx4+CFyAIge5WNPfKIuvzBZ69MyqHsqD8S1IwiEp+iUb6VSdtlpgY=",
    "pub_key": {
      "type": "tendermint/PubKeySecp256k1",
      "value": "Avz04VhtKJh8ACCVzlI8aTosGy0ikFXKIVHQ3jKMrosH"
    },
    "account_number": "0",
    "sequence": "0"
  }
}