staking/delegators/{delegatorAddr}/delegations

Submit 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.
  • delegation
KeyRequiredTypeDetail
delegationObjectThe delegation denom and amount.
{
  "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",
  "delegation": {
    "denom": "stake",
    "amount": "50"
  }
}

Result

Transaction broadcasting result.

Example

Request

curl <your-rest-endpoint>/staking/delegators/cosmos16xyempempp92x9hyzz9wrgf94r6j9h5f06pxxv/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\",\"delegation\": {\"denom\": \"stake\",\"amount\": \"50\"}}"

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