Delegates

Get delegates

get

Returns a list of delegate accounts.

Query parameters

activeone of | nullableOptional

Delegate status to filter by (true - only active, false - only deactivated, undefined - all delegates)

lastActivityone of | nullableOptional

Filters delegates by last activity level (where the delegate was updated)

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 delegators by specified field. Supported fields: id (default), activationLevel, deactivationLevel, stakingBalance, balance, numDelegators.

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

application/json

all of[]Optional

get

HTTPcURLJavaScriptPython

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

200Success

[
  {
    "type": "text",
    "id": 1,
    "address": "text",
    "active": true,
    "alias": "text",
    "publicKey": "text",
    "revealed": true,
    "balance": 1,
    "rollupBonds": 1,
    "smartRollupBonds": 1,
    "stakedBalance": 1,
    "stakedPseudotokens": 1,
    "unstakedBalance": 1,
    "unstakedBaker": {
      "alias": "text",
      "address": "text"
    },
    "externalStakedBalance": 1,
    "externalUnstakedBalance": 1,
    "totalStakedBalance": 1,
    "issuedPseudotokens": 1,
    "stakersCount": 1,
    "lostBalance": 1,
    "frozenDepositLimit": 1,
    "limitOfStakingOverBaking": 1,
    "edgeOfBakingOverStaking": 1,
    "counter": 1,
    "activationLevel": 1,
    "activationTime": "2025-04-23T17:55:40.691Z",
    "deactivationLevel": 1,
    "deactivationTime": "2025-04-23T17:55:40.691Z",
    "stakingBalance": 1,
    "delegatedBalance": 1,
    "numContracts": 1,
    "rollupsCount": 1,
    "smartRollupsCount": 1,
    "activeTokensCount": 1,
    "tokenBalancesCount": 1,
    "tokenTransfersCount": 1,
    "activeTicketsCount": 1,
    "ticketBalancesCount": 1,
    "ticketTransfersCount": 1,
    "numDelegators": 1,
    "numBlocks": 1,
    "numEndorsements": 1,
    "numPreendorsements": 1,
    "numBallots": 1,
    "numProposals": 1,
    "numActivations": 1,
    "numDoubleBaking": 1,
    "numDoubleEndorsing": 1,
    "numDoublePreendorsing": 1,
    "numNonceRevelations": 1,
    "vdfRevelationsCount": 1,
    "numRevelationPenalties": 1,
    "numEndorsingRewards": 1,
    "numDelegations": 1,
    "numOriginations": 1,
    "numTransactions": 1,
    "numReveals": 1,
    "numRegisterConstants": 1,
    "numSetDepositsLimits": 1,
    "numMigrations": 1,
    "txRollupOriginationCount": 1,
    "txRollupSubmitBatchCount": 1,
    "txRollupCommitCount": 1,
    "txRollupReturnBondCount": 1,
    "txRollupFinalizeCommitmentCount": 1,
    "txRollupRemoveCommitmentCount": 1,
    "txRollupRejectionCount": 1,
    "txRollupDispatchTicketsCount": 1,
    "transferTicketCount": 1,
    "increasePaidStorageCount": 1,
    "updateConsensusKeyCount": 1,
    "drainDelegateCount": 1,
    "smartRollupAddMessagesCount": 1,
    "smartRollupCementCount": 1,
    "smartRollupExecuteCount": 1,
    "smartRollupOriginateCount": 1,
    "smartRollupPublishCount": 1,
    "smartRollupRecoverBondCount": 1,
    "smartRollupRefuteCount": 1,
    "refutationGamesCount": 1,
    "activeRefutationGamesCount": 1,
    "stakingOpsCount": 1,
    "autostakingOpsCount": 1,
    "firstActivity": 1,
    "firstActivityTime": "2025-04-23T17:55:40.691Z",
    "lastActivity": 1,
    "lastActivityTime": "2025-04-23T17:55:40.691Z",
    "extras": null,
    "software": {
      "version": "text",
      "date": "2025-04-23T17:55:40.691Z"
    },
    "frozenDeposit": 1,
    "frozenDeposits": 1,
    "frozenRewards": 1,
    "frozenFees": 1,
    "metadata": null
  }
]

