Signers

Endpoints for retrieving signer information.

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

get

http://localhost:20443https://api.mainnet.hiro.sohttps://api.testnet.hiro.so

/v3/stacker_set/{cycle_number}

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.

Path parameters

cycle_numberintegerRequired

reward cycle number

Query parameters

tipstring · max: 64Optional

Stacks chain tip to query from. Options:

• (empty/omitted): Use latest anchored tip (canonical confirmed state)
• latest: Use latest known tip including unconfirmed microblocks
• {block_id}: Use specific block ID (64 hex characters)

Example: latestPattern: ^(latest|[0-9a-f]{64})?$

Responses

200

Information for the given reward cycle

application/json

400

Could not fetch the given reward set

application/json

get

/v3/stacker_set/{cycle_number}

HTTPcURLJavaScriptPython

GET /v3/stacker_set/{cycle_number} HTTP/1.1
Host: localhost:20443
Accept: */*

{
  "stacker_set": {
    "rewarded_addresses": [
      {
        "Standard": [
          {
            "bytes": "dc5f18421006ee2b98ab972edfa7268a981e3f00",
            "version": 26
          },
          "SerializeP2PKH"
        ]
      }
    ],
    "signers": [
      {
        "signing_key": "02d0a27e4f1bf186b4391eecfcc4d4a0d403684ad089b477b8548a69dd6378bf26",
        "weight": 1,
        "stacked_amt": 2143020000000000
      }
    ],
    "start_cycle_state": {
      "missed_reward_slots": []
    },
    "pox_ustx_threshold": 110000000000
  }
}