Periods

Get voting periods

get

Returns a list of voting periods.

Query parameters

firstLevelone of | nullableOptional

Filter by level of the first block of the period.

lastLevelone of | nullableOptional

Filter by level of the last block of the period.

selectone of | nullableOptional

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.

sortone of | nullableOptional

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

offsetone of | nullableOptional

Specifies which or how many items should be skipped

limitinteger · int32 · max: 10000Optional

Maximum number of items to return

Default: 100

Responses

application/json

object[]Optional

get

HTTPcURLJavaScriptPython

GET /v1/voting/periods HTTP/1.1
Host: xtz-index.nownodes.io
Accept: */*

200Success

[
  {
    "index": 1,
    "epoch": 1,
    "firstLevel": 1,
    "startTime": "2025-04-23T17:56:42.216Z",
    "lastLevel": 1,
    "endTime": "2025-04-23T17:56:42.216Z",
    "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

get

Returns a voting period at the specified index.

Path parameters

indexinteger · int32Required

Voting period index starting from zero

Responses

application/json

objectOptional

get

HTTPcURLJavaScriptPython

GET /v1/voting/periods/{index} HTTP/1.1
Host: xtz-index.nownodes.io
Accept: */*

200Success

{
  "index": 1,
  "epoch": 1,
  "firstLevel": 1,
  "startTime": "2025-04-23T17:56:42.216Z",
  "lastLevel": 1,
  "endTime": "2025-04-23T17:56:42.216Z",
  "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
}