Distribution

CommunityPool queries the community pool coins.

get
Authorizations
Responses
200
A successful response.
application/json
get
GET /cosmos/distribution/v1beta1/community_pool HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "pool": [
    {
      "denom": "text",
      "amount": "text"
    }
  ]
}

DelegationTotalRewards queries the total rewards accrued by each validator.

get
Authorizations
Path parameters
delegator_addressstringRequired

delegator_address defines the delegator address to query for.

Responses
200
A successful response.
application/json
get
GET /cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "rewards": [
    {
      "validator_address": "text",
      "reward": [
        {
          "denom": "text",
          "amount": "text"
        }
      ]
    }
  ],
  "total": [
    {
      "denom": "text",
      "amount": "text"
    }
  ]
}

DelegationRewards queries the total rewards accrued by a delegation.

get
Authorizations
Path parameters
delegator_addressstringRequired

delegator_address defines the delegator address to query for.

validator_addressstringRequired

validator_address defines the validator address to query for.

Responses
200
A successful response.
application/json
get
GET /cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards/{validator_address} HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "rewards": [
    {
      "denom": "text",
      "amount": "text"
    }
  ]
}

DelegatorValidators queries the validators of a delegator.

get
Authorizations
Path parameters
delegator_addressstringRequired

delegator_address defines the delegator address to query for.

Responses
200
A successful response.
application/json
get
GET /cosmos/distribution/v1beta1/delegators/{delegator_address}/validators HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "validators": [
    "text"
  ]
}

DelegatorWithdrawAddress queries withdraw address of a delegator.

get
Authorizations
Path parameters
delegator_addressstringRequired

delegator_address defines the delegator address to query for.

Responses
200
A successful response.
application/json
get
GET /cosmos/distribution/v1beta1/delegators/{delegator_address}/withdraw_address HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "withdraw_address": "text"
}

Params queries params of the distribution module.

get
Authorizations
Responses
200
A successful response.
application/json
get
GET /cosmos/distribution/v1beta1/params HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "params": {
    "community_tax": "text",
    "base_proposer_reward": "text",
    "bonus_proposer_reward": "text",
    "withdraw_addr_enabled": true
  }
}

ValidatorDistributionInfo queries validator commission and self-delegation rewards for validator

get
Authorizations
Path parameters
validator_addressstringRequired

validator_address defines the validator address to query for.

Responses
200
A successful response.
application/json
get
GET /cosmos/distribution/v1beta1/validators/{validator_address} HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "operator_address": "text",
  "self_bond_rewards": [
    {
      "denom": "text",
      "amount": "text"
    }
  ],
  "commission": [
    {
      "denom": "text",
      "amount": "text"
    }
  ]
}

ValidatorCommission queries accumulated commission for a validator.

get
Authorizations
Path parameters
validator_addressstringRequired

validator_address defines the validator address to query for.

Responses
200
A successful response.
application/json
get
GET /cosmos/distribution/v1beta1/validators/{validator_address}/commission HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "commission": {
    "commission": [
      {
        "denom": "text",
        "amount": "text"
      }
    ]
  }
}

ValidatorOutstandingRewards queries rewards of a validator address.

get
Authorizations
Path parameters
validator_addressstringRequired

validator_address defines the validator address to query for.

Responses
200
A successful response.
application/json
get
GET /cosmos/distribution/v1beta1/validators/{validator_address}/outstanding_rewards HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "rewards": {
    "rewards": [
      {
        "denom": "text",
        "amount": "text"
      }
    ]
  }
}

ValidatorSlashes queries slash events of a validator.

get
Authorizations
Path parameters
validator_addressstringRequired

validator_address defines the validator address to query for.

Query parameters
starting_heightstring · uint64Optional

starting_height defines the optional starting height to query the slashes.

ending_heightstring · uint64Optional

starting_height defines the optional ending height to query the slashes.

pagination.keystring · byteOptional

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/distribution/v1beta1/validators/{validator_address}/slashes HTTP/1.1
Host: lunc.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "slashes": [
    {
      "validator_period": "text",
      "fraction": "text"
    }
  ],
  "pagination": {
    "next_key": "Ynl0ZXM=",
    "total": "text"
  }
}
PreviousBaseNextEvidence