Get delegate by address

get

Returns a delegate with the specified address.

Path parameters

addressstringRequired

Delegate address (starting with tz)

Responses

application/json

all ofOptional

get

HTTPcURLJavaScriptPython

GET /v1/delegates/{address} HTTP/1.1
Host: xtz-index.nownodes.io
Accept: */*

200Success

{
  "type": "text",
  "id": 1,
  "address": "text",
  "active": true,
  "alias": "text",
  "publicKey": "text",
  "revealed": true,
  "balance": 1,
  "rollupBonds": 1,
  "smartRollupBonds": 1,
  "stakedBalance": 1,
  "stakedPseudotokens": 1,
  "unstakedBalance": 1,
  "unstakedBaker": {
    "alias": "text",
    "address": "text"
  },
  "externalStakedBalance": 1,
  "externalUnstakedBalance": 1,
  "totalStakedBalance": 1,
  "issuedPseudotokens": 1,
  "stakersCount": 1,
  "lostBalance": 1,
  "frozenDepositLimit": 1,
  "limitOfStakingOverBaking": 1,
  "edgeOfBakingOverStaking": 1,
  "counter": 1,
  "activationLevel": 1,
  "activationTime": "2025-04-23T17:55:40.691Z",
  "deactivationLevel": 1,
  "deactivationTime": "2025-04-23T17:55:40.691Z",
  "stakingBalance": 1,
  "delegatedBalance": 1,
  "numContracts": 1,
  "rollupsCount": 1,
  "smartRollupsCount": 1,
  "activeTokensCount": 1,
  "tokenBalancesCount": 1,
  "tokenTransfersCount": 1,
  "activeTicketsCount": 1,
  "ticketBalancesCount": 1,
  "ticketTransfersCount": 1,
  "numDelegators": 1,
  "numBlocks": 1,
  "numEndorsements": 1,
  "numPreendorsements": 1,
  "numBallots": 1,
  "numProposals": 1,
  "numActivations": 1,
  "numDoubleBaking": 1,
  "numDoubleEndorsing": 1,
  "numDoublePreendorsing": 1,
  "numNonceRevelations": 1,
  "vdfRevelationsCount": 1,
  "numRevelationPenalties": 1,
  "numEndorsingRewards": 1,
  "numDelegations": 1,
  "numOriginations": 1,
  "numTransactions": 1,
  "numReveals": 1,
  "numRegisterConstants": 1,
  "numSetDepositsLimits": 1,
  "numMigrations": 1,
  "txRollupOriginationCount": 1,
  "txRollupSubmitBatchCount": 1,
  "txRollupCommitCount": 1,
  "txRollupReturnBondCount": 1,
  "txRollupFinalizeCommitmentCount": 1,
  "txRollupRemoveCommitmentCount": 1,
  "txRollupRejectionCount": 1,
  "txRollupDispatchTicketsCount": 1,
  "transferTicketCount": 1,
  "increasePaidStorageCount": 1,
  "updateConsensusKeyCount": 1,
  "drainDelegateCount": 1,
  "smartRollupAddMessagesCount": 1,
  "smartRollupCementCount": 1,
  "smartRollupExecuteCount": 1,
  "smartRollupOriginateCount": 1,
  "smartRollupPublishCount": 1,
  "smartRollupRecoverBondCount": 1,
  "smartRollupRefuteCount": 1,
  "refutationGamesCount": 1,
  "activeRefutationGamesCount": 1,
  "stakingOpsCount": 1,
  "autostakingOpsCount": 1,
  "firstActivity": 1,
  "firstActivityTime": "2025-04-23T17:55:40.691Z",
  "lastActivity": 1,
  "lastActivityTime": "2025-04-23T17:55:40.691Z",
  "extras": null,
  "software": {
    "version": "text",
    "date": "2025-04-23T17:55:40.691Z"
  },
  "frozenDeposit": 1,
  "frozenDeposits": 1,
  "frozenRewards": 1,
  "frozenFees": 1,
  "metadata": null
}