KiiChain
  • Learn
    • What is KiiChain?
    • KiiChain
      • Vision of KiiChain
      • The Problems We Solve
      • Use Cases
      • Roadmap
      • Whitepaper
      • Business Model
    • Tokenomics
      • Intro Coin Details
      • Coin Unlocking Schedule
      • Utility
      • Evergreen Model
    • Getting Started
      • Get a Wallet
      • Download a Mobile Wallet
      • Set Up a Web Wallet
      • Connect Wallet to Explorer App
  • BUILD ON KIICHAIN
    • Developer Hub
    • Testnet Oro
    • Endpoints - Cosmos
      • EVM
        • VM
        • ERC20
        • FeeMarket
      • IBC
      • Kiichain
        • TokenFactory
      • Cosmwasm
      • Cosmos
        • Auth
        • Authz
        • Bank
        • Tendermint
        • Consensus
        • Distribution
        • Evidence
        • Feegrant
        • Gov
        • Slashing
        • Staking
        • Tx
        • Upgrade
    • Developer Tools
      • RWA Protocol
      • Rust SDK
      • JS/TS SDK
        • Kiijs-evm
        • Kiijs-proto
      • Deploy a smart contract
      • Deploy a dApp
      • Testnet faucet
    • Smart Contracts
    • Modules
      • TokenFactory
      • EVM
  • Validate the Network
    • Getting Started
      • What is a delegator?
      • What is a validator?
    • Run a Validator / Full Node
      • Getting started
      • Step-by-Step Guide
        • Becoming a Validator
        • Recovering Legacy Addresses
      • Maintaining a validator
      • Incentive
      • Technical requirements
      • Validator Security
    • Economics
      • Staking Requirements
      • Delegation / Staking
      • Rewards
      • Block Rewards Formula
      • APR
    • Delegator Information
      • Choosing a validator
      • Directives of delegators
      • Incentive to stake
      • Security considerations
      • Risks to consider
  • KII AMBASSADORS
    • What does it mean to be a KiiAmbassador?
    • Your Core Responsibilities
    • Participation Perks
    • Points System & Performance
    • How to lose the Role
    • Evaluation Process
  • KIIEX
    • Set Up KIIEX Account
      • Contact OTC Desk
    • Connect to KIIEX APIs
      • Introduction
        • New endpoints
        • Revised calls
        • Behavior Changes
        • Revised Calls 3.5.0
      • Background Information
        • Message Frame
        • Standard Response Objects and Common Error Codes
        • Modules
        • Users, Accounts, and Permissions
        • Products and Instruments
        • Quotes and Orders
        • Timeโ€“ and Date-Stamp Formats
        • The Trading Day
      • Users
        • Activate2FA
        • AddUserAffiliateTag
        • Authenticate2FA
        • AuthenticateUser
        • CancelUserReport
        • GetAllUnredactedUserConfigsForUser
        • GetL2Snapshot
        • GetLevel1
        • GetUnredactedUserConfigByKey
        • GetUserAccountInfos
        • GetUserAccounts
        • GetUserAffiliateCount
        • GetUserAfilliateTag
        • GetUserConfig
        • GetUserDevices
        • GetUserReportTickets
        • GetUserReportWriterResultRecords
        • GetValidate2FARequiredEndpoints
        • LogOut
        • RegisterNewDevice
        • SubscribeAccountEvents
        • SubscribeBlockTrades
        • SuscribeLevel1
        • SubscribeLevel2
        • SubscribeTicker
        • SubscribeTrades
        • UnsuscribeBlockTrades
        • UnsubscribeLevel1
        • UnsubscribeLevel2
        • UnsubscribeTicket
        • UnsuscribeTrades
        • UpdateUserAffiliateTag
        • Validate2FA
      • Accounts
        • GetAccountInfo
        • GenerateTransactionActivityReport
        • GenerateTradeActivityReport
        • GenerateTreasuryActivityReport
        • GetAllAccountConfigs
        • GetAccountPositions
        • GetTreasuryProductsForAccount
        • ScheduleTradeActivityReport
      • Trades
        • GetAccountTrades
        • GetAccountTransactions
        • GetAllOpenTradeReports
        • GetOpenTradeReports
        • GetTickerHistory
        • GetTradesHistory
      • OMS Orders
        • CancelAllOrders
        • CancelOrder
        • CancelQuote
        • CancelReplaceOrder
        • CreateQuote
        • GetOMSFeeTiers
        • GetOpenOrders
        • GetOpenQuotes
        • GetOrderFee
        • GetOrderHistory
        • GetOrderHistoryByOrderId
        • GetOrdersHistory
        • GetOrderStatus
        • ModifyOrder
        • SendOrder
        • SubmitBlockTrade
        • UpdateQuote
      • Products
        • GetProduct
        • GetProducts
      • Instruments
        • GetInstrument
        • GetInstruments
      • Tickets
        • CreateDepositTicket
        • CancelWithdraw
        • CreateWithdrawTicket
        • Deposit withdraw template
        • GetAccountDepositTransactions
        • GetAccountWithdrawTransactions
        • GetAllDepositRequestInfoTemplates
        • GetDeposits
        • GetDepositInfo
        • GetDepositTicket
        • GetDepositRequestInfoTemplate
        • GetOMSWithdrawFees
        • GetStandardTemplateExample
        • GetTetherRPCWithdrawTemplateExample
        • GetWithdrawFee
        • GetWithdraws
        • GetWithdrawTemplate
        • GetWithdrawTemplateTypes
        • GetWithdrawTicket
        • GetWithdrawTickets
        • SubmitDepositTicketComment
        • SubmitWithdrawTicketComment
      • Misc
        • Ping
