Skip to main content

/extended/v2/pox/cycles/{cycle_number}/signers REST API Endpoint

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

Updated on
Aug 25, 2025

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