Skip to main content
Version: release (v0.77)

Get epoch

GET 

/api/v2/epoch

Get data for a specific epoch, if ID is omitted, it retrieves the current epoch

Request

Query Parameters

    id uint64

    Epoch ID. If provided, returns the epoch with the given ID.

    block uint64

    Block height. If provided, returns the epoch that the given block is in.

Responses

A successful response.

Schema
    epoch object

    Data specific to a single epoch on the Vega network. This includes the epoch number, start and end times, and the nodes that participated in the epoch.

    delegations object[]

    List of all delegations in epoch.

  • Array [
  • amount string

    Amount delegated. This field is an unsigned integer scaled to the asset's decimal places.

    epochSeq string

    Epoch of delegation.

    nodeId string

    Node ID to delegate to.

    party string

    Party which is delegating.

  • ]
  • seq uint64

    Sequence is used as epoch ID.

    timestamps object

    Timestamps for start/end etc.

    endTime int64

    Timestamp in Unix nanoseconds for when the epoch ended, empty if not ended.

    expiryTime int64

    Timestamp in Unix nanoseconds for the epoch's expiry.

    firstBlock uint64

    Height of first block in the epoch.

    lastBlock uint64

    Height of last block in the epoch, empty if not ended.

    startTime int64

    Timestamp in Unix nanoseconds for when epoch started.

    validators object[]

    Validators that participated in this epoch.

  • Array [
  • avatarUrl string

    Avatar url.

    delegations object[]

    Node's delegations.

  • Array [
  • amount string

    Amount delegated. This field is an unsigned integer scaled to the asset's decimal places.

    epochSeq string

    Epoch of delegation.

    nodeId string

    Node ID to delegate to.

    party string

    Party which is delegating.

  • ]
  • epochData object

    Information about epoch.

    offline int32

    Total number of offline epochs since node was created.

    online int32

    Total number of online epochs since node was created.

    total int32

    Total number of epochs since node was created.

    ethereumAddress string

    Ethereum public key of the node.

    id string

    Node ID i.e. the node's wallet ID.

    infoUrl string

    URL where users can find out more information on the node.

    location string

    Country code for the location of the node.

    maxIntendedStake string

    Max amount of (wanted) stake. This field is an unsigned integer scaled to the asset's decimal places.

    name string

    Node name.

    pendingStake string

    Amount of stake on the next epoch. This field is an unsigned integer scaled to the asset's decimal places.

    pubKey string

    Public key of the node operator.

    rankingScore object

    Node ranking information.

    performanceScore string

    Performance based score.

    previousStatus Validation status of the node (string)

    Possible values: [VALIDATOR_NODE_STATUS_UNSPECIFIED, VALIDATOR_NODE_STATUS_TENDERMINT, VALIDATOR_NODE_STATUS_ERSATZ, VALIDATOR_NODE_STATUS_PENDING]

    Default value: VALIDATOR_NODE_STATUS_UNSPECIFIED

    Status of the validator in the previous epoch.

    rankingScore string

    Final score.

    stakeScore string

    Stake based score - no anti-whaling.

    status Validation status of the node (string)

    Possible values: [VALIDATOR_NODE_STATUS_UNSPECIFIED, VALIDATOR_NODE_STATUS_TENDERMINT, VALIDATOR_NODE_STATUS_ERSATZ, VALIDATOR_NODE_STATUS_PENDING]

    Default value: VALIDATOR_NODE_STATUS_UNSPECIFIED

    Status of the validator in the current epoch.

    votingPower int64

    Tendermint voting power of the validator.

    rewardScore object

    Node reward score.

    multisigScore string

    Multisig score.

    normalisedScore string

    Normalised validator score for rewards.

    performanceScore string

    Performance based score.

    rawValidatorScore string

    Stake based score - with anti-whaling.

    validatorScore string

    Un-normalised score.

    validatorStatus Validation status of the node (string)

    Possible values: [VALIDATOR_NODE_STATUS_UNSPECIFIED, VALIDATOR_NODE_STATUS_TENDERMINT, VALIDATOR_NODE_STATUS_ERSATZ, VALIDATOR_NODE_STATUS_PENDING]

    Default value: VALIDATOR_NODE_STATUS_UNSPECIFIED

    Status of the validator for reward.

    stakedByDelegates string

    Amount of stake that has been delegated by token holders. This field is an unsigned integer scaled to the asset's decimal places.

    stakedByOperator string

    Amount the node operator has put up themselves. This field is an unsigned integer scaled to the asset's decimal places.

    stakedTotal string

    Total amount staked on node. This field is an unsigned integer scaled to the asset's decimal places.

    status Node status type (string)

    Possible values: [NODE_STATUS_UNSPECIFIED, NODE_STATUS_VALIDATOR, NODE_STATUS_NON_VALIDATOR]

    Default value: NODE_STATUS_UNSPECIFIED

    Node status.

    tmPubKey string

    Public key of Tendermint.

  • ]
Loading...