Periods

PreviousCount NextCurrent

Get voting periods

Returns a list of voting periods.

get

/v1/voting/periods

Query parameters

firstLevelnullable one of

Filter by level of the first block of the period.

lastLevelnullable one of

Filter by level of the last block of the period.

selectnullable one of

Specify comma-separated list of fields to include into response or leave it undefined to return full object. If you select single field, response will be an array of values in both .fields and .values modes.

sortnullable one of

Sorts voting periods by specified field. Supported fields: id (default).

offsetnullable one of

Specifies which or how many items should be skipped

limitinteger int32

Maximum number of items to return

Responses

application/json

cURL

JavaScript

Python

HTTP

curl -L \
  --url 'https://xtz-index.nownodes.io/v1/voting/periods'

200

[
  {
    "index": 1,
    "epoch": 1,
    "firstLevel": 1,
    "startTime": "2025-02-06T13:03:05.702Z",
    "lastLevel": 1,
    "endTime": "2025-02-06T13:03:05.702Z",
    "kind": "text",
    "status": "text",
    "dictator": "text",
    "totalBakers": 1,
    "totalVotingPower": 1,
    "upvotesQuorum": 1,
    "proposalsCount": 1,
    "topUpvotes": 1,
    "topVotingPower": 1,
    "ballotsQuorum": 1,
    "supermajority": 1,
    "yayBallots": 1,
    "yayVotingPower": 1,
    "nayBallots": 1,
    "nayVotingPower": 1,
    "passBallots": 1,
    "passVotingPower": 1,
    "totalRolls": 1,
    "topRolls": 1,
    "yayRolls": 1,
    "nayRolls": 1,
    "passRolls": 1
  }
]

Get voting period by index

Returns a voting period at the specified index.

get

/v1/voting/periods/{index}

Path parameters

indexinteger int32required

Voting period index starting from zero