Proposals

Get proposals

get

Returns a list of protocol proposals.

Query parameters

hashone of | nullableOptional

Filters proposals by hash

epochone of | nullableOptional

Filters proposals by voting epoch

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

offsetone of | nullableOptional

Specifies which or how many items should be skipped

limitinteger · int32 · max: 10000Optional

Maximum number of items to return

Default: 100

Responses

200Success

application/json

get

HTTPcURLJavaScriptPython

GET /v1/voting/proposals HTTP/1.1
Host: xtz-index.nownodes.io
Accept: */*

200Success

[
  {
    "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 proposal by hash

get

Returns the most recent protocol proposal with the specified hash.

Path parameters

hashstringRequired

Proposal hash

Responses

200Success

application/json

get

HTTPcURLJavaScriptPython

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

200Success

{
  "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
}