Get ballots

GET

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

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns a list of ballot operations.

Parameters

delegateobject | nullquery

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

levelobject | nullquery

Filters ballots by level.

timestampobject | nullquery

Filters ballots by timestamp.

epochobject | nullquery

Filters ballots by voting epoch.

periodobject | nullquery

Filters ballots by voting period.

proposalobject | nullquery

Filters ballots by proposal hash.

voteobject | nullquery

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

selectobject | nullquery

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.

sortobject | nullquery

Sorts ballots by specified field. Supported fields: id (default), level.

offsetobject | nullquery

Specifies which or how many items should be skipped

limitinteger<int32>[0, 10000]100query

Maximum number of items to return

quotestringNoneBtcEurUsdCnyJpyKrwEthGbpNonequery

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

Response

200OK

Successful response.

400Bad Request

Invalid request.

Get ballots

curl -X GET 'https://xtz-index.nownodes.io/v1/operations/ballots'

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

const data = await response.json();

require 'net/http'
require 'json'

uri = URI('https://xtz-index.nownodes.io/v1/operations/ballots')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

import requests

response = requests.get('https://xtz-index.nownodes.io/v1/operations/ballots')
data = response.json()

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

const data = await response.json();

const endpoint = "https://xtz-index.nownodes.io/v1/operations/ballots";
const apiKey = "YOUR_API_KEY";

async function nownodesRequest(payload) {
  const response = await fetch(endpoint, {
    method: "GET",
    headers: {
      "Content-Type": "application/json",
      "api-key": apiKey,
    },
    body: JSON.stringify(payload),
  });

  return response.json();
}

const result = await nownodesRequest({});
console.log(result);

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

const data = await response.json();

import requests

response = requests.get('https://xtz-index.nownodes.io/v1/operations/ballots')
data = response.json()

require 'net/http'
require 'json'

uri = URI('https://xtz-index.nownodes.io/v1/operations/ballots')
request = Net::HTTP::Get.new(uri)

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) { |http| http.request(request) }
data = JSON.parse(response.body)

[
  {
    "block": "head",
    "hash": "ooRAfDhmSNiwEdGQi2M5qt27EVtBdh3WD7LX3Rpoet3BTUssKTT",
    "period": {
      "kind": "string"
    },
    "proposal": {
      "hash": "ooRAfDhmSNiwEdGQi2M5qt27EVtBdh3WD7LX3Rpoet3BTUssKTT"
    },
    "delegate": {
      "address": "tz1Ke2h7sDdakHJQh8WX4Z372du1KChsksyU"
    },
    "vote": "string"
  }
]

{
  "error": "Invalid request parameters."
}