Ballots

Get ballots

Returns a list of ballot operations.

GEThttps://xtz-index.nownodes.io/v1/operations/ballots

Query parameters

Response

200

Body

application/json

type*string

typenullable string

Type of the operation, ballot - is used to vote for a proposal in a given voting cycle

idinteger (int64)

Unique ID of the operation, stored in the TzKT indexer database

levelinteger (int32)

The height of the block from the genesis block, in which the operation was included

timestampstring (date-time)

Datetime of the block, in which the operation was included (ISO 8601, e.g. 2020-02-20T02:40:57Z)

blocknullable string

Hash of the block, in which the operation was included

hashnullable string

Hash of the operation

periodnullable one of

Information about the voting period for which the ballot was submitted

PeriodInfo (object)

proposalnullable one of

Information about the proposal for which ballot was submitted

ProposalAlias (object)

delegatenullable one of

Information about the delegate (baker), submitted the ballot

Alias (object)

votingPowerinteger (int64)

Baker's voting power

votenullable string

Vote, given in the ballot (yay, nay, or pass)

quotenullable one of

Injected historical quote at the time of operation

QuoteShort (object)

rollsinteger (int32)

[DEPRECATED]

Request

JavaScriptCurlPython

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

Response

200

[
  {
    "type": "text",
    "id": 0,
    "level": 0,
    "timestamp": "2024-12-31T01:32:30.349Z",
    "block": "text",
    "hash": "text",
    "period": {
      "index": 0,
      "epoch": 0,
      "kind": "text",
      "firstLevel": 0,
      "lastLevel": 0
    },
    "proposal": {
      "alias": "text",
      "hash": "text"
    },
    "delegate": {
      "alias": "text",
      "address": "text"
    },
    "votingPower": 0,
    "vote": "text",
    "quote": {
      "btc": 0,
      "eur": 0,
      "usd": 0,
      "cny": 0,
      "jpy": 0,
      "krw": 0,
      "eth": 0,
      "gbp": 0
    },
    "rolls": 0
  }
]

Get ballot by hash

Returns a ballot operation with specified hash.

GEThttps://xtz-index.nownodes.io/v1/operations/ballots/{hash}

Path parameters

hash*string

Operation hash

Query parameters

Response

200

Body

application/json

type*string

typenullable string

Type of the operation, ballot - is used to vote for a proposal in a given voting cycle

idinteger (int64)

Unique ID of the operation, stored in the TzKT indexer database

levelinteger (int32)

The height of the block from the genesis block, in which the operation was included

timestampstring (date-time)

Datetime of the block, in which the operation was included (ISO 8601, e.g. 2020-02-20T02:40:57Z)

blocknullable string

Hash of the block, in which the operation was included

hashnullable string

Hash of the operation

periodnullable one of

Information about the voting period for which the ballot was submitted

PeriodInfo (object)

proposalnullable one of

Information about the proposal for which ballot was submitted

ProposalAlias (object)

delegatenullable one of

Information about the delegate (baker), submitted the ballot

Alias (object)

votingPowerinteger (int64)

Baker's voting power

votenullable string

Vote, given in the ballot (yay, nay, or pass)

quotenullable one of

Injected historical quote at the time of operation

QuoteShort (object)

rollsinteger (int32)

[DEPRECATED]

Request

JavaScriptCurlPython

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

Response

200

[
  {
    "type": "text",
    "id": 0,
    "level": 0,
    "timestamp": "2024-12-31T01:32:30.349Z",
    "block": "text",
    "hash": "text",
    "period": {
      "index": 0,
      "epoch": 0,
      "kind": "text",
      "firstLevel": 0,
      "lastLevel": 0
    },
    "proposal": {
      "alias": "text",
      "hash": "text"
    },
    "delegate": {
      "alias": "text",
      "address": "text"
    },
    "votingPower": 0,
    "vote": "text",
    "quote": {
      "btc": 0,
      "eur": 0,
      "usd": 0,
      "cny": 0,
      "jpy": 0,
      "krw": 0,
      "eth": 0,
      "gbp": 0
    },
    "rolls": 0
  }
]