Primary Network

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.

get/v1/networks/{network}/validators/{nodeId}/cycles

Path parameters

network'mainnet' | 'fuji' | 'testnet' required

Either mainnet or testnet/fuji.

nodeIdstring required

A primary network (P or X chain) nodeId.

Query parameters

txHashstring

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.

pageTokenstring

A page token, received from a previous list call. Provide this to retrieve the subsequent page.

pageSizeinteger

The maximum number of items to return. The minimum page size is 1. The maximum pageSize is 100.

sortOrder'asc' | 'desc'

The 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.

Response

Successful response

nextPageTokenstring

A token, which can be sent as pageToken to retrieve the next page. If this field is omitted or empty, there are no subsequent pages.

Changes