Epochs

Get voting epochs

Returns a list of voting epochs.

GEThttps://xtz-index.nownodes.io/v1/voting/epochs

Query parameters

Response

200

Body

application/json

indexinteger (int32)

Index of the voting epoch, starting from zero

firstLevelinteger (int32)

The height of the block in which the epoch starts

startTimestring (date-time)

The timestamp of the block in which the epoch starts

lastLevelinteger (int32)

The height of the block in which the epoch ends

endTimestring (date-time)

The timestamp of the block in which the epoch ends

statusnullable string

Status of the voting epoch: no_proposals - there were no proposals proposed voting - there was at least one proposal and the voting is in progress completed - voting successfully completed and the proposal was accepted failed - voting was not completed due to either quorum or supermajority was not reached

periodsnullable array of VotingPeriod (object)

Voting periods in the epoch

proposalsnullable array of Proposal (object)

Proposals pushed during the voting epoch (null, if there were no proposals).

Request

JavaScriptCurlPython

const response = await fetch('https://xtz-index.nownodes.io/v1/voting/epochs', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "index": 0,
    "firstLevel": 0,
    "startTime": "2024-12-22T02:35:01.938Z",
    "lastLevel": 0,
    "endTime": "2024-12-22T02:35:01.938Z",
    "status": "text",
    "periods": [
      {
        "index": 0,
        "epoch": 0,
        "firstLevel": 0,
        "startTime": "2024-12-22T02:35:01.938Z",
        "lastLevel": 0,
        "endTime": "2024-12-22T02:35:01.938Z",
        "kind": "text",
        "status": "text",
        "dictator": "text",
        "totalBakers": 0,
        "totalVotingPower": 0,
        "upvotesQuorum": 0,
        "proposalsCount": 0,
        "topUpvotes": 0,
        "topVotingPower": 0,
        "ballotsQuorum": 0,
        "supermajority": 0,
        "yayBallots": 0,
        "yayVotingPower": 0,
        "nayBallots": 0,
        "nayVotingPower": 0,
        "passBallots": 0,
        "passVotingPower": 0,
        "totalRolls": 0,
        "topRolls": 0,
        "yayRolls": 0,
        "nayRolls": 0,
        "passRolls": 0
      }
    ],
    "proposals": [
      {
        "hash": "text",
        "initiator": {
          "alias": "text",
          "address": "text"
        },
        "firstPeriod": 0,
        "lastPeriod": 0,
        "epoch": 0,
        "upvotes": 0,
        "votingPower": 0,
        "status": "text",
        "rolls": 0
      }
    ]
  }
]

Get voting epoch by index

Returns a voting epoch at the specified index.

GEThttps://xtz-index.nownodes.io/v1/voting/epochs/{index}

Path parameters

index*integer (int32)

Voting epoch index starting from zero

Response

200

Body

application/json

indexinteger (int32)

Index of the voting epoch, starting from zero

firstLevelinteger (int32)

The height of the block in which the epoch starts

startTimestring (date-time)

The timestamp of the block in which the epoch starts

lastLevelinteger (int32)

The height of the block in which the epoch ends

endTimestring (date-time)

The timestamp of the block in which the epoch ends

statusnullable string

Status of the voting epoch: no_proposals - there were no proposals proposed voting - there was at least one proposal and the voting is in progress completed - voting successfully completed and the proposal was accepted failed - voting was not completed due to either quorum or supermajority was not reached

periodsnullable array of VotingPeriod (object)

Voting periods in the epoch

proposalsnullable array of Proposal (object)

Proposals pushed during the voting epoch (null, if there were no proposals).

Request

JavaScriptCurlPython

const response = await fetch('https://xtz-index.nownodes.io/v1/voting/epochs/{index}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "index": 0,
  "firstLevel": 0,
  "startTime": "2024-12-22T02:35:01.938Z",
  "lastLevel": 0,
  "endTime": "2024-12-22T02:35:01.938Z",
  "status": "text",
  "periods": [
    {
      "index": 0,
      "epoch": 0,
      "firstLevel": 0,
      "startTime": "2024-12-22T02:35:01.938Z",
      "lastLevel": 0,
      "endTime": "2024-12-22T02:35:01.938Z",
      "kind": "text",
      "status": "text",
      "dictator": "text",
      "totalBakers": 0,
      "totalVotingPower": 0,
      "upvotesQuorum": 0,
      "proposalsCount": 0,
      "topUpvotes": 0,
      "topVotingPower": 0,
      "ballotsQuorum": 0,
      "supermajority": 0,
      "yayBallots": 0,
      "yayVotingPower": 0,
      "nayBallots": 0,
      "nayVotingPower": 0,
      "passBallots": 0,
      "passVotingPower": 0,
      "totalRolls": 0,
      "topRolls": 0,
      "yayRolls": 0,
      "nayRolls": 0,
      "passRolls": 0
    }
  ],
  "proposals": [
    {
      "hash": "text",
      "initiator": {
        "alias": "text",
        "address": "text"
      },
      "firstPeriod": 0,
      "lastPeriod": 0,
      "epoch": 0,
      "upvotes": 0,
      "votingPower": 0,
      "status": "text",
      "rolls": 0
    }
  ]
}