List auto-renewed validator cycles
Lists the settled staking cycles of an auto-renewed (ACP-236) validator, newest first. Each cycle reports the weight bonded for that cycle and the gross / withdrawn / compounded split of its rewards.
Includes cycles that paid nothing out. A fully-compounding cycle mints no reward UTXO and so does not appear in reward history at all.
The in-flight cycle is not listed; it is on the validator object. Returns an empty list for a node with no auto-renewed validation.
cycleIndex is 1-based per position, so a node that has held more than one auto-renewed position has more than one cycle 1. Group by stakingTxHash, or pass txHash for a single series.
Api keys provide higher access to rate limits. To obtain an api key, sign up for an account at https://build.avax.network/console/utilities/data-api-keys.
In: header
Path Parameters
Either mainnet or testnet/fuji.
"mainnet" | "fuji" | "testnet"A primary network (P or X chain) nodeId.
Query Parameters
Restrict results to a single auto-renewed position, given its AddAutoRenewedValidatorTx hash. Only needed for a node that has held more than one auto-renewed validation, where cycleIndex restarts at 1 per position.
A page token, received from a previous list call. Provide this to retrieve the subsequent page.
The maximum number of items to return. The minimum page size is 1. The maximum pageSize is 100.
101 <= value <= 100The order by which to sort results. Use "asc" for ascending order, "desc" for descending order. Sorted by timestamp or the sortBy query parameter, if provided.
"asc" | "desc"Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://data-api.avax.network/v1/networks/mainnet/validators/NodeID-111111111111111111116DBWJs/cycles?pageSize=10&sortOrder=asc"{
"nextPageToken": "string",
"cycles": [
{
"cycleIndex": 0,
"rewardTxHash": "string",
"stakingTxHash": "string",
"startTimestamp": 0,
"endTimestamp": 0,
"weightAtCycleStart": "string",
"grossValidationReward": "string",
"withdrawnValidationReward": "string",
"compoundedValidationReward": "string",
"grossDelegateeReward": "string",
"withdrawnDelegateeReward": "string",
"compoundedDelegateeReward": "string",
"autoCompoundSharePercent": 0,
"outcome": "renewed",
"delegatorCount": 0,
"amountDelegated": "string"
}
],
"currentCycle": {
"cycleIndex": 0,
"stakingTxHash": "string",
"startTimestamp": 0,
"endTimestamp": 0,
"weightAtCycleStart": "string",
"projectedValidationReward": "string",
"accruedDelegateeReward": "string",
"autoCompoundSharePercent": 0,
"state": "renewing",
"delegatorCount": 0,
"amountDelegated": "string"
}
}{
"message": "string",
"statusCode": 400,
"error": "Bad Request"
}{
"message": "string",
"statusCode": 401,
"error": "Unauthorized"
}{
"message": "string",
"statusCode": 403,
"error": "Forbidden"
}{
"message": "string",
"statusCode": 404,
"error": "Not Found"
}{
"message": "string",
"statusCode": 429,
"error": "Too Many Requests"
}{
"message": "string",
"statusCode": 500,
"error": "Internal Server Error"
}{
"message": "string",
"statusCode": 502,
"error": "Bad Gateway"
}{
"message": "string",
"statusCode": 503,
"error": "Service Unavailable"
}Is this guide helpful?