Proposals

Get proposals

Returns a list of proposal operations.

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

Query parameters

Response

200

Body

application/json

type*string

typenullable string

Type of the operation, proposal - is used by bakers (delegates) to submit and/or upvote proposals to amend the protocol

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 proposal period for which the proposal was submitted (upvoted)

PeriodInfo (object)

proposalnullable one of

Information about the submitted (upvoted) proposal

ProposalAlias (object)

delegatenullable one of

Information about the baker (delegate), submitted (upvoted) the proposal operation

Alias (object)

votingPowerinteger (int64)

Baker's voting power

duplicatedboolean

Indicates whether proposal upvote has already been pushed. Duplicated proposal operations are not counted when selecting proposal-winner.

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/proposals', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "type": "text",
    "id": 0,
    "level": 0,
    "timestamp": "2024-12-22T01:42:38.002Z",
    "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,
    "duplicated": false,
    "quote": {
      "btc": 0,
      "eur": 0,
      "usd": 0,
      "cny": 0,
      "jpy": 0,
      "krw": 0,
      "eth": 0,
      "gbp": 0
    },
    "rolls": 0
  }
]

Get proposal by hash

Returns a proposal operation with specified hash.

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

Path parameters

hash*string

Operation hash

Query parameters

Response

200

Body

application/json

type*string

typenullable string

Type of the operation, proposal - is used by bakers (delegates) to submit and/or upvote proposals to amend the protocol

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 proposal period for which the proposal was submitted (upvoted)

PeriodInfo (object)

proposalnullable one of

Information about the submitted (upvoted) proposal

ProposalAlias (object)

delegatenullable one of

Information about the baker (delegate), submitted (upvoted) the proposal operation

Alias (object)

votingPowerinteger (int64)

Baker's voting power

duplicatedboolean

Indicates whether proposal upvote has already been pushed. Duplicated proposal operations are not counted when selecting proposal-winner.

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/proposals/{hash}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

[
  {
    "type": "text",
    "id": 0,
    "level": 0,
    "timestamp": "2024-12-22T01:42:38.002Z",
    "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,
    "duplicated": false,
    "quote": {
      "btc": 0,
      "eur": 0,
      "usd": 0,
      "cny": 0,
      "jpy": 0,
      "krw": 0,
      "eth": 0,
      "gbp": 0
    },
    "rolls": 0
  }
]