Income Table
GET /tables/income?args
List detailed baker income and income statistics. This table is extended for all active bakers at each cycle and updated at every block until a cycle is complete. That way, rows for open cycles will always contain live data up to the most recent block in the chain.
- Schema
- Response
- Example
| Field | Description |
|---|---|
row_id uint64 | Unique row identifier. |
cycle int64 | Cycle this income relates to. |
account_id uint64 | Unique row_id of the baker account this income relates to. |
balance money | A baker's own balance, composed of spendable balance and frozen deposits plus frozen fees (at snapshot block). Note that frozen rewards do not contribute towards rolls, hence they are not part of balance here. |
delegated money | Delegated balance (at snapshot block). |
own_stake money | Amount of baker's own stake, used in Ithaca+. |
staking_balance money | Total stake (baker + staker) plus delegations (baker and delegators). |
n_delegations int64 | Count of non-zero delegations (at snapshot block). |
n_stakers int64 | Number of stakers (at snapshot block). |
n_baking_rights int64 | Count of baking rights in this cycle. |
n_endorsing_rights int64 | Count of endorsing rights in this cycle. |
luck money | Absolute luck in coins, i.e. the amount of extra coins that can be earned because randomization allocated more rights than the fair share of rolls. |
luck_percent float | Relation between actual random rights allocated vs. ideal rights gainable by rolls. Neutral luck is 100%, lower values indicated less rights than fair share, higher values indicate more rights. |
performance_percent float | Effectiveness of a baker in generating expected rewards. Optimal performance is 100%. The value is lower when blocks or endorsements are missed, low value blocks/endorsements are published or the baker is slashed and higher when extra income was generated from stolen blocks or denunciations. NOTE: This value is not ratio scale nor interval scale. CANNOT be used as benchmark between bakers. |
contribution_percent float | Effectiveness of a baker in utilizing all rights assigned and contribute to consensus. Optimal contribution is 100%. The value is lower when blocks or endorsements are missed and higher when blocks are stolen. NOTE: This value is ratio scale. It can be used as benchmark for baker availability or participation in consensus. It is strongly correlated to generated income, but does not capture low priority blocks, endorsements or slashing. |
n_blocks_baked int64 | Number of blocks baked in this cycle. |
n_blocks_proposed int64 | Number of block payloads proposed in this cycle (post-Ithaca payload proposer and block baker can be different). |
n_blocks_not_baked int64 | Number of blocks not baked although rights existed (previously called lost). |
n_blocks_endorsed int64 | Number of blocks endorsed. |
n_blocks_not_endorsed int64 | Number of blocks not endorsed although rights existed (previously called missed). |
n_slots_endorsed int64 | Number of slots endorsed in this cycle. |
n_seeds_revealed int64 | Number of seed nonces revealed in this cycle. |
expected_income money | Total income expected based on endorsing and priority 0 baking rights. |
total_income money | Total sum of all income (note: due to losses, the actual true income may be smaller which is not reflected by this field alone). |
baking_income money | Total income from baking blocks. |
endorsing_income money | Total income from endorsing blocks. |
accusation_income money | Total income from denouncing double baking and endorsing. |
seed_income money | Total income from publishing seed nonces. |
fees_income money | Total income from fees. |
total_loss money | Total lost income due to denunciations or unpublished seed nonces. NOTE: This does not automatically reduce total_income above. |
accusation_loss money | Lost value due to a punishments. |
seed_loss money | Loss due to an unpublished seed nonces. (fees and rewards) |
endorsing_loss money | Lost rewards due too low participation in Ithaca+. |
lost_accusation_fees money | Lost fees due to double signing. |
lost_accusation_rewards money | Lost rewards due to double signing. |
lost_accusation_deposits money | Lost deposits due to double signing. |
lost_seed_fees money | Lost fees due to unpublished seed nonces (only applicable pre-Ithaca). |
lost_seed_rewards money | Lost rewards due to unpublished seed nonces (pre-Ithaca this is single block rewards, post-Ithaca an unpublished seed nonce leads to loss of the entire endorsing rewards for a cycle). |
address hash | Account address base58check encoded. |
start_time datetime | Income cycle start time. |
end_time datetime | Income cycle end time. |
[
[
355548, // row_id
699, // cycle
43215, // account_id
5889134.404710, // balance
37338619.598737, // delegated
4413249.392354, // own_stake
43227754.003447, // staking_balance
5511, // n_delegations
0, // n_stakers
1043, // n_baking_rights
7303911, // n_endorsing_rights
664.812034, // luck
103.29, // luck_percent
93.11, // performance_percent
46.23, // contribution_percent
975, // n_blocks_baked
975, // n_blocks_proposed
0, // n_blocks_not_baked
15262, // n_blocks_endorsed
0, // n_blocks_not_endorsed
6802796, // n_slots_endorsed
0, // n_seeds_revealed
20859.690360, // expected_income
9641.781717, // total_income
9613.089423, // baking_income
0.000000, // endorsing_income
0.000000, // accusation_income
0.000000, // seed_income
28.692294, // fees_income
0.000000, // total_loss
0.000000, // accusation_loss
0.000000, // seed_loss
0.000000, // endorsing_loss
0.000000, // lost_accusation_fees
0.000000, // lost_accusation_rewards
0.000000, // lost_accusation_deposits
0.000000, // lost_seed_fees
0.000000, // lost_seed_rewards
"tz1VQnqCCqX4K5sP3FNkVSNKTdCAMJDd3E1n" // address
]
]
curl "https://api.tzpro.io/tables/income?address=tz2TSvNTh2epDMhZHrw73nV9piBX7kLZ9K9m&cycle=150"