github.com/Finschia/finschia-sdk@v0.48.1/x/staking/spec/09_client.md (about)

     1  <!--
     2  order: 9
     3  -->
     4  
     5  # Client
     6  
     7  ## CLI
     8  
     9  A user can query and interact with the `staking` module using the CLI.
    10  
    11  ### Query
    12  
    13  The `query` commands allows users to query `staking` state.
    14  
    15  ```bash
    16  simd query staking --help
    17  ```
    18  
    19  #### delegation
    20  
    21  The `delegation` command allows users to query delegations for an individual delegator on an individual validator.
    22  
    23  Usage:
    24  
    25  ```bash
    26  simd query staking delegation [delegator-addr] [validator-addr] [flags]
    27  ```
    28  
    29  Example:
    30  
    31  ```bash
    32  simd query staking delegation cosmos1gghjut3ccd8ay0zduzj64hwre2fxs9ld75ru9p cosmosvaloper1gghjut3ccd8ay0zduzj64hwre2fxs9ldmqhffj
    33  ```
    34  
    35  Example Output:
    36  
    37  ```bash
    38  balance:
    39    amount: "10000000000"
    40    denom: stake
    41  delegation:
    42    delegator_address: cosmos1gghjut3ccd8ay0zduzj64hwre2fxs9ld75ru9p
    43    shares: "10000000000.000000000000000000"
    44    validator_address: cosmosvaloper1gghjut3ccd8ay0zduzj64hwre2fxs9ldmqhffj
    45  ```
    46  
    47  #### delegations
    48  
    49  The `delegations` command allows users to query delegations for an individual delegator on all validators.
    50  
    51  Usage:
    52  
    53  ```bash
    54  simd query staking delegations [delegator-addr] [flags]
    55  ```
    56  
    57  Example:
    58  
    59  ```bash
    60  simd query staking delegations cosmos1gghjut3ccd8ay0zduzj64hwre2fxs9ld75ru9p
    61  ```
    62  
    63  Example Output:
    64  
    65  ```bash
    66  delegation_responses:
    67  - balance:
    68      amount: "10000000000"
    69      denom: stake
    70    delegation:
    71      delegator_address: cosmos1gghjut3ccd8ay0zduzj64hwre2fxs9ld75ru9p
    72      shares: "10000000000.000000000000000000"
    73      validator_address: cosmosvaloper1gghjut3ccd8ay0zduzj64hwre2fxs9ldmqhffj
    74  - balance:
    75      amount: "10000000000"
    76      denom: stake
    77    delegation:
    78      delegator_address: cosmos1gghjut3ccd8ay0zduzj64hwre2fxs9ld75ru9p
    79      shares: "10000000000.000000000000000000"
    80      validator_address: cosmosvaloper1x20lytyf6zkcrv5edpkfkn8sz578qg5sqfyqnp
    81  pagination:
    82    next_key: null
    83    total: "0"
    84  ```
    85  
    86  #### delegations-to
    87  
    88  The `delegations-to` command allows users to query delegations on an individual validator.
    89  
    90  Usage:
    91  
    92  ```bash
    93  simd query staking delegations-to [validator-addr] [flags]
    94  ```
    95  
    96  Example:
    97  
    98  ```bash
    99  simd query staking delegations-to cosmosvaloper1gghjut3ccd8ay0zduzj64hwre2fxs9ldmqhffj
   100  ```
   101  
   102  Example Output:
   103  
   104  ```bash
   105  - balance:
   106      amount: "504000000"
   107      denom: stake
   108    delegation:
   109      delegator_address: cosmos1q2qwwynhv8kh3lu5fkeex4awau9x8fwt45f5cp
   110      shares: "504000000.000000000000000000"
   111      validator_address: cosmosvaloper1gghjut3ccd8ay0zduzj64hwre2fxs9ldmqhffj
   112  - balance:
   113      amount: "78125000000"
   114      denom: uixo
   115    delegation:
   116      delegator_address: cosmos1qvppl3479hw4clahe0kwdlfvf8uvjtcd99m2ca
   117      shares: "78125000000.000000000000000000"
   118      validator_address: cosmosvaloper1gghjut3ccd8ay0zduzj64hwre2fxs9ldmqhffj
   119  pagination:
   120    next_key: null
   121    total: "0"
   122  ```
   123  
   124  #### historical-info
   125  
   126  The `historical-info` command allows users to query historical information at given height.
   127  
   128  Usage:
   129  
   130  ```bash
   131  simd query staking historical-info [height] [flags]
   132  ```
   133  
   134  Example:
   135  
   136  ```bash
   137  simd query staking historical-info 10
   138  ```
   139  
   140  Example Output:
   141  
   142  ```bash
   143  header:
   144    app_hash: Lbx8cXpI868wz8sgp4qPYVrlaKjevR5WP/IjUxwp3oo=
   145    chain_id: testnet
   146    consensus_hash: BICRvH3cKD93v7+R1zxE2ljD34qcvIZ0Bdi389qtoi8=
   147    data_hash: 47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU=
   148    evidence_hash: 47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU=
   149    height: "10"
   150    last_block_id:
   151      hash: RFbkpu6pWfSThXxKKl6EZVDnBSm16+U0l0xVjTX08Fk=
   152      part_set_header:
   153        hash: vpIvXD4rxD5GM4MXGz0Sad9I7//iVYLzZsEU4BVgWIU=
   154        total: 1
   155    last_commit_hash: Ne4uXyx4QtNp4Zx89kf9UK7oG9QVbdB6e7ZwZkhy8K0=
   156    last_results_hash: 47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU=
   157    next_validators_hash: nGBgKeWBjoxeKFti00CxHsnULORgKY4LiuQwBuUrhCs=
   158    proposer_address: mMEP2c2IRPLr99LedSRtBg9eONM=
   159    time: "2021-10-01T06:00:49.785790894Z"
   160    validators_hash: nGBgKeWBjoxeKFti00CxHsnULORgKY4LiuQwBuUrhCs=
   161    version:
   162      app: "0"
   163      block: "11"
   164  valset:
   165  - commission:
   166      commission_rates:
   167        max_change_rate: "0.010000000000000000"
   168        max_rate: "0.200000000000000000"
   169        rate: "0.100000000000000000"
   170      update_time: "2021-10-01T05:52:50.380144238Z"
   171    consensus_pubkey:
   172      '@type': /cosmos.crypto.ed25519.PubKey
   173      key: Auxs3865HpB/EfssYOzfqNhEJjzys2Fo6jD5B8tPgC8=
   174    delegator_shares: "10000000.000000000000000000"
   175    description:
   176      details: ""
   177      identity: ""
   178      moniker: myvalidator
   179      security_contact: ""
   180      website: ""
   181    jailed: false
   182    min_self_delegation: "1"
   183    operator_address: cosmosvaloper1rne8lgs98p0jqe82sgt0qr4rdn4hgvmgp9ggcc
   184    status: BOND_STATUS_BONDED
   185    tokens: "10000000"
   186    unbonding_height: "0"
   187    unbonding_time: "1970-01-01T00:00:00Z"
   188  ```
   189  
   190  #### params
   191  
   192  The `params` command allows users to query values set as staking parameters.
   193  
   194  Usage:
   195  
   196  ```bash
   197  simd query staking params [flags]
   198  ```
   199  
   200  Example:
   201  
   202  ```bash
   203  simd query staking params
   204  ```
   205  
   206  Example Output:
   207  
   208  ```bash
   209  bond_denom: stake
   210  historical_entries: 10000
   211  max_entries: 7
   212  max_validators: 50
   213  unbonding_time: 1814400s
   214  ```
   215  
   216  #### pool
   217  
   218  The `pool` command allows users to query values for amounts stored in the staking pool.
   219  
   220  Usage:
   221  
   222  ```bash
   223  simd q staking pool [flags]
   224  ```
   225  
   226  Example:
   227  
   228  ```bash
   229  simd q staking pool
   230  ```
   231  
   232  Example Output:
   233  
   234  ```bash
   235  bonded_tokens: "10000000"
   236  not_bonded_tokens: "0"
   237  ```
   238  
   239  #### redelegation
   240  
   241  The `redelegation` command allows users to query a redelegation record based on delegator and a source and destination validator address.
   242  
   243  Usage:
   244  
   245  ```bash
   246  simd query staking redelegation [delegator-addr] [src-validator-addr] [dst-validator-addr] [flags]
   247  ```
   248  
   249  Example:
   250  
   251  ```bash
   252  simd query staking redelegation cosmos1gghjut3ccd8ay0zduzj64hwre2fxs9ld75ru9p cosmosvaloper1l2rsakp388kuv9k8qzq6lrm9taddae7fpx59wm cosmosvaloper1gghjut3ccd8ay0zduzj64hwre2fxs9ldmqhffj
   253  ```
   254  
   255  Example Output:
   256  
   257  ```bash
   258  pagination: null
   259  redelegation_responses:
   260  - entries:
   261    - balance: "50000000"
   262      redelegation_entry:
   263        completion_time: "2021-10-24T20:33:21.960084845Z"
   264        creation_height: 2.382847e+06
   265        initial_balance: "50000000"
   266        shares_dst: "50000000.000000000000000000"
   267    - balance: "5000000000"
   268      redelegation_entry:
   269        completion_time: "2021-10-25T21:33:54.446846862Z"
   270        creation_height: 2.397271e+06
   271        initial_balance: "5000000000"
   272        shares_dst: "5000000000.000000000000000000"
   273    redelegation:
   274      delegator_address: cosmos1gghjut3ccd8ay0zduzj64hwre2fxs9ld75ru9p
   275      entries: null
   276      validator_dst_address: cosmosvaloper1l2rsakp388kuv9k8qzq6lrm9taddae7fpx59wm
   277      validator_src_address: cosmosvaloper1l2rsakp388kuv9k8qzq6lrm9taddae7fpx59wm
   278  ```
   279  
   280  #### redelegations
   281  
   282  The `redelegations` command allows users to query all redelegation records for an individual delegator.
   283  
   284  Usage:
   285  
   286  ```bash
   287  simd query staking redelegations [delegator-addr] [flags]
   288  ```
   289  
   290  Example:
   291  
   292  ```bash
   293  simd query staking redelegation cosmos1gghjut3ccd8ay0zduzj64hwre2fxs9ld75ru9p
   294  ```
   295  
   296  Example Output:
   297  
   298  ```bash
   299  pagination:
   300    next_key: null
   301    total: "0"
   302  redelegation_responses:
   303  - entries:
   304    - balance: "50000000"
   305      redelegation_entry:
   306        completion_time: "2021-10-24T20:33:21.960084845Z"
   307        creation_height: 2.382847e+06
   308        initial_balance: "50000000"
   309        shares_dst: "50000000.000000000000000000"
   310    - balance: "5000000000"
   311      redelegation_entry:
   312        completion_time: "2021-10-25T21:33:54.446846862Z"
   313        creation_height: 2.397271e+06
   314        initial_balance: "5000000000"
   315        shares_dst: "5000000000.000000000000000000"
   316    redelegation:
   317      delegator_address: cosmos1gghjut3ccd8ay0zduzj64hwre2fxs9ld75ru9p
   318      entries: null
   319      validator_dst_address: cosmosvaloper1uccl5ugxrm7vqlzwqr04pjd320d2fz0z3hc6vm
   320      validator_src_address: cosmosvaloper1zppjyal5emta5cquje8ndkpz0rs046m7zqxrpp
   321  - entries:
   322    - balance: "562770000000"
   323      redelegation_entry:
   324        completion_time: "2021-10-25T21:42:07.336911677Z"
   325        creation_height: 2.39735e+06
   326        initial_balance: "562770000000"
   327        shares_dst: "562770000000.000000000000000000"
   328    redelegation:
   329      delegator_address: cosmos1gghjut3ccd8ay0zduzj64hwre2fxs9ld75ru9p
   330      entries: null
   331      validator_dst_address: cosmosvaloper1uccl5ugxrm7vqlzwqr04pjd320d2fz0z3hc6vm
   332      validator_src_address: cosmosvaloper1zppjyal5emta5cquje8ndkpz0rs046m7zqxrpp
   333  ```
   334  
   335  #### redelegations-from
   336  
   337  The `redelegations-from` command allows users to query delegations that are redelegating _from_ a validator.
   338  
   339  Usage:
   340  
   341  ```bash
   342  simd query staking redelegations-from [validator-addr] [flags]
   343  ```
   344  
   345  Example:
   346  
   347  ```bash
   348  simd query staking redelegations-from cosmosvaloper1y4rzzrgl66eyhzt6gse2k7ej3zgwmngeleucjy
   349  ```
   350  
   351  Example Output:
   352  
   353  ```bash
   354  pagination:
   355    next_key: null
   356    total: "0"
   357  redelegation_responses:
   358  - entries:
   359    - balance: "50000000"
   360      redelegation_entry:
   361        completion_time: "2021-10-24T20:33:21.960084845Z"
   362        creation_height: 2.382847e+06
   363        initial_balance: "50000000"
   364        shares_dst: "50000000.000000000000000000"
   365    - balance: "5000000000"
   366      redelegation_entry:
   367        completion_time: "2021-10-25T21:33:54.446846862Z"
   368        creation_height: 2.397271e+06
   369        initial_balance: "5000000000"
   370        shares_dst: "5000000000.000000000000000000"
   371    redelegation:
   372      delegator_address: cosmos1pm6e78p4pgn0da365plzl4t56pxy8hwtqp2mph
   373      entries: null
   374      validator_dst_address: cosmosvaloper1uccl5ugxrm7vqlzwqr04pjd320d2fz0z3hc6vm
   375      validator_src_address: cosmosvaloper1y4rzzrgl66eyhzt6gse2k7ej3zgwmngeleucjy
   376  - entries:
   377    - balance: "221000000"
   378      redelegation_entry:
   379        completion_time: "2021-10-05T21:05:45.669420544Z"
   380        creation_height: 2.120693e+06
   381        initial_balance: "221000000"
   382        shares_dst: "221000000.000000000000000000"
   383    redelegation:
   384      delegator_address: cosmos1zqv8qxy2zgn4c58fz8jt8jmhs3d0attcussrf6
   385      entries: null
   386      validator_dst_address: cosmosvaloper10mseqwnwtjaqfrwwp2nyrruwmjp6u5jhah4c3y
   387      validator_src_address: cosmosvaloper1y4rzzrgl66eyhzt6gse2k7ej3zgwmngeleucjy
   388  ```
   389  
   390  #### unbonding-delegation
   391  
   392  The `unbonding-delegation` command allows users to query unbonding delegations for an individual delegator on an individual validator.
   393  
   394  Usage:
   395  
   396  ```bash
   397  simd query staking unbonding-delegation [delegator-addr] [validator-addr] [flags]
   398  ```
   399  
   400  Example:
   401  
   402  ```bash
   403  simd query staking unbonding-delegation cosmos1gghjut3ccd8ay0zduzj64hwre2fxs9ld75ru9p cosmosvaloper1gghjut3ccd8ay0zduzj64hwre2fxs9ldmqhffj
   404  ```
   405  
   406  Example Output:
   407  
   408  ```bash
   409  delegator_address: cosmos1gghjut3ccd8ay0zduzj64hwre2fxs9ld75ru9p
   410  entries:
   411  - balance: "52000000"
   412    completion_time: "2021-11-02T11:35:55.391594709Z"
   413    creation_height: "55078"
   414    initial_balance: "52000000"
   415  validator_address: cosmosvaloper1gghjut3ccd8ay0zduzj64hwre2fxs9ldmqhffj
   416  ```
   417  
   418  #### unbonding-delegations
   419  
   420  The `unbonding-delegations` command allows users to query all unbonding-delegations records for one delegator.
   421  
   422  Usage:
   423  
   424  ```bash
   425  simd query staking unbonding-delegations [delegator-addr] [flags]
   426  ```
   427  
   428  Example:
   429  
   430  ```bash
   431  simd query staking unbonding-delegations cosmos1gghjut3ccd8ay0zduzj64hwre2fxs9ld75ru9p
   432  ```
   433  
   434  Example Output:
   435  
   436  ```bash
   437  pagination:
   438    next_key: null
   439    total: "0"
   440  unbonding_responses:
   441  - delegator_address: cosmos1gghjut3ccd8ay0zduzj64hwre2fxs9ld75ru9p
   442    entries:
   443    - balance: "52000000"
   444      completion_time: "2021-11-02T11:35:55.391594709Z"
   445      creation_height: "55078"
   446      initial_balance: "52000000"
   447    validator_address: cosmosvaloper1t8ehvswxjfn3ejzkjtntcyrqwvmvuknzmvtaaa
   448  
   449  ```
   450  
   451  #### unbonding-delegations-from
   452  
   453  The `unbonding-delegations-from` command allows users to query delegations that are unbonding _from_ a validator.
   454  
   455  Usage:
   456  
   457  ```bash
   458  simd query staking unbonding-delegations-from [validator-addr] [flags]
   459  ```
   460  
   461  Example:
   462  
   463  ```bash
   464  simd query staking unbonding-delegations-from cosmosvaloper1gghjut3ccd8ay0zduzj64hwre2fxs9ldmqhffj
   465  ```
   466  
   467  Example Output:
   468  
   469  ```bash
   470  pagination:
   471    next_key: null
   472    total: "0"
   473  unbonding_responses:
   474  - delegator_address: cosmos1qqq9txnw4c77sdvzx0tkedsafl5s3vk7hn53fn
   475    entries:
   476    - balance: "150000000"
   477      completion_time: "2021-11-01T21:41:13.098141574Z"
   478      creation_height: "46823"
   479      initial_balance: "150000000"
   480    validator_address: cosmosvaloper1gghjut3ccd8ay0zduzj64hwre2fxs9ldmqhffj
   481  - delegator_address: cosmos1peteje73eklqau66mr7h7rmewmt2vt99y24f5z
   482    entries:
   483    - balance: "24000000"
   484      completion_time: "2021-10-31T02:57:18.192280361Z"
   485      creation_height: "21516"
   486      initial_balance: "24000000"
   487    validator_address: cosmosvaloper1gghjut3ccd8ay0zduzj64hwre2fxs9ldmqhffj
   488  ```
   489  
   490  #### validator
   491  
   492  The `validator` command allows users to query details about an individual validator.
   493  
   494  Usage:
   495  
   496  ```bash
   497  simd query staking validator [validator-addr] [flags]
   498  ```
   499  
   500  Example:
   501  
   502  ```bash
   503  simd query staking validator cosmosvaloper1gghjut3ccd8ay0zduzj64hwre2fxs9ldmqhffj
   504  ```
   505  
   506  Example Output:
   507  
   508  ```bash
   509  commission:
   510    commission_rates:
   511      max_change_rate: "0.020000000000000000"
   512      max_rate: "0.200000000000000000"
   513      rate: "0.050000000000000000"
   514    update_time: "2021-10-01T19:24:52.663191049Z"
   515  consensus_pubkey:
   516    '@type': /cosmos.crypto.ed25519.PubKey
   517    key: sIiexdJdYWn27+7iUHQJDnkp63gq/rzUq1Y+fxoGjXc=
   518  delegator_shares: "32948270000.000000000000000000"
   519  description:
   520    details: Witval is the validator arm from Vitwit. Vitwit is into software consulting
   521      and services business since 2015. We are working closely with Cosmos ecosystem
   522      since 2018. We are also building tools for the ecosystem, Aneka is our explorer
   523      for the cosmos ecosystem.
   524    identity: 51468B615127273A
   525    moniker: Witval
   526    security_contact: ""
   527    website: ""
   528  jailed: false
   529  min_self_delegation: "1"
   530  operator_address: cosmosvaloper1gghjut3ccd8ay0zduzj64hwre2fxs9ldmqhffj
   531  status: BOND_STATUS_BONDED
   532  tokens: "32948270000"
   533  unbonding_height: "0"
   534  unbonding_time: "1970-01-01T00:00:00Z"
   535  ```
   536  
   537  #### validators
   538  
   539  The `validators` command allows users to query details about all validators on a network.
   540  
   541  Usage:
   542  
   543  ```bash
   544  simd query staking validators [flags]
   545  ```
   546  
   547  Example:
   548  
   549  ```bash
   550  simd query staking validators
   551  ```
   552  
   553  Example Output:
   554  
   555  ```bash
   556  pagination:
   557    next_key: FPTi7TKAjN63QqZh+BaXn6gBmD5/
   558    total: "0"
   559  validators:
   560  commission:
   561    commission_rates:
   562      max_change_rate: "0.020000000000000000"
   563      max_rate: "0.200000000000000000"
   564      rate: "0.050000000000000000"
   565    update_time: "2021-10-01T19:24:52.663191049Z"
   566  consensus_pubkey:
   567    '@type': /cosmos.crypto.ed25519.PubKey
   568    key: sIiexdJdYWn27+7iUHQJDnkp63gq/rzUq1Y+fxoGjXc=
   569  delegator_shares: "32948270000.000000000000000000"
   570  description:
   571      details: Witval is the validator arm from Vitwit. Vitwit is into software consulting
   572        and services business since 2015. We are working closely with Cosmos ecosystem
   573        since 2018. We are also building tools for the ecosystem, Aneka is our explorer
   574        for the cosmos ecosystem.
   575      identity: 51468B615127273A
   576      moniker: Witval
   577      security_contact: ""
   578      website: ""
   579    jailed: false
   580    min_self_delegation: "1"
   581    operator_address: cosmosvaloper1gghjut3ccd8ay0zduzj64hwre2fxs9ldmqhffj
   582    status: BOND_STATUS_BONDED
   583    tokens: "32948270000"
   584    unbonding_height: "0"
   585    unbonding_time: "1970-01-01T00:00:00Z"
   586  - commission:
   587      commission_rates:
   588        max_change_rate: "0.100000000000000000"
   589        max_rate: "0.200000000000000000"
   590        rate: "0.050000000000000000"
   591      update_time: "2021-10-04T18:02:21.446645619Z"
   592    consensus_pubkey:
   593      '@type': /cosmos.crypto.ed25519.PubKey
   594      key: GDNpuKDmCg9GnhnsiU4fCWktuGUemjNfvpCZiqoRIYA=
   595    delegator_shares: "559343421.000000000000000000"
   596    description:
   597      details: Noderunners is a professional validator in POS networks. We have a huge
   598        node running experience, reliable soft and hardware. Our commissions are always
   599        low, our support to delegators is always full. Stake with us and start receiving
   600        your Cosmos rewards now!
   601      identity: 812E82D12FEA3493
   602      moniker: Noderunners
   603      security_contact: info@noderunners.biz
   604      website: http://noderunners.biz
   605    jailed: false
   606    min_self_delegation: "1"
   607    operator_address: cosmosvaloper1q5ku90atkhktze83j9xjaks2p7uruag5zp6wt7
   608    status: BOND_STATUS_BONDED
   609    tokens: "559343421"
   610    unbonding_height: "0"
   611    unbonding_time: "1970-01-01T00:00:00Z"
   612  ```
   613  
   614  ### Transactions
   615  
   616  The `tx` commands allows users to interact with the `staking` module.
   617  
   618  ```bash
   619  simd tx staking --help
   620  ```
   621  
   622  #### create-validator
   623  
   624  The command `create-validator` allows users to create new validator initialized with a self-delegation to it.
   625  
   626  Usage:
   627  
   628  ```bash
   629  simd tx staking create-validator [flags]
   630  ```
   631  
   632  Example:
   633  
   634  ```bash
   635  simd tx staking create-validator \
   636    --amount=1000000stake \
   637    --pubkey=$(simd tendermint show-validator) \
   638    --moniker="my-moniker" \
   639    --website="https://myweb.site" \
   640    --details="description of your validator" \
   641    --chain-id="name_of_chain_id" \
   642    --commission-rate="0.10" \
   643    --commission-max-rate="0.20" \
   644    --commission-max-change-rate="0.01" \
   645    --min-self-delegation="1" \
   646    --gas="auto" \
   647    --gas-adjustment="1.2" \
   648    --gas-prices="0.025stake" \
   649    --from=mykey
   650  ```
   651  
   652  #### delegate
   653  
   654  The command `delegate` allows users to delegate liquid tokens to a validator.
   655  
   656  Usage:
   657  
   658  ```bash
   659  simd tx staking delegate [validator-addr] [amount] [flags]
   660  ```
   661  
   662  Example:
   663  
   664  ```bash
   665  simd tx staking delegate cosmosvaloper1l2rsakp388kuv9k8qzq6lrm9taddae7fpx59wm 1000stake --from mykey
   666  ```
   667  
   668  #### edit-validator
   669  
   670  The command `edit-validator` allows users to edit an existing validator account.
   671  
   672  Usage:
   673  
   674  ```bash
   675  simd tx staking edit-validator [flags]
   676  ```
   677  
   678  Example:
   679  
   680  ```bash
   681  simd tx staking edit-validator --moniker "new_moniker_name" --website "new_webiste_url" --from mykey
   682  ```
   683  
   684  #### redelegate
   685  
   686  The command `redelegate` allows users to redelegate illiquid tokens from one validator to another.
   687  
   688  Usage:
   689  
   690  ```bash
   691  simd tx staking redelegate [src-validator-addr] [dst-validator-addr] [amount] [flags]
   692  ```
   693  
   694  Example:
   695  
   696  ```bash
   697  simd tx staking redelegate cosmosvaloper1gghjut3ccd8ay0zduzj64hwre2fxs9ldmqhffj cosmosvaloper1l2rsakp388kuv9k8qzq6lrm9taddae7fpx59wm 100stake --from mykey
   698  ```
   699  
   700  #### unbond
   701  
   702  The command `unbond` allows users to unbond shares from a validator.
   703  
   704  Usage:
   705  
   706  ```bash
   707  simd tx staking unbond [validator-addr] [amount] [flags]
   708  ```
   709  
   710  Example:
   711  
   712  ```bash
   713  simd tx staking unbond cosmosvaloper1gghjut3ccd8ay0zduzj64hwre2fxs9ldmqhffj 100stake --from mykey
   714  ```
   715  
   716  ## gRPC
   717  
   718  A user can query the `staking` module using gRPC endpoints.
   719  
   720  ### Validators
   721  
   722  The `Validators` endpoint queries all validators that match the given status.
   723  
   724  ```bash
   725  cosmos.staking.v1beta1.Query/Validators
   726  ```
   727  
   728  Example:
   729  
   730  ```bash
   731  grpcurl -plaintext localhost:9090 cosmos.staking.v1beta1.Query/Validators
   732  ```
   733  
   734  Example Output:
   735  
   736  ```bash
   737  {
   738    "validators": [
   739      {
   740        "operatorAddress": "cosmosvaloper1rne8lgs98p0jqe82sgt0qr4rdn4hgvmgp9ggcc",
   741        "consensusPubkey": {"@type":"/cosmos.crypto.ed25519.PubKey","key":"Auxs3865HpB/EfssYOzfqNhEJjzys2Fo6jD5B8tPgC8="},
   742        "status": "BOND_STATUS_BONDED",
   743        "tokens": "10000000",
   744        "delegatorShares": "10000000000000000000000000",
   745        "description": {
   746          "moniker": "myvalidator"
   747        },
   748        "unbondingTime": "1970-01-01T00:00:00Z",
   749        "commission": {
   750          "commissionRates": {
   751            "rate": "100000000000000000",
   752            "maxRate": "200000000000000000",
   753            "maxChangeRate": "10000000000000000"
   754          },
   755          "updateTime": "2021-10-01T05:52:50.380144238Z"
   756        },
   757        "minSelfDelegation": "1"
   758      }
   759    ],
   760    "pagination": {
   761      "total": "1"
   762    }
   763  }
   764  ```
   765  
   766  ### Validator
   767  
   768  The `Validator` endpoint queries validator information for given validator address.
   769  
   770  ```bash
   771  cosmos.staking.v1beta1.Query/Validator
   772  ```
   773  
   774  Example:
   775  
   776  ```bash
   777  grpcurl -plaintext -d '{"validator_addr":"cosmosvaloper1rne8lgs98p0jqe82sgt0qr4rdn4hgvmgp9ggcc"}' \
   778  localhost:9090 cosmos.staking.v1beta1.Query/Validator
   779  ```
   780  
   781  Example Output:
   782  
   783  ```bash
   784  {
   785    "validator": {
   786      "operatorAddress": "cosmosvaloper1rne8lgs98p0jqe82sgt0qr4rdn4hgvmgp9ggcc",
   787      "consensusPubkey": {"@type":"/cosmos.crypto.ed25519.PubKey","key":"Auxs3865HpB/EfssYOzfqNhEJjzys2Fo6jD5B8tPgC8="},
   788      "status": "BOND_STATUS_BONDED",
   789      "tokens": "10000000",
   790      "delegatorShares": "10000000000000000000000000",
   791      "description": {
   792        "moniker": "myvalidator"
   793      },
   794      "unbondingTime": "1970-01-01T00:00:00Z",
   795      "commission": {
   796        "commissionRates": {
   797          "rate": "100000000000000000",
   798          "maxRate": "200000000000000000",
   799          "maxChangeRate": "10000000000000000"
   800        },
   801        "updateTime": "2021-10-01T05:52:50.380144238Z"
   802      },
   803      "minSelfDelegation": "1"
   804    }
   805  }
   806  ```
   807  
   808  ### ValidatorDelegations
   809  
   810  The `ValidatorDelegations` endpoint queries delegate information for given validator.
   811  
   812  ```bash
   813  cosmos.staking.v1beta1.Query/ValidatorDelegations
   814  ```
   815  
   816  Example:
   817  
   818  ```bash
   819  grpcurl -plaintext -d '{"validator_addr":"cosmosvaloper1rne8lgs98p0jqe82sgt0qr4rdn4hgvmgp9ggcc"}' \
   820  localhost:9090 cosmos.staking.v1beta1.Query/ValidatorDelegations
   821  ```
   822  
   823  Example Output:
   824  
   825  ```bash
   826  {
   827    "delegationResponses": [
   828      {
   829        "delegation": {
   830          "delegatorAddress": "cosmos1rne8lgs98p0jqe82sgt0qr4rdn4hgvmgy3ua5t",
   831          "validatorAddress": "cosmosvaloper1rne8lgs98p0jqe82sgt0qr4rdn4hgvmgp9ggcc",
   832          "shares": "10000000000000000000000000"
   833        },
   834        "balance": {
   835          "denom": "stake",
   836          "amount": "10000000"
   837        }
   838      }
   839    ],
   840    "pagination": {
   841      "total": "1"
   842    }
   843  }
   844  ```
   845  
   846  ### ValidatorUnbondingDelegations
   847  
   848  The `ValidatorUnbondingDelegations` endpoint queries delegate information for given validator.
   849  
   850  ```bash
   851  cosmos.staking.v1beta1.Query/ValidatorUnbondingDelegations
   852  ```
   853  
   854  Example:
   855  
   856  ```bash
   857  grpcurl -plaintext -d '{"validator_addr":"cosmosvaloper1rne8lgs98p0jqe82sgt0qr4rdn4hgvmgp9ggcc"}' \
   858  localhost:9090 cosmos.staking.v1beta1.Query/ValidatorUnbondingDelegations
   859  ```
   860  
   861  Example Output:
   862  
   863  ```bash
   864  {
   865    "unbonding_responses": [
   866      {
   867        "delegator_address": "cosmos1z3pzzw84d6xn00pw9dy3yapqypfde7vg6965fy",
   868        "validator_address": "cosmosvaloper1rne8lgs98p0jqe82sgt0qr4rdn4hgvmgp9ggcc",
   869        "entries": [
   870          {
   871            "creation_height": "25325",
   872            "completion_time": "2021-10-31T09:24:36.797320636Z",
   873            "initial_balance": "20000000",
   874            "balance": "20000000"
   875          }
   876        ]
   877      },
   878      {
   879        "delegator_address": "cosmos1y8nyfvmqh50p6ldpzljk3yrglppdv3t8phju77",
   880        "validator_address": "cosmosvaloper1rne8lgs98p0jqe82sgt0qr4rdn4hgvmgp9ggcc",
   881        "entries": [
   882          {
   883            "creation_height": "13100",
   884            "completion_time": "2021-10-30T12:53:02.272266791Z",
   885            "initial_balance": "1000000",
   886            "balance": "1000000"
   887          }
   888        ]
   889      },
   890    ],
   891    "pagination": {
   892      "next_key": null,
   893      "total": "8"
   894    }
   895  }
   896  ```
   897  
   898  ### Delegation
   899  
   900  The `Delegation` endpoint queries delegate information for given validator delegator pair.
   901  
   902  ```bash
   903  cosmos.staking.v1beta1.Query/Delegation
   904  ```
   905  
   906  Example:
   907  
   908  ```bash
   909  grpcurl -plaintext \
   910  -d '{"delegator_addr": "cosmos1y8nyfvmqh50p6ldpzljk3yrglppdv3t8phju77", validator_addr":"cosmosvaloper1rne8lgs98p0jqe82sgt0qr4rdn4hgvmgp9ggcc"}' \
   911  localhost:9090 cosmos.staking.v1beta1.Query/Delegation
   912  ```
   913  
   914  Example Output:
   915  
   916  ```bash
   917  {
   918    "delegation_response":
   919    {
   920      "delegation":
   921        {
   922          "delegator_address":"cosmos1y8nyfvmqh50p6ldpzljk3yrglppdv3t8phju77",
   923          "validator_address":"cosmosvaloper1rne8lgs98p0jqe82sgt0qr4rdn4hgvmgp9ggcc",
   924          "shares":"25083119936.000000000000000000"
   925        },
   926      "balance":
   927        {
   928          "denom":"stake",
   929          "amount":"25083119936"
   930        }
   931    }
   932  }
   933  ```
   934  
   935  ### UnbondingDelegation
   936  
   937  The `UnbondingDelegation` endpoint queries unbonding information for given validator delegator.
   938  
   939  ```bash
   940  cosmos.staking.v1beta1.Query/UnbondingDelegation
   941  ```
   942  
   943  Example:
   944  
   945  ```bash
   946  grpcurl -plaintext \
   947  -d '{"delegator_addr": "cosmos1y8nyfvmqh50p6ldpzljk3yrglppdv3t8phju77", validator_addr":"cosmosvaloper1rne8lgs98p0jqe82sgt0qr4rdn4hgvmgp9ggcc"}' \
   948  localhost:9090 cosmos.staking.v1beta1.Query/UnbondingDelegation
   949  ```
   950  
   951  Example Output:
   952  
   953  ```bash
   954  {
   955    "unbond": {
   956      "delegator_address": "cosmos1y8nyfvmqh50p6ldpzljk3yrglppdv3t8phju77",
   957      "validator_address": "cosmosvaloper1rne8lgs98p0jqe82sgt0qr4rdn4hgvmgp9ggcc",
   958      "entries": [
   959        {
   960          "creation_height": "136984",
   961          "completion_time": "2021-11-08T05:38:47.505593891Z",
   962          "initial_balance": "400000000",
   963          "balance": "400000000"
   964        },
   965        {
   966          "creation_height": "137005",
   967          "completion_time": "2021-11-08T05:40:53.526196312Z",
   968          "initial_balance": "385000000",
   969          "balance": "385000000"
   970        }
   971      ]
   972    }
   973  }
   974  ```
   975  
   976  ### DelegatorDelegations
   977  
   978  The `DelegatorDelegations` endpoint queries all delegations of a given delegator address.
   979  
   980  ```bash
   981  cosmos.staking.v1beta1.Query/DelegatorDelegations
   982  ```
   983  
   984  Example:
   985  
   986  ```bash
   987  grpcurl -plaintext \
   988  -d '{"delegator_addr": "cosmos1y8nyfvmqh50p6ldpzljk3yrglppdv3t8phju77"}' \
   989  localhost:9090 cosmos.staking.v1beta1.Query/DelegatorDelegations
   990  ```
   991  
   992  Example Output:
   993  
   994  ```bash
   995  {
   996    "delegation_responses": [
   997      {"delegation":{"delegator_address":"cosmos1y8nyfvmqh50p6ldpzljk3yrglppdv3t8phju77","validator_address":"cosmosvaloper1eh5mwu044gd5ntkkc2xgfg8247mgc56fww3vc8","shares":"25083339023.000000000000000000"},"balance":{"denom":"stake","amount":"25083339023"}}
   998    ],
   999    "pagination": {
  1000      "next_key": null,
  1001      "total": "1"
  1002    }
  1003  }
  1004  ```
  1005  
  1006  ### DelegatorUnbondingDelegations
  1007  
  1008  The `DelegatorUnbondingDelegations` endpoint queries all unbonding delegations of a given delegator address.
  1009  
  1010  ```bash
  1011  cosmos.staking.v1beta1.Query/DelegatorUnbondingDelegations
  1012  ```
  1013  
  1014  Example:
  1015  
  1016  ```bash
  1017  grpcurl -plaintext \
  1018  -d '{"delegator_addr": "cosmos1y8nyfvmqh50p6ldpzljk3yrglppdv3t8phju77"}' \
  1019  localhost:9090 cosmos.staking.v1beta1.Query/DelegatorUnbondingDelegations
  1020  ```
  1021  
  1022  Example Output:
  1023  
  1024  ```bash
  1025  {
  1026    "unbonding_responses": [
  1027      {
  1028        "delegator_address": "cosmos1y8nyfvmqh50p6ldpzljk3yrglppdv3t8phju77",
  1029        "validator_address": "cosmosvaloper1sjllsnramtg3ewxqwwrwjxfgc4n4ef9uxyejze",
  1030        "entries": [
  1031          {
  1032            "creation_height": "136984",
  1033            "completion_time": "2021-11-08T05:38:47.505593891Z",
  1034            "initial_balance": "400000000",
  1035            "balance": "400000000"
  1036          },
  1037          {
  1038            "creation_height": "137005",
  1039            "completion_time": "2021-11-08T05:40:53.526196312Z",
  1040            "initial_balance": "385000000",
  1041            "balance": "385000000"
  1042          }
  1043        ]
  1044      }
  1045    ],
  1046    "pagination": {
  1047      "next_key": null,
  1048      "total": "1"
  1049    }
  1050  }
  1051  ```
  1052  
  1053  ### Redelegations
  1054  
  1055  The `Redelegations` endpoint queries redelegations of given address.
  1056  
  1057  ```bash
  1058  cosmos.staking.v1beta1.Query/Redelegations
  1059  ```
  1060  
  1061  Example:
  1062  
  1063  ```bash
  1064  grpcurl -plaintext \
  1065  -d '{"delegator_addr": "cosmos1ld5p7hn43yuh8ht28gm9pfjgj2fctujp2tgwvf", "src_validator_addr" : "cosmosvaloper1j7euyj85fv2jugejrktj540emh9353ltgppc3g", "dst_validator_addr" : "cosmosvaloper1yy3tnegzmkdcm7czzcy3flw5z0zyr9vkkxrfse"}' \
  1066  localhost:9090 cosmos.staking.v1beta1.Query/Redelegations
  1067  ```
  1068  
  1069  Example Output:
  1070  
  1071  ```bash
  1072  {
  1073    "redelegation_responses": [
  1074      {
  1075        "redelegation": {
  1076          "delegator_address": "cosmos1ld5p7hn43yuh8ht28gm9pfjgj2fctujp2tgwvf",
  1077          "validator_src_address": "cosmosvaloper1j7euyj85fv2jugejrktj540emh9353ltgppc3g",
  1078          "validator_dst_address": "cosmosvaloper1yy3tnegzmkdcm7czzcy3flw5z0zyr9vkkxrfse",
  1079          "entries": null
  1080        },
  1081        "entries": [
  1082          {
  1083            "redelegation_entry": {
  1084              "creation_height": 135932,
  1085              "completion_time": "2021-11-08T03:52:55.299147901Z",
  1086              "initial_balance": "2900000",
  1087              "shares_dst": "2900000.000000000000000000"
  1088            },
  1089            "balance": "2900000"
  1090          }
  1091        ]
  1092      }
  1093    ],
  1094    "pagination": null
  1095  }
  1096  ```
  1097  
  1098  ### DelegatorValidators
  1099  
  1100  The `DelegatorValidators` endpoint queries all validators information for given delegator.
  1101  
  1102  ```bash
  1103  cosmos.staking.v1beta1.Query/DelegatorValidators
  1104  ```
  1105  
  1106  Example:
  1107  
  1108  ```bash
  1109  grpcurl -plaintext \
  1110  -d '{"delegator_addr": "cosmos1ld5p7hn43yuh8ht28gm9pfjgj2fctujp2tgwvf"}' \
  1111  localhost:9090 cosmos.staking.v1beta1.Query/DelegatorValidators
  1112  ```
  1113  
  1114  Example Output:
  1115  
  1116  ```bash
  1117  {
  1118    "validators": [
  1119      {
  1120        "operator_address": "cosmosvaloper1eh5mwu044gd5ntkkc2xgfg8247mgc56fww3vc8",
  1121        "consensus_pubkey": {
  1122          "@type": "/cosmos.crypto.ed25519.PubKey",
  1123          "key": "UPwHWxH1zHJWGOa/m6JB3f5YjHMvPQPkVbDqqi+U7Uw="
  1124        },
  1125        "jailed": false,
  1126        "status": "BOND_STATUS_BONDED",
  1127        "tokens": "347260647559",
  1128        "delegator_shares": "347260647559.000000000000000000",
  1129        "description": {
  1130          "moniker": "BouBouNode",
  1131          "identity": "",
  1132          "website": "https://boubounode.com",
  1133          "security_contact": "",
  1134          "details": "AI-based Validator. #1 AI Validator on Game of Stakes. Fairly priced. Don't trust (humans), verify. Made with BouBou love."
  1135        },
  1136        "unbonding_height": "0",
  1137        "unbonding_time": "1970-01-01T00:00:00Z",
  1138        "commission": {
  1139          "commission_rates": {
  1140            "rate": "0.061000000000000000",
  1141            "max_rate": "0.300000000000000000",
  1142            "max_change_rate": "0.150000000000000000"
  1143          },
  1144          "update_time": "2021-10-01T15:00:00Z"
  1145        },
  1146        "min_self_delegation": "1"
  1147      }
  1148    ],
  1149    "pagination": {
  1150      "next_key": null,
  1151      "total": "1"
  1152    }
  1153  }
  1154  ```
  1155  
  1156  ### DelegatorValidator
  1157  
  1158  The `DelegatorValidator` endpoint queries validator information for given delegator validator
  1159  
  1160  ```bash
  1161  cosmos.staking.v1beta1.Query/DelegatorValidator
  1162  ```
  1163  
  1164  Example:
  1165  
  1166  ```bash
  1167  grpcurl -plaintext \
  1168  -d '{"delegator_addr": "cosmos1eh5mwu044gd5ntkkc2xgfg8247mgc56f3n8rr7", "validator_addr": "cosmosvaloper1eh5mwu044gd5ntkkc2xgfg8247mgc56fww3vc8"}' \
  1169  localhost:9090 cosmos.staking.v1beta1.Query/DelegatorValidator
  1170  ```
  1171  
  1172  Example Output:
  1173  
  1174  ```bash
  1175  {
  1176    "validator": {
  1177      "operator_address": "cosmosvaloper1eh5mwu044gd5ntkkc2xgfg8247mgc56fww3vc8",
  1178      "consensus_pubkey": {
  1179        "@type": "/cosmos.crypto.ed25519.PubKey",
  1180        "key": "UPwHWxH1zHJWGOa/m6JB3f5YjHMvPQPkVbDqqi+U7Uw="
  1181      },
  1182      "jailed": false,
  1183      "status": "BOND_STATUS_BONDED",
  1184      "tokens": "347262754841",
  1185      "delegator_shares": "347262754841.000000000000000000",
  1186      "description": {
  1187        "moniker": "BouBouNode",
  1188        "identity": "",
  1189        "website": "https://boubounode.com",
  1190        "security_contact": "",
  1191        "details": "AI-based Validator. #1 AI Validator on Game of Stakes. Fairly priced. Don't trust (humans), verify. Made with BouBou love."
  1192      },
  1193      "unbonding_height": "0",
  1194      "unbonding_time": "1970-01-01T00:00:00Z",
  1195      "commission": {
  1196        "commission_rates": {
  1197          "rate": "0.061000000000000000",
  1198          "max_rate": "0.300000000000000000",
  1199          "max_change_rate": "0.150000000000000000"
  1200        },
  1201        "update_time": "2021-10-01T15:00:00Z"
  1202      },
  1203      "min_self_delegation": "1"
  1204    }
  1205  }
  1206  ```
  1207  
  1208  ### HistoricalInfo
  1209  
  1210  ```bash
  1211  cosmos.staking.v1beta1.Query/HistoricalInfo
  1212  ```
  1213  
  1214  Example:
  1215  
  1216  ```bash
  1217  grpcurl -plaintext -d '{"height" : 1}' localhost:9090 cosmos.staking.v1beta1.Query/HistoricalInfo
  1218  ```
  1219  
  1220  Example Output:
  1221  
  1222  ```bash
  1223  {
  1224    "hist": {
  1225      "header": {
  1226        "version": {
  1227          "block": "11",
  1228          "app": "0"
  1229        },
  1230        "chain_id": "simd-1",
  1231        "height": "140142",
  1232        "time": "2021-10-11T10:56:29.720079569Z",
  1233        "last_block_id": {
  1234          "hash": "9gri/4LLJUBFqioQ3NzZIP9/7YHR9QqaM6B2aJNQA7o=",
  1235          "part_set_header": {
  1236            "total": 1,
  1237            "hash": "Hk1+C864uQkl9+I6Zn7IurBZBKUevqlVtU7VqaZl1tc="
  1238          }
  1239        },
  1240        "last_commit_hash": "VxrcS27GtvGruS3I9+AlpT7udxIT1F0OrRklrVFSSKc=",
  1241        "data_hash": "80BjOrqNYUOkTnmgWyz9AQ8n7SoEmPVi4QmAe8RbQBY=",
  1242        "validators_hash": "95W49n2hw8RWpr1GPTAO5MSPi6w6Wjr3JjjS7AjpBho=",
  1243        "next_validators_hash": "95W49n2hw8RWpr1GPTAO5MSPi6w6Wjr3JjjS7AjpBho=",
  1244        "consensus_hash": "BICRvH3cKD93v7+R1zxE2ljD34qcvIZ0Bdi389qtoi8=",
  1245        "app_hash": "ZZaxnSY3E6Ex5Bvkm+RigYCK82g8SSUL53NymPITeOE=",
  1246        "last_results_hash": "47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU=",
  1247        "evidence_hash": "47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU=",
  1248        "proposer_address": "aH6dO428B+ItuoqPq70efFHrSMY="
  1249      },
  1250    "valset": [
  1251        {
  1252          "operator_address": "cosmosvaloper196ax4vc0lwpxndu9dyhvca7jhxp70rmcqcnylw",
  1253          "consensus_pubkey": {
  1254            "@type": "/cosmos.crypto.ed25519.PubKey",
  1255            "key": "/O7BtNW0pafwfvomgR4ZnfldwPXiFfJs9mHg3gwfv5Q="
  1256          },
  1257          "jailed": false,
  1258          "status": "BOND_STATUS_BONDED",
  1259          "tokens": "1426045203613",
  1260          "delegator_shares": "1426045203613.000000000000000000",
  1261          "description": {
  1262            "moniker": "SG-1",
  1263            "identity": "48608633F99D1B60",
  1264            "website": "https://sg-1.online",
  1265            "security_contact": "",
  1266            "details": "SG-1 - your favorite validator on Witval. We offer 100% Soft Slash protection."
  1267          },
  1268          "unbonding_height": "0",
  1269          "unbonding_time": "1970-01-01T00:00:00Z",
  1270          "commission": {
  1271            "commission_rates": {
  1272              "rate": "0.037500000000000000",
  1273              "max_rate": "0.200000000000000000",
  1274              "max_change_rate": "0.030000000000000000"
  1275            },
  1276            "update_time": "2021-10-01T15:00:00Z"
  1277          },
  1278          "min_self_delegation": "1"
  1279        }
  1280      ]
  1281    }
  1282  }
  1283  
  1284  ```
  1285  
  1286  ### Pool
  1287  
  1288  The `Pool` endpoint queries the pool information.
  1289  
  1290  ```bash
  1291  cosmos.staking.v1beta1.Query/Pool
  1292  ```
  1293  
  1294  Example:
  1295  
  1296  ```bash
  1297  grpcurl -plaintext -d localhost:9090 cosmos.staking.v1beta1.Query/Pool
  1298  ```
  1299  
  1300  Example Output:
  1301  
  1302  ```bash
  1303  {
  1304    "pool": {
  1305      "not_bonded_tokens": "369054400189",
  1306      "bonded_tokens": "15657192425623"
  1307    }
  1308  }
  1309  ```
  1310  
  1311  ### Params
  1312  
  1313  The `Params` endpoint queries the pool information.
  1314  
  1315  ```bash
  1316  cosmos.staking.v1beta1.Query/Params
  1317  ```
  1318  
  1319  Example:
  1320  
  1321  ```bash
  1322  grpcurl -plaintext localhost:9090 cosmos.staking.v1beta1.Query/Params
  1323  ```
  1324  
  1325  Example Output:
  1326  
  1327  ```bash
  1328  {
  1329    "params": {
  1330      "unbondingTime": "1814400s",
  1331      "maxValidators": 100,
  1332      "maxEntries": 7,
  1333      "historicalEntries": 10000,
  1334      "bondDenom": "stake"
  1335    }
  1336  }
  1337  ```
  1338  
  1339  ## REST
  1340  
  1341  A user can query the `staking` module using REST endpoints.
  1342  
  1343  ### DelegatorDelegations
  1344  
  1345  The `DelegtaorDelegations` REST endpoint queries all delegations of a given delegator address.
  1346  
  1347  ```bash
  1348  /cosmos/staking/v1beta1/delegations/{delegatorAddr}
  1349  ```
  1350  
  1351  Example:
  1352  
  1353  ```bash
  1354  curl -X GET "http://localhost:1317/cosmos/staking/v1beta1/delegations/cosmos1vcs68xf2tnqes5tg0khr0vyevm40ff6zdxatp5" -H  "accept: application/json"
  1355  ```
  1356  
  1357  Example Output:
  1358  
  1359  ```bash
  1360  {
  1361    "delegation_responses": [
  1362      {
  1363        "delegation": {
  1364          "delegator_address": "cosmos1vcs68xf2tnqes5tg0khr0vyevm40ff6zdxatp5",
  1365          "validator_address": "cosmosvaloper1quqxfrxkycr0uzt4yk0d57tcq3zk7srm7sm6r8",
  1366          "shares": "256250000.000000000000000000"
  1367        },
  1368        "balance": {
  1369          "denom": "stake",
  1370          "amount": "256250000"
  1371        }
  1372      },
  1373      {
  1374        "delegation": {
  1375          "delegator_address": "cosmos1vcs68xf2tnqes5tg0khr0vyevm40ff6zdxatp5",
  1376          "validator_address": "cosmosvaloper194v8uwee2fvs2s8fa5k7j03ktwc87h5ym39jfv",
  1377          "shares": "255150000.000000000000000000"
  1378        },
  1379        "balance": {
  1380          "denom": "stake",
  1381          "amount": "255150000"
  1382        }
  1383      }
  1384    ],
  1385    "pagination": {
  1386      "next_key": null,
  1387      "total": "2"
  1388    }
  1389  }
  1390  ```
  1391  
  1392  ### Redelegations
  1393  
  1394  The `Redelegations` REST endpoint queries redelegations of given address.
  1395  
  1396  ```bash
  1397  /cosmos/staking/v1beta1/delegators/{delegatorAddr}/redelegations
  1398  ```
  1399  
  1400  Example:
  1401  
  1402  ```bash
  1403  curl -X GET \
  1404  "http://localhost:1317/cosmos/staking/v1beta1/delegators/cosmos1thfntksw0d35n2tkr0k8v54fr8wxtxwxl2c56e/redelegations?srcValidatorAddr=cosmosvaloper1lzhlnpahvznwfv4jmay2tgaha5kmz5qx4cuznf&dstValidatorAddr=cosmosvaloper1vq8tw77kp8lvxq9u3c8eeln9zymn68rng8pgt4" \
  1405  -H  "accept: application/json"
  1406  ```
  1407  
  1408  Example Output:
  1409  
  1410  ```bash
  1411  {
  1412    "redelegation_responses": [
  1413      {
  1414        "redelegation": {
  1415          "delegator_address": "cosmos1thfntksw0d35n2tkr0k8v54fr8wxtxwxl2c56e",
  1416          "validator_src_address": "cosmosvaloper1lzhlnpahvznwfv4jmay2tgaha5kmz5qx4cuznf",
  1417          "validator_dst_address": "cosmosvaloper1vq8tw77kp8lvxq9u3c8eeln9zymn68rng8pgt4",
  1418          "entries": null
  1419        },
  1420        "entries": [
  1421          {
  1422            "redelegation_entry": {
  1423              "creation_height": 151523,
  1424              "completion_time": "2021-11-09T06:03:25.640682116Z",
  1425              "initial_balance": "200000000",
  1426              "shares_dst": "200000000.000000000000000000"
  1427            },
  1428            "balance": "200000000"
  1429          }
  1430        ]
  1431      }
  1432    ],
  1433    "pagination": null
  1434  }
  1435  ```
  1436  
  1437  ### DelegatorUnbondingDelegations
  1438  
  1439  The `DelegatorUnbondingDelegations` REST endpoint queries all unbonding delegations of a given delegator address.
  1440  
  1441  ```bash
  1442  /cosmos/staking/v1beta1/delegators/{delegatorAddr}/unbonding_delegations
  1443  ```
  1444  
  1445  Example:
  1446  
  1447  ```bash
  1448  curl -X GET \
  1449  "http://localhost:1317/cosmos/staking/v1beta1/delegators/cosmos1nxv42u3lv642q0fuzu2qmrku27zgut3n3z7lll/unbonding_delegations" \
  1450  -H  "accept: application/json"
  1451  ```
  1452  
  1453  Example Output:
  1454  
  1455  ```bash
  1456  {
  1457    "unbonding_responses": [
  1458      {
  1459        "delegator_address": "cosmos1nxv42u3lv642q0fuzu2qmrku27zgut3n3z7lll",
  1460        "validator_address": "cosmosvaloper1e7mvqlz50ch6gw4yjfemsc069wfre4qwmw53kq",
  1461        "entries": [
  1462          {
  1463            "creation_height": "2442278",
  1464            "completion_time": "2021-10-12T10:59:03.797335857Z",
  1465            "initial_balance": "50000000000",
  1466            "balance": "50000000000"
  1467          }
  1468        ]
  1469      }
  1470    ],
  1471    "pagination": {
  1472      "next_key": null,
  1473      "total": "1"
  1474    }
  1475  }
  1476  ```
  1477  
  1478  ### DelegatorValidators
  1479  
  1480  The `DelegatorValidators` REST endpoint queries all validators information for given delegator address.
  1481  
  1482  ```bash
  1483  /cosmos/staking/v1beta1/delegators/{delegatorAddr}/validators
  1484  ```
  1485  
  1486  Example:
  1487  
  1488  ```bash
  1489  curl -X GET \
  1490  "http://localhost:1317/cosmos/staking/v1beta1/delegators/cosmos1xwazl8ftks4gn00y5x3c47auquc62ssune9ppv/validators" \
  1491  -H  "accept: application/json"
  1492  ```
  1493  
  1494  Example Output:
  1495  
  1496  ```bash
  1497  {
  1498    "validators": [
  1499      {
  1500        "operator_address": "cosmosvaloper1xwazl8ftks4gn00y5x3c47auquc62ssuvynw64",
  1501        "consensus_pubkey": {
  1502          "@type": "/cosmos.crypto.ed25519.PubKey",
  1503          "key": "5v4n3px3PkfNnKflSgepDnsMQR1hiNXnqOC11Y72/PQ="
  1504        },
  1505        "jailed": false,
  1506        "status": "BOND_STATUS_BONDED",
  1507        "tokens": "21592843799",
  1508        "delegator_shares": "21592843799.000000000000000000",
  1509        "description": {
  1510          "moniker": "jabbey",
  1511          "identity": "",
  1512          "website": "https://twitter.com/JoeAbbey",
  1513          "security_contact": "",
  1514          "details": "just another dad in the cosmos"
  1515        },
  1516        "unbonding_height": "0",
  1517        "unbonding_time": "1970-01-01T00:00:00Z",
  1518        "commission": {
  1519          "commission_rates": {
  1520            "rate": "0.100000000000000000",
  1521            "max_rate": "0.200000000000000000",
  1522            "max_change_rate": "0.100000000000000000"
  1523          },
  1524          "update_time": "2021-10-09T19:03:54.984821705Z"
  1525        },
  1526        "min_self_delegation": "1"
  1527      }
  1528    ],
  1529    "pagination": {
  1530      "next_key": null,
  1531      "total": "1"
  1532    }
  1533  }
  1534  ```
  1535  
  1536  ### DelegatorValidator
  1537  
  1538  The `DelegatorValidator` REST endpoint queries validator information for given delegator validator pair.
  1539  
  1540  ```bash
  1541  /cosmos/staking/v1beta1/delegators/{delegatorAddr}/validators/{validatorAddr}
  1542  ```
  1543  
  1544  Example:
  1545  
  1546  ```bash
  1547  curl -X GET \
  1548  "http://localhost:1317/cosmos/staking/v1beta1/delegators/cosmos1xwazl8ftks4gn00y5x3c47auquc62ssune9ppv/validators/cosmosvaloper1xwazl8ftks4gn00y5x3c47auquc62ssuvynw64" \
  1549  -H  "accept: application/json"
  1550  ```
  1551  
  1552  Example Output:
  1553  
  1554  ```bash
  1555  {
  1556    "validator": {
  1557      "operator_address": "cosmosvaloper1xwazl8ftks4gn00y5x3c47auquc62ssuvynw64",
  1558      "consensus_pubkey": {
  1559        "@type": "/cosmos.crypto.ed25519.PubKey",
  1560        "key": "5v4n3px3PkfNnKflSgepDnsMQR1hiNXnqOC11Y72/PQ="
  1561      },
  1562      "jailed": false,
  1563      "status": "BOND_STATUS_BONDED",
  1564      "tokens": "21592843799",
  1565      "delegator_shares": "21592843799.000000000000000000",
  1566      "description": {
  1567        "moniker": "jabbey",
  1568        "identity": "",
  1569        "website": "https://twitter.com/JoeAbbey",
  1570        "security_contact": "",
  1571        "details": "just another dad in the cosmos"
  1572      },
  1573      "unbonding_height": "0",
  1574      "unbonding_time": "1970-01-01T00:00:00Z",
  1575      "commission": {
  1576        "commission_rates": {
  1577          "rate": "0.100000000000000000",
  1578          "max_rate": "0.200000000000000000",
  1579          "max_change_rate": "0.100000000000000000"
  1580        },
  1581        "update_time": "2021-10-09T19:03:54.984821705Z"
  1582      },
  1583      "min_self_delegation": "1"
  1584    }
  1585  }
  1586  ```
  1587  
  1588  ### HistoricalInfo
  1589  
  1590  The `HistoricalInfo` REST endpoint queries the historical information for given height.
  1591  
  1592  ```bash
  1593  /cosmos/staking/v1beta1/historical_info/{height}
  1594  ```
  1595  
  1596  Example:
  1597  
  1598  ```bash
  1599  curl -X GET "http://localhost:1317/cosmos/staking/v1beta1/historical_info/153332" -H  "accept: application/json"
  1600  ```
  1601  
  1602  Example Output:
  1603  
  1604  ```bash
  1605  {
  1606    "hist": {
  1607      "header": {
  1608        "version": {
  1609          "block": "11",
  1610          "app": "0"
  1611        },
  1612        "chain_id": "cosmos-1",
  1613        "height": "153332",
  1614        "time": "2021-10-12T09:05:35.062230221Z",
  1615        "last_block_id": {
  1616          "hash": "NX8HevR5khb7H6NGKva+jVz7cyf0skF1CrcY9A0s+d8=",
  1617          "part_set_header": {
  1618            "total": 1,
  1619            "hash": "zLQ2FiKM5tooL3BInt+VVfgzjlBXfq0Hc8Iux/xrhdg="
  1620          }
  1621        },
  1622        "last_commit_hash": "P6IJrK8vSqU3dGEyRHnAFocoDGja0bn9euLuy09s350=",
  1623        "data_hash": "eUd+6acHWrNXYju8Js449RJ99lOYOs16KpqQl4SMrEM=",
  1624        "validators_hash": "mB4pravvMsJKgi+g8aYdSeNlt0kPjnRFyvtAQtaxcfw=",
  1625        "next_validators_hash": "mB4pravvMsJKgi+g8aYdSeNlt0kPjnRFyvtAQtaxcfw=",
  1626        "consensus_hash": "BICRvH3cKD93v7+R1zxE2ljD34qcvIZ0Bdi389qtoi8=",
  1627        "app_hash": "fuELArKRK+CptnZ8tu54h6xEleSWenHNmqC84W866fU=",
  1628        "last_results_hash": "p/BPexV4LxAzlVcPRvW+lomgXb6Yze8YLIQUo/4Kdgc=",
  1629        "evidence_hash": "47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU=",
  1630        "proposer_address": "G0MeY8xQx7ooOsni8KE/3R/Ib3Q="
  1631      },
  1632      "valset": [
  1633        {
  1634          "operator_address": "cosmosvaloper196ax4vc0lwpxndu9dyhvca7jhxp70rmcqcnylw",
  1635          "consensus_pubkey": {
  1636            "@type": "/cosmos.crypto.ed25519.PubKey",
  1637            "key": "/O7BtNW0pafwfvomgR4ZnfldwPXiFfJs9mHg3gwfv5Q="
  1638          },
  1639          "jailed": false,
  1640          "status": "BOND_STATUS_BONDED",
  1641          "tokens": "1416521659632",
  1642          "delegator_shares": "1416521659632.000000000000000000",
  1643          "description": {
  1644            "moniker": "SG-1",
  1645            "identity": "48608633F99D1B60",
  1646            "website": "https://sg-1.online",
  1647            "security_contact": "",
  1648            "details": "SG-1 - your favorite validator on cosmos. We offer 100% Soft Slash protection."
  1649          },
  1650          "unbonding_height": "0",
  1651          "unbonding_time": "1970-01-01T00:00:00Z",
  1652          "commission": {
  1653            "commission_rates": {
  1654              "rate": "0.037500000000000000",
  1655              "max_rate": "0.200000000000000000",
  1656              "max_change_rate": "0.030000000000000000"
  1657            },
  1658            "update_time": "2021-10-01T15:00:00Z"
  1659          },
  1660          "min_self_delegation": "1"
  1661        },
  1662        {
  1663          "operator_address": "cosmosvaloper1t8ehvswxjfn3ejzkjtntcyrqwvmvuknzmvtaaa",
  1664          "consensus_pubkey": {
  1665            "@type": "/cosmos.crypto.ed25519.PubKey",
  1666            "key": "uExZyjNLtr2+FFIhNDAMcQ8+yTrqE7ygYTsI7khkA5Y="
  1667          },
  1668          "jailed": false,
  1669          "status": "BOND_STATUS_BONDED",
  1670          "tokens": "1348298958808",
  1671          "delegator_shares": "1348298958808.000000000000000000",
  1672          "description": {
  1673            "moniker": "Cosmostation",
  1674            "identity": "AE4C403A6E7AA1AC",
  1675            "website": "https://www.cosmostation.io",
  1676            "security_contact": "admin@stamper.network",
  1677            "details": "Cosmostation validator node. Delegate your tokens and Start Earning Staking Rewards"
  1678          },
  1679          "unbonding_height": "0",
  1680          "unbonding_time": "1970-01-01T00:00:00Z",
  1681          "commission": {
  1682            "commission_rates": {
  1683              "rate": "0.050000000000000000",
  1684              "max_rate": "1.000000000000000000",
  1685              "max_change_rate": "0.200000000000000000"
  1686            },
  1687            "update_time": "2021-10-01T15:06:38.821314287Z"
  1688          },
  1689          "min_self_delegation": "1"
  1690        }
  1691      ]
  1692    }
  1693  }
  1694  ```
  1695  
  1696  ### Parameters
  1697  
  1698  The `Parameters` REST endpoint queries the staking parameters.
  1699  
  1700  ```bash
  1701  /cosmos/staking/v1beta1/params
  1702  ```
  1703  
  1704  Example:
  1705  
  1706  ```bash
  1707  curl -X GET "http://localhost:1317/cosmos/staking/v1beta1/params" -H  "accept: application/json"
  1708  ```
  1709  
  1710  Example Output:
  1711  
  1712  ```bash
  1713  {
  1714    "params": {
  1715      "unbonding_time": "2419200s",
  1716      "max_validators": 100,
  1717      "max_entries": 7,
  1718      "historical_entries": 10000,
  1719      "bond_denom": "stake"
  1720    }
  1721  }
  1722  ```
  1723  
  1724  ### Pool
  1725  
  1726  The `Pool` REST endpoint queries the pool information.
  1727  
  1728  ```bash
  1729  /cosmos/staking/v1beta1/pool
  1730  ```
  1731  
  1732  Example:
  1733  
  1734  ```bash
  1735  curl -X GET "http://localhost:1317/cosmos/staking/v1beta1/pool" -H  "accept: application/json"
  1736  ```
  1737  
  1738  Example Output:
  1739  
  1740  ```bash
  1741  {
  1742    "pool": {
  1743      "not_bonded_tokens": "432805737458",
  1744      "bonded_tokens": "15783637712645"
  1745    }
  1746  }
  1747  ```
  1748  
  1749  ### Validators
  1750  
  1751  The `Validators` REST endpoint queries all validators that match the given status.
  1752  
  1753  ```bash
  1754  /cosmos/staking/v1beta1/validators
  1755  ```
  1756  
  1757  Example:
  1758  
  1759  ```bash
  1760  curl -X GET "http://localhost:1317/cosmos/staking/v1beta1/validators" -H  "accept: application/json"
  1761  ```
  1762  
  1763  Example Output:
  1764  
  1765  ```bash
  1766  {
  1767    "validators": [
  1768      {
  1769        "operator_address": "cosmosvaloper1q3jsx9dpfhtyqqgetwpe5tmk8f0ms5qywje8tw",
  1770        "consensus_pubkey": {
  1771          "@type": "/cosmos.crypto.ed25519.PubKey",
  1772          "key": "N7BPyek2aKuNZ0N/8YsrqSDhGZmgVaYUBuddY8pwKaE="
  1773        },
  1774        "jailed": false,
  1775        "status": "BOND_STATUS_BONDED",
  1776        "tokens": "383301887799",
  1777        "delegator_shares": "383301887799.000000000000000000",
  1778        "description": {
  1779          "moniker": "SmartNodes",
  1780          "identity": "D372724899D1EDC8",
  1781          "website": "https://smartnodes.co",
  1782          "security_contact": "",
  1783          "details": "Earn Rewards with Crypto Staking & Node Deployment"
  1784        },
  1785        "unbonding_height": "0",
  1786        "unbonding_time": "1970-01-01T00:00:00Z",
  1787        "commission": {
  1788          "commission_rates": {
  1789            "rate": "0.050000000000000000",
  1790            "max_rate": "0.200000000000000000",
  1791            "max_change_rate": "0.100000000000000000"
  1792          },
  1793          "update_time": "2021-10-01T15:51:31.596618510Z"
  1794        },
  1795        "min_self_delegation": "1"
  1796      },
  1797      {
  1798        "operator_address": "cosmosvaloper1q5ku90atkhktze83j9xjaks2p7uruag5zp6wt7",
  1799        "consensus_pubkey": {
  1800          "@type": "/cosmos.crypto.ed25519.PubKey",
  1801          "key": "GDNpuKDmCg9GnhnsiU4fCWktuGUemjNfvpCZiqoRIYA="
  1802        },
  1803        "jailed": false,
  1804        "status": "BOND_STATUS_UNBONDING",
  1805        "tokens": "1017819654",
  1806        "delegator_shares": "1017819654.000000000000000000",
  1807        "description": {
  1808          "moniker": "Noderunners",
  1809          "identity": "812E82D12FEA3493",
  1810          "website": "http://noderunners.biz",
  1811          "security_contact": "info@noderunners.biz",
  1812          "details": "Noderunners is a professional validator in POS networks. We have a huge node running experience, reliable soft and hardware. Our commissions are always low, our support to delegators is always full. Stake with us and start receiving your cosmos rewards now!"
  1813        },
  1814        "unbonding_height": "147302",
  1815        "unbonding_time": "2021-11-08T22:58:53.718662452Z",
  1816        "commission": {
  1817          "commission_rates": {
  1818            "rate": "0.050000000000000000",
  1819            "max_rate": "0.200000000000000000",
  1820            "max_change_rate": "0.100000000000000000"
  1821          },
  1822          "update_time": "2021-10-04T18:02:21.446645619Z"
  1823        },
  1824        "min_self_delegation": "1"
  1825      }
  1826    ],
  1827    "pagination": {
  1828      "next_key": "FONDBFkE4tEEf7yxWWKOD49jC2NK",
  1829      "total": "2"
  1830    }
  1831  }
  1832  ```
  1833  
  1834  ### Validator
  1835  
  1836  The `Validator` REST endpoint queries validator information for given validator address.
  1837  
  1838  ```bash
  1839  /cosmos/staking/v1beta1/validators/{validatorAddr}
  1840  ```
  1841  
  1842  Example:
  1843  
  1844  ```bash
  1845  curl -X GET \
  1846  "http://localhost:1317/cosmos/staking/v1beta1/validators/cosmosvaloper16msryt3fqlxtvsy8u5ay7wv2p8mglfg9g70e3q" \
  1847  -H  "accept: application/json"
  1848  ```
  1849  
  1850  Example Output:
  1851  
  1852  ```bash
  1853  {
  1854    "validator": {
  1855      "operator_address": "cosmosvaloper16msryt3fqlxtvsy8u5ay7wv2p8mglfg9g70e3q",
  1856      "consensus_pubkey": {
  1857        "@type": "/cosmos.crypto.ed25519.PubKey",
  1858        "key": "sIiexdJdYWn27+7iUHQJDnkp63gq/rzUq1Y+fxoGjXc="
  1859      },
  1860      "jailed": false,
  1861      "status": "BOND_STATUS_BONDED",
  1862      "tokens": "33027900000",
  1863      "delegator_shares": "33027900000.000000000000000000",
  1864      "description": {
  1865        "moniker": "Witval",
  1866        "identity": "51468B615127273A",
  1867        "website": "",
  1868        "security_contact": "",
  1869        "details": "Witval is the validator arm from Vitwit. Vitwit is into software consulting and services business since 2015. We are working closely with Cosmos ecosystem since 2018. We are also building tools for the ecosystem, Aneka is our explorer for the cosmos ecosystem."
  1870      },
  1871      "unbonding_height": "0",
  1872      "unbonding_time": "1970-01-01T00:00:00Z",
  1873      "commission": {
  1874        "commission_rates": {
  1875          "rate": "0.050000000000000000",
  1876          "max_rate": "0.200000000000000000",
  1877          "max_change_rate": "0.020000000000000000"
  1878        },
  1879        "update_time": "2021-10-01T19:24:52.663191049Z"
  1880      },
  1881      "min_self_delegation": "1"
  1882    }
  1883  }
  1884  ```
  1885  
  1886  ### ValidatorDelegations
  1887  
  1888  The `ValidatorDelegations` REST endpoint queries delegate information for given validator.
  1889  
  1890  ```bash
  1891  /cosmos/staking/v1beta1/validators/{validatorAddr}/delegations
  1892  ```
  1893  
  1894  Example:
  1895  
  1896  ```bash
  1897  curl -X GET "http://localhost:1317/cosmos/staking/v1beta1/validators/cosmosvaloper16msryt3fqlxtvsy8u5ay7wv2p8mglfg9g70e3q/delegations" -H  "accept: application/json"
  1898  ```
  1899  
  1900  Example Output:
  1901  
  1902  ```bash
  1903  {
  1904    "delegation_responses": [
  1905      {
  1906        "delegation": {
  1907          "delegator_address": "cosmos190g5j8aszqhvtg7cprmev8xcxs6csra7xnk3n3",
  1908          "validator_address": "cosmosvaloper16msryt3fqlxtvsy8u5ay7wv2p8mglfg9g70e3q",
  1909          "shares": "31000000000.000000000000000000"
  1910        },
  1911        "balance": {
  1912          "denom": "stake",
  1913          "amount": "31000000000"
  1914        }
  1915      },
  1916      {
  1917        "delegation": {
  1918          "delegator_address": "cosmos1ddle9tczl87gsvmeva3c48nenyng4n56qwq4ee",
  1919          "validator_address": "cosmosvaloper16msryt3fqlxtvsy8u5ay7wv2p8mglfg9g70e3q",
  1920          "shares": "628470000.000000000000000000"
  1921        },
  1922        "balance": {
  1923          "denom": "stake",
  1924          "amount": "628470000"
  1925        }
  1926      },
  1927      {
  1928        "delegation": {
  1929          "delegator_address": "cosmos10fdvkczl76m040smd33lh9xn9j0cf26kk4s2nw",
  1930          "validator_address": "cosmosvaloper16msryt3fqlxtvsy8u5ay7wv2p8mglfg9g70e3q",
  1931          "shares": "838120000.000000000000000000"
  1932        },
  1933        "balance": {
  1934          "denom": "stake",
  1935          "amount": "838120000"
  1936        }
  1937      },
  1938      {
  1939        "delegation": {
  1940          "delegator_address": "cosmos1n8f5fknsv2yt7a8u6nrx30zqy7lu9jfm0t5lq8",
  1941          "validator_address": "cosmosvaloper16msryt3fqlxtvsy8u5ay7wv2p8mglfg9g70e3q",
  1942          "shares": "500000000.000000000000000000"
  1943        },
  1944        "balance": {
  1945          "denom": "stake",
  1946          "amount": "500000000"
  1947        }
  1948      },
  1949      {
  1950        "delegation": {
  1951          "delegator_address": "cosmos16msryt3fqlxtvsy8u5ay7wv2p8mglfg9hrek2e",
  1952          "validator_address": "cosmosvaloper16msryt3fqlxtvsy8u5ay7wv2p8mglfg9g70e3q",
  1953          "shares": "61310000.000000000000000000"
  1954        },
  1955        "balance": {
  1956          "denom": "stake",
  1957          "amount": "61310000"
  1958        }
  1959      }
  1960    ],
  1961    "pagination": {
  1962      "next_key": null,
  1963      "total": "5"
  1964    }
  1965  }
  1966  ```
  1967  
  1968  ### Delegation
  1969  
  1970  The `Delegation` REST endpoint queries delegate information for given validator delegator pair.
  1971  
  1972  ```bash
  1973  /cosmos/staking/v1beta1/validators/{validatorAddr}/delegations/{delegatorAddr}
  1974  ```
  1975  
  1976  Example:
  1977  
  1978  ```bash
  1979  curl -X GET \
  1980  "http://localhost:1317/cosmos/staking/v1beta1/validators/cosmosvaloper16msryt3fqlxtvsy8u5ay7wv2p8mglfg9g70e3q/delegations/cosmos1n8f5fknsv2yt7a8u6nrx30zqy7lu9jfm0t5lq8" \
  1981  -H  "accept: application/json"
  1982  ```
  1983  
  1984  Example Output:
  1985  
  1986  ```bash
  1987  {
  1988    "delegation_response": {
  1989      "delegation": {
  1990        "delegator_address": "cosmos1n8f5fknsv2yt7a8u6nrx30zqy7lu9jfm0t5lq8",
  1991        "validator_address": "cosmosvaloper16msryt3fqlxtvsy8u5ay7wv2p8mglfg9g70e3q",
  1992        "shares": "500000000.000000000000000000"
  1993      },
  1994      "balance": {
  1995        "denom": "stake",
  1996        "amount": "500000000"
  1997      }
  1998    }
  1999  }
  2000  ```
  2001  
  2002  ### UnbondingDelegation
  2003  
  2004  The `UnbondingDelegation` REST endpoint queries unbonding information for given validator delegator pair.
  2005  
  2006  ```bash
  2007  /cosmos/staking/v1beta1/validators/{validatorAddr}/delegations/{delegatorAddr}/unbonding_delegation
  2008  ```
  2009  
  2010  Example:
  2011  
  2012  ```bash
  2013  curl -X GET \
  2014  "http://localhost:1317/cosmos/staking/v1beta1/validators/cosmosvaloper13v4spsah85ps4vtrw07vzea37gq5la5gktlkeu/delegations/cosmos1ze2ye5u5k3qdlexvt2e0nn0508p04094ya0qpm/unbonding_delegation" \
  2015  -H  "accept: application/json"
  2016  ```
  2017  
  2018  Example Output:
  2019  
  2020  ```bash
  2021  {
  2022    "unbond": {
  2023      "delegator_address": "cosmos1ze2ye5u5k3qdlexvt2e0nn0508p04094ya0qpm",
  2024      "validator_address": "cosmosvaloper13v4spsah85ps4vtrw07vzea37gq5la5gktlkeu",
  2025      "entries": [
  2026        {
  2027          "creation_height": "153687",
  2028          "completion_time": "2021-11-09T09:41:18.352401903Z",
  2029          "initial_balance": "525111",
  2030          "balance": "525111"
  2031        }
  2032      ]
  2033    }
  2034  }
  2035  ```
  2036  
  2037  ### ValidatorUnbondingDelegations
  2038  
  2039  The `ValidatorUnbondingDelegations` REST endpoint queries unbonding delegations of a validator.
  2040  
  2041  ```bash
  2042  /cosmos/staking/v1beta1/validators/{validatorAddr}/unbonding_delegations
  2043  ```
  2044  
  2045  Example:
  2046  
  2047  ```bash
  2048  curl -X GET \
  2049  "http://localhost:1317/cosmos/staking/v1beta1/validators/cosmosvaloper13v4spsah85ps4vtrw07vzea37gq5la5gktlkeu/unbonding_delegations" \
  2050  -H  "accept: application/json"
  2051  ```
  2052  
  2053  Example Output:
  2054  
  2055  ```bash
  2056  {
  2057    "unbonding_responses": [
  2058      {
  2059        "delegator_address": "cosmos1q9snn84jfrd9ge8t46kdcggpe58dua82vnj7uy",
  2060        "validator_address": "cosmosvaloper13v4spsah85ps4vtrw07vzea37gq5la5gktlkeu",
  2061        "entries": [
  2062          {
  2063            "creation_height": "90998",
  2064            "completion_time": "2021-11-05T00:14:37.005841058Z",
  2065            "initial_balance": "24000000",
  2066            "balance": "24000000"
  2067          }
  2068        ]
  2069      },
  2070      {
  2071        "delegator_address": "cosmos1qf36e6wmq9h4twhdvs6pyq9qcaeu7ye0s3dqq2",
  2072        "validator_address": "cosmosvaloper13v4spsah85ps4vtrw07vzea37gq5la5gktlkeu",
  2073        "entries": [
  2074          {
  2075            "creation_height": "47478",
  2076            "completion_time": "2021-11-01T22:47:26.714116854Z",
  2077            "initial_balance": "8000000",
  2078            "balance": "8000000"
  2079          }
  2080        ]
  2081      }
  2082    ],
  2083    "pagination": {
  2084      "next_key": null,
  2085      "total": "2"
  2086    }
  2087  }
  2088  ```