Skip to main content

/nodes

Returns a list of nodes of type observer or validator​

Parameters​

  • from OPTIONAL (number) - Number of items to skip for the result set

  • size OPTIONAL (number) - Number of items to retrieve

  • search OPTIONAL (string) - Search by collection identifier

  • online OPTIONAL (boolean) - Whether node is online or not

  • type OPTIONAL (array[string]) - Filter by type (NonFungibleESDT/SemiFungibleESDT/MetaESDT)

  • status : (string) - Node status

    Available values : new, unknown, waiting, eligible, jailed, queued, leaving, inactive

  • shard : (number) - Node shard

  • issues : (boolean) - Whether node has issues or not

  • identity : (string) - Node identity

  • provider : (string) - Node provider

  • ownerOPTIONAL (string) - Filter by collection owner

  • auctionedOPTIONAL (boolean) - Whether node is auctioned or not

  • fullHistoryOPTIONAL (boolean) - Whether node is of type 'Full History' or not

  • sortOPTIONAL (string) - Sorting criteria

    Available values : name, version, tempRating, leaderSuccess, leaderFailure, validatorSuccess, validatorFailure, validatorIgnoredSignatures, position

  • orderOPTIONAL (string) - Sorting order (asc / desc)

Returns​

  • bls: (string) - bls key
  • name : (string) - The username specific for this account
  • version : (string) - version value
  • rating : (number) - rating value
  • tempRating : (number)
  • ratingModifier : (number)
  • shard : (number) - shard number
  • type : (string) - Enum
  • status : (string) - Enum [new, unknown, waiting, eligible, jailed, queued, leaving, inactive]
  • online :(boolean) - Whether node is online or not
  • nonce: (number) Account current nonce
  • instances : (number)
  • owner : (string) - collection owner
  • identity : (string) -
  • provider : (string)
  • issues : (array[string]) -
  • stake : (number) - stake value
  • topUp : (number) - topUp value
  • locked : (number) - locked amount
  • leaderFailure : (number)
  • leaderSuccess : (number)
  • validatorFailure : (number)
  • validatorIgnoredSignatures : (number)
  • validatorSuccess: (number)
  • position : (number)
  • auctioned : (number)
  • auctionPosition : (number)
  • auctionTopUp : (string)
  • auctionSelected: (boolean)
  • fullHistory : (boolean)

Example​

Request

curl -X 'GET' \
  'https://elrond-api.public.blastapi.io/nodes?online=true&type=observer&issues=false&fullHistory=true&sort=version&order=desc' \
  -H 'accept: application/json'

Result

[
  {
    "bls": "fab289671090272039f172d1721c90ed889d0477cd8cecb23d294c0dd3e1eb61a8faca8e1e7a0a243cac141920ead60ac5f37b5b3e926801af3f2569e78bb50f699747ed2f5e305580347ad37367575b432ed2865fd50c13fa14fdb24c3b3a05",
    "name": "elrond-mainnet-metachain",
    "version": "v1.3.36.0",
    "ratingModifier": 0,
    "shard": 4294967295,
    "type": "observer",
    "online": true,
    "nonce": 10923937,
    "instances": 1,
    "position": 0,
    "fullHistory": true
  },
  {
    "bls": "f76ca581fffc5c5234100c8202730ef97b2031866760d04cff48bdee83a798a103f1490ef050f09338fe2538ebaca5023d58f40b3605c1a70908fbb9c2c5c58dc32656e7eed59496881758472b9dfa8cb36eeccbe1abe4d39d5b68ca63d2b399",
    "name": "isengard-1",
    "version": "v1.3.36.0",
    "ratingModifier": 0,
    "shard": 1,
    "type": "observer",
    "online": true,
    "nonce": 10834947,
    "instances": 1,
    "position": 0,
    "fullHistory": true
  },
  {
    "bls": "f5f34852802b69093211f99352419510e210670015ace083abb1e56e6f5f0469ff7409b09e501cb8b8fddfff621fd20bf95caeaf9326434aeead93d795ea3b78d9929b579c64e4a119828c06e811af8fdf3d5ade546eb056d9daad5ac7477708",
    "name": "Archive_Istari_00",
    "version": "v1.3.36.0",
    "ratingModifier": 0,
    "shard": 0,
    "type": "observer",
    "online": true,
    "nonce": 10939913,
    "instances": 1,
    "identity": "istari_vision",
    "position": 0,
    "fullHistory": true
  },
  {
    "bls": "f08fc59411b3ffcf58cea5b954e67c4808daaef91702745ae0537c154483f7c4b973285d65fda134853c9c518d707314cb41dff98fdb001184f4f7d16be85bac9a4041d95cc62b57131ce76ae34e96e89c4da29aef6b35c98d11ba297a869598",
    "name": "Archive_Istari_02",
    "version": "v1.3.36.0",
    "ratingModifier": 0,
    "shard": 2,
    "type": "observer",
    "online": true,
    "nonce": 10940367,
    "instances": 1,
    "identity": "istari_vision",
    "position": 0,
    "fullHistory": true
  },
  {
    "bls": "e8a65cee3ca52a3a03efb0ee6f667a1077fa28458b6099b0a0088f978f9861e3e98aa530acd03cc44b5320064a702a1990c89aa506a7c46f50a87ec15de6e49b4659c29510fda6a377c687e04b470d90200b04bc8f38e48cbca2de295ec9248c",
    "name": "BWR-Observer-0-shard-1",
    "version": "v1.3.36.0",
    "ratingModifier": 0,
    "shard": 1,
    "type": "observer",
    "online": true,
    "nonce": 10935647,
    "instances": 1,
    "position": 0,
    "fullHistory": true
  },
  {
    "bls": "e8a5456c44328225c3e3bdacc2dcc86b4ce9d84ab8d9c9b91e85668a97af5e805a8a307e743a5194da65d54f1bbe4402ddbaf15a8928b51dd753a51bdfdc406dc1cc2ba0d9aae8d96305fb955fbaa64d6d96a754472ab6cc6044efdba90ce183",
    "name": "full-squad-2-shard-1",
    "version": "v1.3.36.0",
    "ratingModifier": 0,
    "shard": 1,
    "type": "observer",
    "online": true,
    "nonce": 10935646,
    "instances": 1,
    "position": 0,
    "fullHistory": true
  },
  {
    "bls": "e70be31602e3a3119d207bf4329d3e8fc3c436676b94a44be96d017e85cd9949a3886b0b7388a1d6e6df1d7b9faa7d10ecea4cd41e91872586227bec92b6dece1b462eb0135330e6cb8459618407f11609e002ba945147f6d238a2e8396ff899",
    "name": "BWR-Observer-0-shard-1",
    "version": "v1.3.36.0",
    "ratingModifier": 0,
    "shard": 1,
    "type": "observer",
    "online": true,
    "nonce": 10935645,
    "instances": 1,
    "position": 0,
    "fullHistory": true
  }
]