Skip to main content

/extended/v2/pox/cycles/{cycle_number}/signers API Method

Retrieves a paginated list of signers (participants) who have locked STX tokens in a specific Proof of Transfer (PoX) cycle

Updated on
Jun 13, 2025

/extended/v2/pox/cycles/{cycle_number}/signers API Method

Path Parameters

cycle_number
integer
REQUIRED
The sequential number of the PoX cycle to retrieve signers for. Cycles are numbered starting from 1.

Query Parameters

limit
integer
Maximum number of signers to return per page. Defaults to 100 if not specified.
offset
integer
Number of signers to skip for pagination. Used with limit to paginate through results.

Returns

pox_cycle_signers_response
object
Response containing a paginated list of signers for the specified PoX cycle
limit
integer
The number of results returned per page, as requested in the query parameters
offset
integer
The number of results skipped, as requested in the query parameters
total
integer
The total number of signers participating in this PoX cycle
results
array
List of signers participating in this PoX cycle, sorted by weight in descending order
signing_key
string
The public key used by this participant for signing blocks in the PoX consensus mechanism
signer_address
string
The Stacks address of this participant in the PoX consensus mechanism
weight
integer
The voting weight of this participant in the PoX consensus mechanism, representing their proportional influence
stacked_amount
string
The total amount of STX tokens locked (stacked) by this participant, represented as a string to preserve precision of large numbers. This value is denominated in micro-STX (1 STX = 1,000,000 micro-STX).
weight_percent
number
The percentage of the total cycle weight represented by this participant's weight
stacked_amount_percent
number
The percentage of the total cycle stacked amount represented by this participant's stacked amount
solo_stacker_count
integer
The number of individual participants who stacked STX directly with this signer (not through a pool)
pooled_stacker_count
integer
The number of individual participants who stacked STX with this signer through a stacking pool
Request
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free