Skip to main content

GET /extended/v3/staking/cycles/{cycle_number}/signers - Stacks REST API V3

Returns the signer set for a PoX reward cycle, including voting weight, staked STX, and signer manager registrations.

Updated on
Nov 12, 2026

Path Parameters

cycle_number
integer
REQUIRED

PoX reward cycle number.

Query Parameters

limit
integer

Number of signer records to return.

cursor
string

Opaque cursor from the next or previous field of a prior response.

Returns

total
integer

Total number of matching records.

limit
integer

Maximum number of records returned on this page.

cursor
object

Pagination cursors.

next
string | null

Cursor for the next page, or null when this is the last page.

previous
string | null

Cursor for the previous page, or null when this is the first page.

current
string

Cursor identifying this page.

results
array

Records returned for this request.

signing_key
string

Signer public key as a 0x-prefixed hexadecimal string.

weight
object

Signer voting weight.

amount
integer

Signer voting weight.

percent
number

Percentage of total cycle voting weight.

staked_stx
object

STX staked behind this signer.

amount
string

Staked amount in microSTX as a decimal string.

percent
number

Percentage of total STX staked for the cycle.

signer_managers
array

Signer manager contracts associated with this key for the selected cycle.

signer_manager
string

Signer manager contract principal.

registered_at
object

Chain position at which the signer manager registered this key.

block_height
integer

Stacks block height.

bitcoin_block_height
integer

Bitcoin block height.

tx_id
string

Transaction ID.

granted_keys
array

Active signing-key authorizations held by the manager.

signer_key
string

Authorized signing public key as a hexadecimal string.

auth_id
string

Authorization identifier as a decimal string.

tx_id
string

Transaction ID.

grant_active
boolean

Whether an active authorization exists for the registered signing key.

pending_key_update
object | null

Pending registered key change, or null when there is none.

signer_key
string

Authorized signing public key as a hexadecimal string.

effective_cycle
integer

PoX cycle when the new signing key takes effect.

tx_id
string

Transaction ID.

Request
Response
1
{
2
"total": 35,
3
"limit": 1,
4
"cursor": {
5
"next": "0x023d6e4adbd5e7bedd5a1e1b85940e1e8c6c34924fd0d584e5e15d84c8572083d9",
6
"previous": null,
7
"current": "0x02fcf9e4c4bf998223095d849dcda17de147c4b50ab3751164c670aea956eba68d"
8
},
9
"results": [
10
{
11
"signing_key": "0x02fcf9e4c4bf998223095d849dcda17de147c4b50ab3751164c670aea956eba68d",
12
"weight": {
13
"amount": 695,
14
"percent": 17.375
15
},
16
"staked_stx": {
17
"amount": "89272590000000",
18
"percent": 17.372863428242674
19
},
20
"signer_managers": [
21
{
22
"signer_manager": "SP1N8F8BBBC60XF6HJBNJHKPRGJ7WZBRGNDJX4YDR.signer-manager",
23
"registered_at": {
24
"block_height": 8700787,
25
"bitcoin_block_height": 960988,
26
"tx_id": "0x13dcbbb9068873d1150c2268c5e280277a9963ebd06992bc63a9437463347c8a"
27
},
28
"granted_keys": [
29
{
30
"signer_key": "0x02fcf9e4c4bf998223095d849dcda17de147c4b50ab3751164c670aea956eba68d",
31
"auth_id": "1",
32
"tx_id": "0x13dcbbb9068873d1150c2268c5e280277a9963ebd06992bc63a9437463347c8a"
33
}
34
],
35
"grant_active": true,
36
"pending_key_update": null
37
}
38
]
39
}
40
]
41
}
1
{
2
"total": 35,
3
"limit": 1,
4
"cursor": {
5
"next": "0x023d6e4adbd5e7bedd5a1e1b85940e1e8c6c34924fd0d584e5e15d84c8572083d9",
6
"previous": null,
7
"current": "0x02fcf9e4c4bf998223095d849dcda17de147c4b50ab3751164c670aea956eba68d"
8
},
9
"results": [
10
{
11
"signing_key": "0x02fcf9e4c4bf998223095d849dcda17de147c4b50ab3751164c670aea956eba68d",
12
"weight": {
13
"amount": 695,
14
"percent": 17.375
15
},
16
"staked_stx": {
17
"amount": "89272590000000",
18
"percent": 17.372863428242674
19
},
20
"signer_managers": [
21
{
22
"signer_manager": "SP1N8F8BBBC60XF6HJBNJHKPRGJ7WZBRGNDJX4YDR.signer-manager",
23
"registered_at": {
24
"block_height": 8700787,
25
"bitcoin_block_height": 960988,
26
"tx_id": "0x13dcbbb9068873d1150c2268c5e280277a9963ebd06992bc63a9437463347c8a"
27
},
28
"granted_keys": [
29
{
30
"signer_key": "0x02fcf9e4c4bf998223095d849dcda17de147c4b50ab3751164c670aea956eba68d",
31
"auth_id": "1",
32
"tx_id": "0x13dcbbb9068873d1150c2268c5e280277a9963ebd06992bc63a9437463347c8a"
33
}
34
],
35
"grant_active": true,
36
"pending_key_update": null
37
}
38
]
39
}
40
]
41
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free