List nodes
Get a list of the nodes on the network along with the related information.
Query Parameters
epochSeq uint64
Return the node list for the given epoch. If not set, the node list for the current epoch will be returned.
pagination.first int32
Number of records to be returned that sort greater than row identified by cursor supplied in 'after'.
pagination.after string
If paging forwards, the cursor string for the last row of the previous page.
pagination.last int32
Number of records to be returned that sort less than row identified by cursor supplied in 'before'.
pagination.before string
If paging forwards, the cursor string for the first row of the previous page.
pagination.newestFirst boolean
Whether to order the results with the newest records first. If not set, the default value is true.
Responses
- 200
- 500
- default
A successful response.
application/json
Schema
Example (from schema)
Schema
nodes object
{
"nodes": {
"edges": [
{
"cursor": "string",
"node": {
"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"
}
}
],
"pageInfo": {
"endCursor": "string",
"hasNextPage": true,
"hasPreviousPage": true,
"startCursor": "string"
}
}
}
An internal server error
application/json
Schema
Example (from schema)
Schema
code int32
details object[]
message string
{
"code": 0,
"details": [
{
"@type": "string"
}
],
"message": "string"
}
An unexpected error response.
application/json
Schema
Example (from schema)
Schema
code int32
details object[]
message string
{
"code": 0,
"details": [
{
"@type": "string"
}
],
"message": "string"
}
GET /api/v2/nodes
Request
Request
curl / cURL
curl -L -X GET 'https://vega-mainnet-data.commodum.io/api/v2/nodes' \
-H 'Accept: application/json'
python / requests
curl -L -X GET 'https://vega-mainnet-data.commodum.io/api/v2/nodes' \
-H 'Accept: application/json'
go / native
curl -L -X GET 'https://vega-mainnet-data.commodum.io/api/v2/nodes' \
-H 'Accept: application/json'
nodejs / axios
curl -L -X GET 'https://vega-mainnet-data.commodum.io/api/v2/nodes' \
-H 'Accept: application/json'