Election Table

GET https://api.tzpro.io/tables/election?args
List full details about past and current elections. Elections represent metadata about each consecutive run of related voting periods. Elections may contain 4, 2 or 1 vote periods. They are called empty when only one empty proposal vote without a proposal exists.

HTTP Response

Field
Description
row_id uint64
Unique row identifier.
proposal_id uint64
Unique row_id of the winning proposal, if any.
num_periods int64
Election duration in number of voting periods.
num_proposals int64
Total number of submitted proposals.
voting_perid int64
On-chain voting period number.
start_time datetime
Block time of election start block.
end_time datetime
Block time of election end block.
start_height int64
Block height of election start block.
end_height int64
Block height of election end block.
is_empty bool
Flag indicating no proposal was submitted.
is_open bool
Flag indicating the election is in progress.
is_failed bool
Flag indicating the election has failed to select or activate a new protocol.
no_quorum bool
Flag indicating the election has failed because no quorum could be reached.
no_majority bool
Flag indicating the election has failed because no majority could be reached.
proposal hash
Hash of the proposal that is voted on, if any.
last_voting_period enum
Type of the last period at which this election ended proposal, exploration, cooldown, promotion, adoption.

Example Request

curl "https://api.tzpro.io/tables/election?proposal=PsBABY5HQTSkA4297zNHfsZNKtxULfL18y95qb3m53QJiXGmrbU"

Example Response (comments added for explanation)

[
[
13, // row_id
5, // proposal_id
4, // num_periods
2, // num_proposals
15, // voting_perid
1563303754000, // start_time
0, // end_time
524288, // start_height
0, // end_height
0, // is_empty
1, // is_open
0, // is_failed
0, // no_quorum
0, // no_majority
"PsBABY5HQTSkA4297zNHfsZNKtxULfL18y95qb3m53QJiXGmrbU", // proposal
"promotion_vote" // last_voting_period
]
]