/
BA
babylonlabs-io
/
Babylon - gRPC Gateway docs
Search skmtc…
⌘K
Docs
Sign in
Sign in
APIs
Generators
Stacks
Projects
Docs
History
Schema
Sources
Checked 2h ago · Updated 1mo ago
View markdown
latest
Swagger 2.0
2026-07-17
68
122
667.5 KB
93a09c641887
Query
68
get
BtcCheckpointsInfo returns checkpoint info for a range of epochs
get
Parameters queries the parameters of the module.
get
BtcCheckpointInfo returns checkpoint info for a given epoch
get
EpochSubmissions returns all submissions for a given epoch
get
BaseHeader returns the base BTC header of the chain. This header is defined on genesis.
get
Contains checks whether a hash is maintained by the module.
get
ContainsBytes is a temporary method that checks whether a hash is maintained by the module. See discussion at https://github.com/babylonlabs-io/babylon/pull/132 for more details.
get
HeaderDepth returns the depth of the header in main chain or error if the block is not found or it exists on fork
get
Hashes retrieves the hashes maintained by the module.
get
MainChain returns the canonical chain
get
Params queries the parameters of the module.
get
Tip return best header on canonical chain
get
CurrentEpoch queries the current epoch
get
DelegationLifecycle queries the lifecycle of a given delegation
get
EpochsInfo queries the metadata of epochs in a given range, depending on the parameters in the pagination request. Th main use case will be querying the latest epochs in time order.
get
EpochInfo queries the information of a given epoch
get
EpochMsgs queries the messages of a given epoch
get
EpochValSet queries the validator set of a given epoch
get
LatestEpochMsgs queries the messages within a given number of most recent epochs
get
Params queries the parameters of the module.
get
ValidatorLifecycle queries the lifecycle of a given validator
get
BTCDelegation retrieves delegation by corresponding staking tx hash
get
BTCDelegations queries all BTC delegations under a given status
get
FinalityProviders queries all finality providers
get
FinalityProviderDelegations queries all BTC delegations of the given finality provider
get
FinalityProvider info about one finality provider
get
LargestBtcReOrg retrieves the largest BTC reorg
get
Parameters queries the parameters of the module.
get
ParamsByBTCHeight queries the parameters of the module for a specific BTC height
get
ParamsByVersion queries the parameters of the module for a specific version of past params.
get
ParamsVersions queries all the parameters of the module with version.
get
ActivatedHeight queries the height when BTC staking protocol is activated, i.e., the first height when there exists 1 finality provider with voting power
get
ListBlocks is a range query for blocks at a given status
get
Block queries a block at a given height
get
ListEvidences queries is a range query for evidences
get
Evidence queries the first evidence which can be used for extracting the BTC SK
get
FinalityProviderCurrentPower queries the voting power of a finality provider at the current height
get
FinalityProviderPowerAtHeight queries the voting power of a finality provider at a given height
get
ListPubRandCommit is a range query for public randomness commitments of a given finality provider
get
ListPublicRandomness is a range query for public randomness of a given finality provider NOTE: Babylon only has the knowledge of public randomness that is already revealed by finality providers, i.e., the finality provider already provides a finality signature at the corresponding height
get
ActiveFinalityProvidersAtHeight queries finality providers with non zero voting power at given height.
get
Parameters queries the parameters of the module.
get
SigningInfos queries the signing info of all the active finality providers
get
SigningInfo queries the signing info of given finality provider BTC public key
get
VotesAtHeight queries finality providers who have signed the block at given height.
get
VotingPowerDistribution queries the voting power distribution cache Note: The vp dst cache is only kept at the store until that block height is finalized
get
AnnualProvisions returns the current annual provisions.
get
GenesisTime returns the genesis time.
get
InflationRate returns the current inflation rate.
get
ReportedCheckpointBtcHeight returns the BTC light client height at which the checkpoint with the given hash is reported back to Babylon
get
EndedEpochBtcHeight returns the BTC light client height at provided epoch finish
get
BlsPublicKeyList queries a list of bls public keys of the validators at a given epoch number.
get
EpochStatus queries the status of the checkpoint at a given epoch
get
RecentEpochStatusCount queries the number of epochs with each status in recent epochs
get
LastCheckpointWithStatus queries the last checkpoint with a given status or a more matured status
get
RawCheckpoint queries a checkpoints at a given epoch number.
get
RawCheckpoints queries checkpoints for a epoch range specified in pagination params.
get
RawCheckpointList queries all checkpoints that match the given status.
get
RewardGauge queries the reward gauge of a given stakeholder address
get
BTCStakingGauge queries the BTC staking gauge of a given height
get
DelegatorWithdrawAddress queries withdraw address of a delegator.
get
DelegationRewards queries the delegation rewards of given finality provider and delegator addresses
get
FpCurrentRewards queries the finality provider pool of rewards
get
Parameters queries the parameters of the module.
get
CostakerRewardsTracker queries the costaker reward tracker.
get
CurrentRewards queries the current rewards structure for costaking single pool.
get
HistoricalRewards queries the historical rewards structure per period for costaking single pool.
get
Params queries the parameters of the module.
Query
CurrentRewards queries the current rewards structure for costaking single pool.
get
/babylon/costaking/v1/current_rewards
Response
A successful response.