Validators


warning

These docs reflect the Validator Mainnet API. However, it is not yet live. We are currently on Testnet. During the Testnet period, please use the following as the base url for the Testnet API:

https://testnet-api.helium.wtf/v1/

List Validators

GET https://api.helium.io/v1/validators

List known validators as registered on the blockchain.The results are paged. If a cursor field is present in the response, more results are available.

Query Parameters

paramTypeNote
cursor (optional)stringCursor for the page to fetch

Validator for Address

GET https://api.helium.io/v1/validators/:address

Fetch a validator with a given address.

Path Parameters

paramTypeNote
addressstringAddress of validator to fetch

Currently Elected Validators

GET https://api.helium.io/v1/validators/elected

Returns the list of validators that are currently elected to the consensus group.

No Parameters

Elected Validators at a Block

GET https://api.helium.io/v1/validators/elected/:height

Returns the list of validators that were in the consensus group at a given block height

Path Parameters

paramTypeNote
height (required)numberBlockchain Height

Elected Validators in an Election

GET https://api.helium.io/v1/validators/elected/hash/:hash

Returns the list of validators that were elected in the consensus group transcation indicated by the given transaction hash.

Path Parameters

paramTypeNote
hash (required)numberTransaction Hash