Ballots

Get ballots

get

Returns a list of ballot operations.

Query parameters

delegateone of | nullableOptional

Filters ballots by delegate. Allowed fields for .eqx mode: none.

levelone of | nullableOptional

Filters ballots by level.

timestampone of | nullableOptional

Filters ballots by timestamp.

epochone of | nullableOptional

Filters ballots by voting epoch.

periodone of | nullableOptional

Filters ballots by voting period.

proposalone of | nullableOptional

Filters ballots by proposal hash.

voteone of | nullableOptional

Filters ballots by vote (yay, nay, pass).

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 ballots by specified field. Supported fields: id (default), level.

offsetone of | nullableOptional

Specifies which or how many items should be skipped

limitinteger · int32 · max: 10000Optional

Maximum number of items to return

Default: 100

quoteone ofOptional

Comma-separated list of ticker symbols to inject historical prices into response

Default: None

Responses

application/json

all of[]Optional

get

HTTPcURLJavaScriptPython

GET /v1/operations/ballots HTTP/1.1
Host: xtz-index.nownodes.io
Accept: */*

200Success

[
  {
    "type": "text",
    "id": 1,
    "level": 1,
    "timestamp": "2025-04-23T18:11:49.794Z",
    "block": "text",
    "hash": "text",
    "period": {
      "index": 1,
      "epoch": 1,
      "kind": "text",
      "firstLevel": 1,
      "lastLevel": 1
    },
    "proposal": {
      "alias": "text",
      "hash": "text"
    },
    "delegate": {
      "alias": "text",
      "address": "text"
    },
    "votingPower": 1,
    "vote": "text",
    "quote": {
      "btc": 1,
      "eur": 1,
      "usd": 1,
      "cny": 1,
      "jpy": 1,
      "krw": 1,
      "eth": 1,
      "gbp": 1
    },
    "rolls": 1
  }
]

Get ballot by hash

get

Returns a ballot operation with specified hash.

Path parameters

hashstringRequired

Operation hash

Query parameters

quoteone ofOptional

Comma-separated list of ticker symbols to inject historical prices into response

Default: None

Responses

application/json

all of[]Optional

get

HTTPcURLJavaScriptPython

GET /v1/operations/ballots/{hash} HTTP/1.1
Host: xtz-index.nownodes.io
Accept: */*

200Success

[
  {
    "type": "text",
    "id": 1,
    "level": 1,
    "timestamp": "2025-04-23T18:11:49.794Z",
    "block": "text",
    "hash": "text",
    "period": {
      "index": 1,
      "epoch": 1,
      "kind": "text",
      "firstLevel": 1,
      "lastLevel": 1
    },
    "proposal": {
      "alias": "text",
      "hash": "text"
    },
    "delegate": {
      "alias": "text",
      "address": "text"
    },
    "votingPower": 1,
    "vote": "text",
    "quote": {
      "btc": 1,
      "eur": 1,
      "usd": 1,
      "cny": 1,
      "jpy": 1,
      "krw": 1,
      "eth": 1,
      "gbp": 1
    },
    "rolls": 1
  }
]