Cycles

GET /explorer/cycle/{head|number}

Provides information about a consensus cycle, the past roll snapshot cycle and the future cycle whose rights are determined by the current cycle. This endpoint accepts head and a cycle number as path parameters.

Schema

Field	Description
cycle int64	The cycle number.
start_height int64	First block height (level) in this cycle.
end_height int64	Last block height (level) in this cycle.
start_time datetime	Start time (estimate for future cycles).
end_time datetime	End time (estimate for open and future cycles).
progress float	Cycle completion in percent.
is_complete bool	Flag indicating the cycle is complete.
is_snapshot bool	Flag indicating a roll snapshot has been selected.
is_active bool	Flag indicating the cycle is currently active.
snapshot_height int64	Height of the snapshot block.
snapshot_index int64	Index of the snapshot block.
snapshot_time datetime	Time the snapshot block was taken.
eligible_bakers int64	Number of unique bakers at selected snapshot block (or most recent snapshot block) with at least minimal stake.
active_bakers int64	Number of actively registered bakers.
active_stakers int64	Number of actively staking accounts excluding bakers.
active_delegators int64	Number of non-zero accounts delegating to active bakers.
staking_supply money	Total staked supply at selected snapshot block or most recent snapshot block.
staking_percent float	Percent of total supply staked at selected snapshot block or most recent snapshot block.
unique_bakers int64	Number of bakers seen during this cycle. Its expected for this number to be lower than active_bakers because some bakers may have no rights or futer rights only and others may be offline.
missed_rounds int64	Total count of missed block rounds (old protocols called this priorities).
missed_endorsements int64	Total count of missed endorsement slots.
n_double_baking int64	Count of double_baking_evidence events.
n_double_endorsement int64	Count of double_endorsement_evidence events.
solvetime_min int64	Minimum time between blocks.
solvetime_max int64	Maximum time between blocks.
solvetime_mean float	Mean time between blocks.
round_min int64	Minimum block round (priority).
round_max int64	Maximum block round (priority).
round_mean float	Mean block round (priority).
endorsement_rate float	Percentage of seen endorsements vs expected endorsements.
endorsements_min int64	Minimum count of endorsements across all blocks.
endorsements_max int64	Maximum count of endorsements across all blocks.
endorsements_mean float	Mean count of endorsements across all blocks.
seed_rate int64	Percentage of published vs expected seed_nonce_revelations.
worst_baked_block int64	Height of the block with lowest priority.
worst_endorsed_block int64	Height of the block with least endorsed slots.
block_reward int64	Current issuance this cycle.
block_bonus_per_slot int64	Current issuance this cycle.
max_block_reward int64	Current issuance this cycle.
endorsement_reward_per_slot int64	Current issuance this cycle.
nonce_revelation_reward int64	Current issuance this cycle.
vdf_revelation_reward int64	Current issuance this cycle.
lb_subsidy int64	Current issuance this cycle.
snapshot_cycle object	Embedded cycle data for the cycle that provided the roll snapshot for the current cycle.
follower_cycle object	Embedded cycle data for the future cycle that will get its rights assigned from a snapshot in the current cycle.

Response

{
  "cycle": 247,
  "start_height": 1011713,
  "end_height": 1015808,
  "start_time": "2020-06-25T03:36:14Z",
  "end_time": "2020-06-27T23:54:04Z",
  "progress": 13.2568359375,
  "is_complete": false,
  "is_snapshot": false,
  "is_active": true,
  "snapshot_height": -1,
  "snapshot_index": -1,
  "snapshot_time": "0001-01-01T00:00:00Z",
  "eligible_bakers": 423,
  "active_delegators": 54434,
  "active_stakers": 0,
  "active_bakers": 447,
  "staking_supply": 674670196.013393,
  "staking_percent": 80.2706912175752,
  "unique_bakers": 117,
  "missed_rounds": 4,
  "missed_endorsements": 115,
  "n_double_baking": 0,
  "n_double_endorsement": 0,
  "solvetime_min": 60,
  "solvetime_max": 100,
  "solvetime_mean": 60.327808471454915,
  "round_min": 0,
  "round_max": 1,
  "round_mean": 0.007366482504604053,
  "endorsement_rate": 99.33694649446494,
  "endorsements_min": 25,
  "endorsements_max": 32,
  "endorsements_mean": 31.78782287822878,
  "seed_rate": 100,
  "worst_baked_block": 1011950,
  "worst_endorsed_block": 1011819,
  "max_block_reward": 40000000,
  "block_bonus_per_slot": 0,
  "block_reward": 40000000,
  "endorsement_reward_per_slot": 1250000,
  "nonce_revelation_reward": 125000,
  "vdf_revelation_reward": 0,
  "lb_subsidy": 0,
  "snapshot_cycle": {
    // ... same data as cycle
  },
  "follower_cycle": {
    // ... same data as cycle
  }
}

Example

curl https://api.tzpro.io/explorer/cycle/head