Returns a validator registered at the consensus layer.

get/consensus/validators/{address}

Path parameters

addressstring required

An Oasis-style (bech32) address.

Example:oasis1qpg2xuz46g53737343r20yxeddhlvc2ldqsjh70p

The address of the entity to return.

Response

A JSON object containing a validator registered at the consensus layer.

total_countinteger required

The total number of records that match the query, i.e. the number of records the query would return with limit=infinity.

is_total_count_clippedboolean required

Whether total_count is clipped for performance reasons.

Example response

{
  "total_count": 412,
  "is_total_count_clipped": true,
  "validators": [
    {
      "entity_address": "oasis1qpg2xuz46g53737343r20yxeddhlvc2ldqsjh70p",
      "entity_id": "gb8SHLeDc69Elk7OTfqhtVgE2sqxrBCDQI84xKR+Bjg=",
      "node_id": "lbxs4hlud9XNloIOdhJPaCahd7HtiY8QATCgGnFfCM0=",
      "escrow": {
        "active_balance": "1234567890123456789012",
        "active_shares": "1234567890123456789012",
        "debonding_balance": "1234567890123456789012",
        "debonding_shares": "1234567890123456789012",
        "self_delegation_balance": "1234567890123456789012",
        "self_delegation_shares": "1234567890123456789012",
        "active_balance_24": "1234567890123456789012"
      },
      "start_date": "2022-10-15T00:05:34Z",
      "media": {
        "name": "WhaleStake"
      },
      "signed_blocks": [
        {
          "height": 8048956
        }
      ]
    }
  ],
  "stats": {
    "total_staked_balance": "1234567890123456789012"
  }
}

Changes

Changed in 3 of the 3 revisions of this API.111

    • added the optional property allOf[subschema #2]/validators/items/allOf[Validator]/signed_blocks to the response with the 200 status

      response-optional-property-added

    • the allOf[subschema #2]/validators/items/allOf[Validator]/start_date response's property type/format changed from string/date-time to string/ for status 200

      response-property-type-changed

    • removed the optional property allOf[subschema #2]/validators/items/allOf[Validator]/signed_blocks from the response with the 200 status

      response-optional-property-removed

    This revision also has 5 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog