Skip to main content
Version: 0.9.1

Bakers

GET /explorer/bakers

Get a list of all active bakers, their current status and affiliation metadata. Optionally filter by status and country or get a random list of suggestions for a given account. This endpoint represents a simple to use listing feature for wallets and other dapps that want to enable delegation.

Filter the baker list by the following criteria

ArgumentDescription
status enumFilter by baker status public, private, closing, closed.
country enumFilter by baker country of operation (use ISO 3166-1 Alpha-2 country codes, that's two uppercase letters like US, DE, FR)
suggest addressReturn a suggested list of bakers for the given address (see below)
cursor intLast baker id after which to continue listing, use for paging.
limit intMax number of results to return (max 100).
offset intSkip first N results, use for paging instead of cursor.

List Baker Votes​

GET /explorer/bakers/{address}/votes

Lists all voting proposals and ballots operations the baker has sent.

List Baker Endorsements​

GET /explorer/bakers/{address}/endorsements

Lists all endorsement operations the baker has sent.

List Baker Delegations​

GET /explorer/bakers/{address}/delegations

Lists all delegation operations where this baker was set or removed as the baker of choice for a delegator.

Get Baker Cycle Income​

GET /explorer/bakers/{address}/income/{cycle}
{
    "cycle": 699,
    "own_balance": 5889134.40471,
    "delegated_balance": 37338619.598737,
    "staking_balance": 43227754.003447,
    "own_stake": 4413249.392354,
    "n_delegations": 5511,
    "n_stakers": 0,
    "n_baking_rights": 1043,
    "n_endorsing_rights": 7303911,
    "luck": 664.812034,
    "luck_percent": 10329,
    "contribution_percent": 9207,
    "performance_percent": 4575,
    "n_blocks_baked": 965,
    "n_blocks_proposed": 965,
    "n_blocks_not_baked": 0,
    "n_blocks_endorsed": 15091,
    "n_blocks_not_endorsed": 0,
    "n_slots_endorsed": 6726185,
    "n_seeds_revealed": 0,
    "expected_income": 20859.69036,
    "total_income": 9541.717872,
    "baking_income": 9513.466115,
    "endorsing_income": 0,
    "accusation_income": 0,
    "seed_income": 0,
    "fees_income": 28.251757,
    "total_loss": 0,
    "accusation_loss": 0,
    "seed_loss": 0,
    "endorsing_loss": 0,
    "lost_accusation_fees": 0,
    "lost_accusation_rewards": 0,
    "lost_accusation_deposits": 0,
    "lost_seed_fees": 0,
    "lost_seed_rewards": 0
}

Get income statistics for this baker at the specific cycle. Past cycles are final. Future cycles are available as soon as a shapshot was selected.

Get Baker Cycle Rights​

GET /explorer/bakers/{address}/rights/{cycle}

Get rights for this baker at the specific cycle. Rights are represented as lists of binary flags.

{
  "address": "tz1aRoaRhSpRYvFdyvgWLL6TGyRoGF51wDjM",
  "cycle": 400,
  "start_height": 1687553,
  "baking_rights": "0000...0000",
  "endorsing_rights": "ffff...ffff",
  "blocks_baked": "00000...0000",
  "blocks_endorsed": "fc1f...feef",
  "seeds_required": "04000000020010040400102400000100",
  "seeds_revealed": "04000000020010040400102400000100"
}

Get Baker Cycle Snapshot​

GET /explorer/bakers/{address}/snapshot/{cycle}

Get snapshot for this baker at the specific cycle. A snapshot contains info about staking status at the cycle's snapshot block as well as a list of delegators with their balances at that block. In combination with cycle income, this info can be used to prepare baker payouts.

{
    "baking_cycle": 699,
    "snapshot_height": 4912128,
    "snapshot_cycle": 693,
    "snapshot_time": "2024-01-12T14:16:49Z",
    "snapshot_index": 4,
    "staking_balance": 43227754003447,
    "own_balance": 5889134404710,
    "own_stake": 4413249392354,
    "delegated_balance": 37338619598737,
    "n_delegations": 5511,
    "n_stakers": 0,
    "expected_income": 20859690360,
    "total_income": 9541717872,
    "baking_income": 9513466115,
    "endorsing_income": 0,
    "accusation_income": 0,
    "seed_income": 0,
    "fees_income": 28251757,
    "total_loss": 0,
    "accusation_loss": 0,
    "seed_loss": 0,
    "endorsing_loss": 0,
    "lost_accusation_fees": 0,
    "lost_accusation_rewards": 0,
    "lost_accusation_deposits": 0,
    "lost_seed_fees": 0,
    "lost_seed_rewards": 0,
    "delegators": [{
        "address": "tz1cgrzpsB43pBppH6mJzrHnFqxU8RUce991",
        "balance": 5000000569919,
        "is_funded": true
    },
    // ...
    ],
    "stakers": [
       // ...
    ]
}