Protocols

Get protocols

get

Returns a list of protocols.

Query parameters
sortone of | nullableOptional

Sorts protocols by specified field. Supported fields: code (default), firstLevel, lastLevel.

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
GET /v1/protocols HTTP/1.1
Host: xtz-index.nownodes.io
Accept: */*
200Success
[
  {
    "code": 1,
    "hash": "text",
    "firstLevel": 1,
    "firstCycle": 1,
    "firstCycleLevel": 1,
    "lastLevel": 1,
    "constants": {
      "rampUpCycles": 1,
      "noRewardCycles": 1,
      "preservedCycles": 1,
      "blocksPerCycle": 1,
      "blocksPerCommitment": 1,
      "blocksPerSnapshot": 1,
      "blocksPerVoting": 1,
      "timeBetweenBlocks": 1,
      "endorsersPerBlock": 1,
      "hardOperationGasLimit": 1,
      "hardOperationStorageLimit": 1,
      "hardBlockGasLimit": 1,
      "minimalStake": 1,
      "minimalFrozenStake": 1,
      "blockDeposit": 1,
      "blockReward": [
        1
      ],
      "endorsementDeposit": 1,
      "endorsementReward": [
        1
      ],
      "originationSize": 1,
      "byteCost": 1,
      "proposalQuorum": 1,
      "ballotQuorumMin": 1,
      "ballotQuorumMax": 1,
      "lbToggleThreshold": 1,
      "consensusThreshold": 1,
      "minParticipationNumerator": 1,
      "minParticipationDenominator": 1,
      "maxSlashingPeriod": 1,
      "maxDelegatedOverFrozenRatio": 1,
      "maxExternalOverOwnStakeRatio": 1,
      "smartRollupOriginationSize": 1,
      "smartRollupStakeAmount": 1,
      "smartRollupChallengeWindow": 1,
      "smartRollupCommitmentPeriod": 1,
      "smartRollupTimeoutPeriod": 1,
      "dictator": "text",
      "lbEscapeThreshold": 1,
      "lbSunsetLevel": 1,
      "frozenDepositsPercentage": 1,
      "txRollupOriginationSize": 1,
      "txRollupCommitmentBond": 1,
      "doubleBakingPunishment": 1,
      "doubleEndorsingPunishmentNumerator": 1,
      "doubleEndorsingPunishmentDenominator": 1,
      "revelationReward": 1,
      "lbSubsidy": 1,
      "tokensPerRoll": 1
    },
    "extras": null,
    "metadata": null
  }
]

Get protocol by code

get

Returns a protocol with the specified proto code.

Path parameters
codeinteger · int32Required

Protocol code (e.g. 4 for Athens, 5 for Babylon, etc)

Responses
200Success
application/json
get
GET /v1/protocols/{code} HTTP/1.1
Host: xtz-index.nownodes.io
Accept: */*
200Success
{
  "code": 1,
  "hash": "text",
  "firstLevel": 1,
  "firstCycle": 1,
  "firstCycleLevel": 1,
  "lastLevel": 1,
  "constants": {
    "rampUpCycles": 1,
    "noRewardCycles": 1,
    "preservedCycles": 1,
    "blocksPerCycle": 1,
    "blocksPerCommitment": 1,
    "blocksPerSnapshot": 1,
    "blocksPerVoting": 1,
    "timeBetweenBlocks": 1,
    "endorsersPerBlock": 1,
    "hardOperationGasLimit": 1,
    "hardOperationStorageLimit": 1,
    "hardBlockGasLimit": 1,
    "minimalStake": 1,
    "minimalFrozenStake": 1,
    "blockDeposit": 1,
    "blockReward": [
      1
    ],
    "endorsementDeposit": 1,
    "endorsementReward": [
      1
    ],
    "originationSize": 1,
    "byteCost": 1,
    "proposalQuorum": 1,
    "ballotQuorumMin": 1,
    "ballotQuorumMax": 1,
    "lbToggleThreshold": 1,
    "consensusThreshold": 1,
    "minParticipationNumerator": 1,
    "minParticipationDenominator": 1,
    "maxSlashingPeriod": 1,
    "maxDelegatedOverFrozenRatio": 1,
    "maxExternalOverOwnStakeRatio": 1,
    "smartRollupOriginationSize": 1,
    "smartRollupStakeAmount": 1,
    "smartRollupChallengeWindow": 1,
    "smartRollupCommitmentPeriod": 1,
    "smartRollupTimeoutPeriod": 1,
    "dictator": "text",
    "lbEscapeThreshold": 1,
    "lbSunsetLevel": 1,
    "frozenDepositsPercentage": 1,
    "txRollupOriginationSize": 1,
    "txRollupCommitmentBond": 1,
    "doubleBakingPunishment": 1,
    "doubleEndorsingPunishmentNumerator": 1,
    "doubleEndorsingPunishmentDenominator": 1,
    "revelationReward": 1,
    "lbSubsidy": 1,
    "tokensPerRoll": 1
  },
  "extras": null,
  "metadata": null
}

Get protocol by hash

get

Returns a protocol with the specified hash.

Path parameters
hashstringRequired

Protocol hash

Responses
200Success
application/json
get
GET /v1/protocols/{hash} HTTP/1.1
Host: xtz-index.nownodes.io
Accept: */*
200Success
{
  "code": 1,
  "hash": "text",
  "firstLevel": 1,
  "firstCycle": 1,
  "firstCycleLevel": 1,
  "lastLevel": 1,
  "constants": {
    "rampUpCycles": 1,
    "noRewardCycles": 1,
    "preservedCycles": 1,
    "blocksPerCycle": 1,
    "blocksPerCommitment": 1,
    "blocksPerSnapshot": 1,
    "blocksPerVoting": 1,
    "timeBetweenBlocks": 1,
    "endorsersPerBlock": 1,
    "hardOperationGasLimit": 1,
    "hardOperationStorageLimit": 1,
    "hardBlockGasLimit": 1,
    "minimalStake": 1,
    "minimalFrozenStake": 1,
    "blockDeposit": 1,
    "blockReward": [
      1
    ],
    "endorsementDeposit": 1,
    "endorsementReward": [
      1
    ],
    "originationSize": 1,
    "byteCost": 1,
    "proposalQuorum": 1,
    "ballotQuorumMin": 1,
    "ballotQuorumMax": 1,
    "lbToggleThreshold": 1,
    "consensusThreshold": 1,
    "minParticipationNumerator": 1,
    "minParticipationDenominator": 1,
    "maxSlashingPeriod": 1,
    "maxDelegatedOverFrozenRatio": 1,
    "maxExternalOverOwnStakeRatio": 1,
    "smartRollupOriginationSize": 1,
    "smartRollupStakeAmount": 1,
    "smartRollupChallengeWindow": 1,
    "smartRollupCommitmentPeriod": 1,
    "smartRollupTimeoutPeriod": 1,
    "dictator": "text",
    "lbEscapeThreshold": 1,
    "lbSunsetLevel": 1,
    "frozenDepositsPercentage": 1,
    "txRollupOriginationSize": 1,
    "txRollupCommitmentBond": 1,
    "doubleBakingPunishment": 1,
    "doubleEndorsingPunishmentNumerator": 1,
    "doubleEndorsingPunishmentDenominator": 1,
    "revelationReward": 1,
    "lbSubsidy": 1,
    "tokensPerRoll": 1
  },
  "extras": null,
  "metadata": null
}