<!-- source: https://secondlayer.tools/docs/api-reference#list-pox4-cycles -->

## Reward cycles of the current PoX (PoX-5)

`GET /v1/index/pox/cycles`

One row per pox-5 reward cycle, descending, exact to the node: total stacked, reward-eligible STX, bond sats, sBTC custodied, rewards allocated/claimed, and cumulative rewards-per-token. Without a cursor, your list starts at the next reward cycle (the current one plus one) and goes back in time. Pass a higher `cursor` to reach cycles further in the future, which PoX-5 bonds can lock many cycles ahead. `pox_version` marks the era; at the next PoX fork this endpoint follows the chain and reports the new PoX instead. PoX-4 history is final and not served here; rebuild it from `/v1/index/stacking` on a self-hosted instance. Frozen cycles cache for an hour; the still-open current cycle caches briefly.

### Range and paging

| Name | Type | Description |
| --- | --- | --- |
| `limit` | integer · 1 to 100 | Cycles per page, 1 to 100. Defaults to 20; anything else is refused. |
| `cursor` | integer | `next_cursor` from the previous page, or any reward cycle (exclusive) to page from. Returns cycles below it. Omit it and the list starts at the next reward cycle. |

### Returns

A cursor envelope; `cycles` holds `Pox5Cycle` objects.

### Responses

- `200` Reward cycles, descending from the next reward cycle
- `400` `limit` or `cursor` is out of range, or an unknown parameter was sent
- `401` This bind requires the instance token, and it was missing or wrong
- `429` Rate limited; retry after `Retry-After` seconds

### Example

```bash
curl https://api.secondlayer.tools/v1/index/pox/cycles \
  -H "Authorization: Bearer $SECONDLAYER_API_KEY"
```

```json
{
  "pox_version": 5,
  "cycles": [
    {
      "reward_cycle": 141,
      "start_burn_height": 962150,
      "prepare_start_burn_height": 962050,
      "end_burn_height": 964249,
      "total_stacked_ustx": "392447554847960",
      "reward_eligible_ustx": "392447554847960",
      "stakers": 3035,
      "signers_in_set": 36,
      "bond_sats": {
        "1": "23017037628"
      },
      "bond_total_sats": "23017037628",
      "sbtc_custodied_sats": "16016587628",
      "rewards_allocated_stx": "297713728",
      "rewards_allocated_bond": "13810222",
      "reserve_deposit": "52537716",
      "rewards_per_token_stx": "758607677183",
      "rewards_per_token_bond": {
        "1": "599999974940302"
      },
      "distributions": 2,
      "rewards_claimed": "162018760",
      "computed_through_height": 8665732,
      "is_current": false,
      "is_frozen": true
    }
  ],
  "next_cursor": 141,
  "tip": {
    "block_height": 9048690,
    "finalized_height": 9048457,
    "lag_seconds": 4,
    "source_block_height": 9048692
  }
}
```
