Get epoch

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

Query Parameters

id uint64

Epoch ID to get, if provided. If omitted, data for the current epoch is returned.

Responses

• 200
• 500
• default

---

A successful response.

application/json

Schema

Example (from schema)

---

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.
amount string
epochSeq string
nodeId string
party string
seq uint64
timestamps object
Timestamps for start/end etc.
endTime int64
expiryTime int64
firstBlock uint64
lastBlock uint64
startTime int64
validators object[]
Validators that participated in this epoch.
avatarUrl string
delegations object[]
Node's delegations.
amount string
epochSeq string
nodeId string
party string
epochData object
Information about epoch.
offline int32
online int32
total int32
ethereumAddress string
id string
infoUrl string
location string
maxIntendedStake string
name string
pendingStake string
pubKey string
rankingScore object
Node ranking information.
performanceScore string
previousStatus Validation status of the node
Possible values: [VALIDATOR_NODE_STATUS_UNSPECIFIED, VALIDATOR_NODE_STATUS_TENDERMINT, VALIDATOR_NODE_STATUS_ERSATZ, VALIDATOR_NODE_STATUS_PENDING]
rankingScore string
stakeScore string
status Validation status of the node
Possible values: [VALIDATOR_NODE_STATUS_UNSPECIFIED, VALIDATOR_NODE_STATUS_TENDERMINT, VALIDATOR_NODE_STATUS_ERSATZ, VALIDATOR_NODE_STATUS_PENDING]
votingPower int64
rewardScore object
Node reward score.
multisigScore string
normalisedScore string
performanceScore string
rawValidatorScore string
validatorScore string
validatorStatus Validation status of the node
Possible values: [VALIDATOR_NODE_STATUS_UNSPECIFIED, VALIDATOR_NODE_STATUS_TENDERMINT, VALIDATOR_NODE_STATUS_ERSATZ, VALIDATOR_NODE_STATUS_PENDING]
stakedByDelegates string
stakedByOperator string
stakedTotal string
status Node status type
Possible values: [NODE_STATUS_UNSPECIFIED, NODE_STATUS_VALIDATOR, NODE_STATUS_NON_VALIDATOR]
tmPubKey string

{
  "epoch": {
    "delegations": [
      {
        "amount": "string",
        "epochSeq": "string",
        "nodeId": "string",
        "party": "string"
      }
    ],
    "seq": "string",
    "timestamps": {
      "endTime": "string",
      "expiryTime": "string",
      "firstBlock": "string",
      "lastBlock": "string",
      "startTime": "string"
    },
    "validators": [
      {
        "avatarUrl": "string",
        "delegations": [
          {
            "amount": "string",
            "epochSeq": "string",
            "nodeId": "string",
            "party": "string"
          }
        ],
        "epochData": {
          "offline": 0,
          "online": 0,
          "total": 0
        },
        "ethereumAddress": "string",
        "id": "string",
        "infoUrl": "string",
        "location": "string",
        "maxIntendedStake": "string",
        "name": "string",
        "pendingStake": "string",
        "pubKey": "string",
        "rankingScore": {
          "performanceScore": "string",
          "previousStatus": "VALIDATOR_NODE_STATUS_UNSPECIFIED",
          "rankingScore": "string",
          "stakeScore": "string",
          "status": "VALIDATOR_NODE_STATUS_UNSPECIFIED",
          "votingPower": 0
        },
        "rewardScore": {
          "multisigScore": "string",
          "normalisedScore": "string",
          "performanceScore": "string",
          "rawValidatorScore": "string",
          "validatorScore": "string",
          "validatorStatus": "VALIDATOR_NODE_STATUS_UNSPECIFIED"
        },
        "stakedByDelegates": "string",
        "stakedByOperator": "string",
        "stakedTotal": "string",
        "status": "NODE_STATUS_UNSPECIFIED",
        "tmPubKey": "string"
      }
    ]
  }
}

An internal server error

application/json

Schema

Example (from schema)

---

Schema

code int32
details object[]
@type string
message string

{
  "code": 0,
  "details": [
    {
      "@type": "string"
    }
  ],
  "message": "string"
}

An unexpected error response.

application/json

Schema

Example (from schema)

---

Schema

code int32
details object[]
@type string
message string

{
  "code": 0,
  "details": [
    {
      "@type": "string"
    }
  ],
  "message": "string"
}

GET /api/v2/epoch

Request

Base URL

https://vega-mainnet-data.commodum.io

id — query

curl / cURL

curl -L -X GET 'https://vega-mainnet-data.commodum.io/api/v2/epoch' \
-H 'Accept: application/json'

python / requests

curl -L -X GET 'https://vega-mainnet-data.commodum.io/api/v2/epoch' \
-H 'Accept: application/json'

go / native

curl -L -X GET 'https://vega-mainnet-data.commodum.io/api/v2/epoch' \
-H 'Accept: application/json'

nodejs / axios

curl -L -X GET 'https://vega-mainnet-data.commodum.io/api/v2/epoch' \
-H 'Accept: application/json'