Powered by GitBook
LogoLogo
On this page
Export as PDF
  1. BUILD ON KIICHAIN
  2. Endpoints - Cosmos
  3. Cosmos

Distribution

PreviousConsensusNextEvidence

Last updated 23 days ago

Params queries params of the distribution module.

get
Responses
200
A successful response.
application/json
default
An unexpected error response.
application/json
get
GET /cosmos/distribution/v1beta1/params HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*
{
  "params": {
    "community_tax": "text",
    "base_proposer_reward": "text",
    "bonus_proposer_reward": "text",
    "withdraw_addr_enabled": true
  }
}

DelegatorValidators queries the validators of a delegator.

get
Path parameters
delegator_addressanyRequired

delegator_address defines the delegator address to query for.

Responses
200
A successful response.
application/json
default
An unexpected error response.
application/json
get
GET /cosmos/distribution/v1beta1/delegators/{delegator_address}/validators HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*
{
  "validators": [
    "text"
  ]
}

ValidatorDistributionInfo queries validator commission and self-delegation rewards for validator

get
Path parameters
validator_addressanyRequired

validator_address defines the validator address to query for.

Responses
200
A successful response.
application/json
default
An unexpected error response.
application/json
get
GET /cosmos/distribution/v1beta1/validators/{validator_address} HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*
{
  "operator_address": "text",
  "self_bond_rewards": [
    {
      "denom": "text",
      "amount": "text"
    }
  ],
  "commission": [
    {
      "denom": "text",
      "amount": "text"
    }
  ]
}

CommunityPool queries the community pool coins.

get
Responses
200
A successful response.
application/json
default
An unexpected error response.
application/json
get
GET /cosmos/distribution/v1beta1/community_pool HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*
{
  "pool": [
    {
      "denom": "text",
      "amount": "text"
    }
  ]
}

DelegationTotalRewards queries the total rewards accrued by each validator.

get
Path parameters
delegator_addressanyRequired

delegator_address defines the delegator address to query for.

Responses
200
A successful response.
application/json
default
An unexpected error response.
application/json
get
GET /cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
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
Path parameters
delegator_addressanyRequired

delegator_address defines the delegator address to query for.

validator_addressanyRequired

validator_address defines the validator address to query for.

Responses
200
A successful response.
application/json
default
An unexpected error response.
application/json
get
GET /cosmos/distribution/v1beta1/delegators/{delegator_address}/rewards/{validator_address} HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*
{
  "rewards": [
    {
      "denom": "text",
      "amount": "text"
    }
  ]
}

DelegatorWithdrawAddress queries withdraw address of a delegator.

get
Path parameters
delegator_addressanyRequired

delegator_address defines the delegator address to query for.

Responses
200
A successful response.
application/json
default
An unexpected error response.
application/json
get
GET /cosmos/distribution/v1beta1/delegators/{delegator_address}/withdraw_address HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*
{
  "withdraw_address": "text"
}

ValidatorCommission queries accumulated commission for a validator.

get
Path parameters
validator_addressanyRequired

validator_address defines the validator address to query for.

Responses
200
A successful response.
application/json
default
An unexpected error response.
application/json
get
GET /cosmos/distribution/v1beta1/validators/{validator_address}/commission HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*
{
  "commission": {
    "commission": [
      {
        "denom": "text",
        "amount": "text"
      }
    ]
  }
}

ValidatorOutstandingRewards queries rewards of a validator address.

get
Path parameters
validator_addressanyRequired

validator_address defines the validator address to query for.

Responses
200
A successful response.
application/json
default
An unexpected error response.
application/json
get
GET /cosmos/distribution/v1beta1/validators/{validator_address}/outstanding_rewards HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*
{
  "rewards": {
    "rewards": [
      {
        "denom": "text",
        "amount": "text"
      }
    ]
  }
}

ValidatorSlashes queries slash events of a validator.

get
Path parameters
validator_addressanyRequired

validator_address defines the validator address to query for.

Query parameters
starting_heightanyOptional

starting_height defines the optional starting height to query the slashes.

ending_heightanyOptional

starting_height defines the optional ending height to query the slashes.

pagination.keyanyOptional

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.offsetanyOptional

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.limitanyOptional

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_totalanyOptional

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.reverseanyOptional

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
default
An unexpected error response.
application/json
get
GET /cosmos/distribution/v1beta1/validators/{validator_address}/slashes HTTP/1.1
Host: lcd.uno.sentry.testnet.v3.kiivalidator.com
Accept: */*
{
  "slashes": [
    {
      "validator_period": "text",
      "fraction": "text"
    }
  ],
  "pagination": {
    "next_key": "Ynl0ZXM=",
    "total": "text"
  }
}
  • GETParams queries params of the distribution module.
  • GETDelegatorValidators queries the validators of a delegator.
  • GETValidatorDistributionInfo queries validator commission and self-delegation rewards for validator
  • GETCommunityPool queries the community pool coins.
  • GETDelegationTotalRewards queries the total rewards accrued by each validator.
  • GETDelegationRewards queries the total rewards accrued by a delegation.
  • GETDelegatorWithdrawAddress queries withdraw address of a delegator.
  • GETValidatorCommission queries accumulated commission for a validator.
  • GETValidatorOutstandingRewards queries rewards of a validator address.
  • GETValidatorSlashes queries slash events of a validator.