Epochs

PreviousVoters NextCurrent

Get voting epochs

Returns a list of voting epochs.

get

/v1/voting/epochs

Query parameters

sortnullable one of

Sorts voting epochs 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/epochs'

200

[
  {
    "index": 1,
    "firstLevel": 1,
    "startTime": "2025-02-06T10:29:32.620Z",
    "lastLevel": 1,
    "endTime": "2025-02-06T10:29:32.620Z",
    "status": "text",
    "periods": [
      {
        "index": 1,
        "epoch": 1,
        "firstLevel": 1,
        "startTime": "2025-02-06T10:29:32.620Z",
        "lastLevel": 1,
        "endTime": "2025-02-06T10:29:32.620Z",
        "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
      }
    ],
    "proposals": [
      {
        "hash": "text",
        "initiator": {
          "alias": "text",
          "address": "text"
        },
        "firstPeriod": 1,
        "lastPeriod": 1,
        "epoch": 1,
        "upvotes": 1,
        "votingPower": 1,
        "status": "text",
        "extras": null,
        "rolls": 1,
        "metadata": null
      }
    ]
  }
]

Get voting epoch by index

Returns a voting epoch at the specified index.

get

/v1/voting/epochs/{index}

Path parameters

indexinteger int32required

Voting epoch index starting from zero