Sign in

v1

latestOpenAPI 3.0.32026-07-173986194.3 KB

Returns historical information for a single validator.

get/consensus/validators/{address}/history

Path parameters

addressstring required

An Oasis-style (bech32) address.

Example:oasis1qpg2xuz46g53737343r20yxeddhlvc2ldqsjh70p

The address of the entity to return.

Query parameters

limitinteger

The maximum numbers of items to return.

offsetinteger

The number of items to skip before starting to collect the result set.

frominteger

A filter on minimum epoch number, inclusive.

tointeger

A filter on maximum epoch number, inclusive.

Response

A JSON object containing historical information for a validator, grouped by epoch in reverse chronological order.

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.

addressstring

The staking address of the validator.

Example response

{
  "total_count": 412,
  "is_total_count_clipped": true,
  "address": "oasis1qpg2xuz46g53737343r20yxeddhlvc2ldqsjh70p",
  "history": [
    {
      "epoch": 13402,
      "active_balance": "1234567890123456789012",
      "active_shares": "1234567890123456789012",
      "debonding_balance": "1234567890123456789012",
      "debonding_shares": "1234567890123456789012"
    }
  ]
}