# Signers

Endpoints for retrieving signer information.

## Fetch the stacker and signer set information for a given cycle.

> Used to get stacker and signer set information for a given cycle.\
> \
> This will only return information for cycles started in Epoch-2.5\
> where PoX-4 was active and subsequent cycles.<br>

```json
{"openapi":"3.1.0","info":{"title":"Stacks 3.0+ RPC API","version":"1.0.0"},"tags":[{"name":"Signers","description":"Endpoints for retrieving signer information."}],"servers":[{"url":"http://localhost:20443","description":"Local Stacks Node"},{"url":"https://api.mainnet.hiro.so","description":"Stacks Mainnet API"},{"url":"https://api.testnet.hiro.so","description":"Stacks Testnet API"}],"security":[],"paths":{"/v3/stacker_set/{cycle_number}":{"get":{"summary":"Fetch the stacker and signer set information for a given cycle.","tags":["Signers"],"operationId":"getStackerSet","description":"Used to get stacker and signer set information for a given cycle.\n\nThis will only return information for cycles started in Epoch-2.5\nwhere PoX-4 was active and subsequent cycles.\n","parameters":[{"name":"cycle_number","in":"path","required":true,"description":"reward cycle number","schema":{"type":"integer"}},{"name":"tip","in":"query","schema":{"type":"string","pattern":"^(latest|[0-9a-f]{64})?$","maxLength":64},"description":"Stacks chain tip to query from. Options:\n- (empty/omitted): Use latest anchored tip (canonical confirmed state)\n- `latest`: Use latest known tip including unconfirmed microblocks\n- `{block_id}`: Use specific block ID (64 hex characters)\n"}],"responses":{"200":{"description":"Information for the given reward cycle","content":{"application/json":{"schema":{"type":"object","properties":{"stacker_set":{"type":"object","required":["rewarded_addresses","start_cycle_state"],"properties":{"rewarded_addresses":{"type":"array","description":"Reward addresses that will receive PoX rewards for the cycle.","items":{"type":"object","description":"PoX address object with serialization details (see SIP-007).","properties":{"Standard":{"type":"array","description":"Standard address representation.","items":{"oneOf":[{"type":"object","properties":{"bytes":{"type":"string","description":"Hex-encoded 20-byte address payload"},"version":{"type":"integer","description":"Address version byte"}}},{"type":"string","description":"Serialization method (e.g., \"SerializeP2PKH\")"}]}}},"additionalProperties":true}},"signers":{"type":"array","description":"Optional signer set for PoX-4 reward cycles.","items":{"type":"object","properties":{"signing_key":{"type":"string","description":"Hex-encoded compressed Secp256k1 public key (33 bytes)"},"weight":{"type":"integer","description":"Signer voting weight (number of slots)"},"stacked_amt":{"type":"integer","format":"int64","description":"Amount stacked by signer (in microSTX)"}}}},"start_cycle_state":{"type":"object","properties":{"missed_reward_slots":{"type":"array","description":"Principals that missed reward slots at cycle start.","items":{"type":"object"}}}},"pox_ustx_threshold":{"type":"integer","format":"int64","description":"Minimum STX amount required to qualify for stacking (optional)"}}}}}}}},"400":{"description":"Could not fetch the given reward set","content":{"application/json":{"schema":{"type":"object","required":["response","err_msg"],"properties":{"response":{"type":"string","enum":["error"],"description":"Response status"},"err_type":{"type":"string","description":"Error type classification"},"err_msg":{"type":"string","description":"Detailed error message"}}}}}},"404":{"description":"Reward cycle not found or does not exist","content":{"text/plain":{"schema":{"type":"string"}}}}}}}}}
```
