Path Parameters

cycle_number

integer

REQUIRED

PoX reward cycle number.

Returns

number

integer

PoX reward cycle number.

status

string

Cycle status: upcoming, reward_phase, prepare_phase, or finished.

schedule

object

Bond or cycle schedule.

start

object

First block of the cycle.

bitcoin_height

integer

Bitcoin block height.

time

integer | null

Unix block time in seconds; null when not yet available.

time_iso

string | null

Block time in ISO 8601 UTC format; null when not yet available.

projected_time

integer | null

Estimated Unix time in seconds for a future Bitcoin block, or null when no projection is needed or available.

projected_time_iso

string | null

Projected time in ISO 8601 UTC format, or null when no projection is available.

prepare_phase_start

object

First block of the prepare phase.

bitcoin_height

integer

Bitcoin block height.

time

integer | null

Unix block time in seconds; null when not yet available.

time_iso

string | null

Block time in ISO 8601 UTC format; null when not yet available.

projected_time

integer | null

Estimated Unix time in seconds for a future Bitcoin block, or null when no projection is needed or available.

projected_time_iso

string | null

Projected time in ISO 8601 UTC format, or null when no projection is available.

end

object

Last block of the cycle, inclusive.

bitcoin_height

integer

Bitcoin block height.

time

integer | null

Unix block time in seconds; null when not yet available.

time_iso

string | null

Block time in ISO 8601 UTC format; null when not yet available.

projected_time

integer | null

Estimated Unix time in seconds for a future Bitcoin block, or null when no projection is needed or available.

projected_time_iso

string | null

Projected time in ISO 8601 UTC format, or null when no projection is available.

locked

object

Assets locked for this cycle.

stx

object

STX locked for this cycle, in microSTX as decimal strings.

stx_only

string

MicroSTX locked by STX-only staking.

bonds

string

MicroSTX locked across active bonds.

total

string

Sum of STX-only and bond stake in microSTX.

btc

object

Bitcoin locked through bonds, in satoshis as decimal strings.

total

string

Total Bitcoin stake in satoshis.

native

string

Satoshis locked on Bitcoin L1.

sbtc

string

Satoshis locked as sBTC.

participants

object

Staker and signer counts.

stakers

object

Numbers of participating principals.

stx_only

integer

Number of principals with STX-only stake.

bonds

integer

Number of principals with bond positions.

signers

integer | null

Number of reward-set signers; null until the reward set is available.

bonds

object

Bonds active in the selected cycle.

total

integer

Number of active bonds.

indexes

array

Active bond indexes in ascending order.

rewards

object

sBTC rewards attributed to this cycle, in satoshis as decimal strings.

btc

object

Reward totals and allocation.

total

string

Total rewards booked to the cycle so far, in satoshis; equals the sum of the waterfall entries.

waterfall

object

Reward allocation in payout order.

bonds

string

Rewards allocated to bond participants in satoshis.

stx_only

string

Rewards allocated to STX-only stakers in satoshis.

reserve_deposit

string

Rewards deposited into the reserve in satoshis.

claimed

string

Rewards claimed by signer managers so far, in satoshis.

Request

1
curl -X GET "https://docs-demo.stacks-mainnet.quiknode.pro/extended/v3/staking/cycles/147" \
2
  -H "Content-Type: application/json" \
3
  -H "Accept: application/json"
4

1
curl -X GET "https://docs-demo.stacks-mainnet.quiknode.pro/extended/v3/staking/cycles/147" \
2
  -H "Content-Type: application/json" \
3
  -H "Accept: application/json"
4

1
async function main() {
2
    const response = await fetch('https://docs-demo.stacks-mainnet.quiknode.pro/extended/v3/staking/cycles/147', {
3
        method: 'GET',
4
        headers: {'Content-Type': 'application/json', 'Accept': 'application/json'}
5
    })
6
    const data = await response.json()
7
    console.log(data)
8
}
9

10
main()
11

1
async function main() {
2
    const response = await fetch('https://docs-demo.stacks-mainnet.quiknode.pro/extended/v3/staking/cycles/147', {
3
        method: 'GET',
4
        headers: {'Content-Type': 'application/json', 'Accept': 'application/json'}
5
    })
6
    const data = await response.json()
7
    console.log(data)
8
}
9

10
main()
11

1
import requests
2
import json
3

4
url = "https://docs-demo.stacks-mainnet.quiknode.pro/extended/v3/staking/cycles/147"
5

6
headers = {
7
  'Content-Type': 'application/json',
8
  'Accept': 'application/json'
9
}
10

11
response = requests.request("GET", url, headers=headers)
12

13
print(response.text)
14

1
import requests
2
import json
3

4
url = "https://docs-demo.stacks-mainnet.quiknode.pro/extended/v3/staking/cycles/147"
5

6
headers = {
7
  'Content-Type': 'application/json',
8
  'Accept': 'application/json'
9
}
10

11
response = requests.request("GET", url, headers=headers)
12

13
print(response.text)
14

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.stacks-mainnet.quiknode.pro/extended/v3/staking/cycles/147")
6

7
request = Net::HTTP::Get.new(uri)
8
request["Content-Type"] = "application/json"
9
request["Accept"] = "application/json"
10

11
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
12
  http.request(request)
13
end
14

15
puts response.body
16

1
require "uri"
2
require "json"
3
require "net/http"
4

5
uri = URI("https://docs-demo.stacks-mainnet.quiknode.pro/extended/v3/staking/cycles/147")
6

7
request = Net::HTTP::Get.new(uri)
8
request["Content-Type"] = "application/json"
9
request["Accept"] = "application/json"
10

11
response = Net::HTTP.start(uri.host, uri.port, use_ssl: true) do |http|
12
  http.request(request)
13
end
14

15
puts response.body
16

Response

1
{
2
  "number": 147,
3
  "status": "reward_phase",
4
  "schedule": {
5
    "start": {
6
      "bitcoin_height": 974750,
7
      "time": 1793931729,
8
      "time_iso": "2026-11-06T02:22:09.000Z",
9
      "projected_time": null,
10
      "projected_time_iso": null
11
    },
12
    "prepare_phase_start": {
13
      "bitcoin_height": 976750,
14
      "time": null,
15
      "time_iso": null,
16
      "projected_time": 1795197215,
17
      "projected_time_iso": "2026-11-20T17:53:35.000Z"
18
    },
19
    "end": {
20
      "bitcoin_height": 976849,
21
      "time": null,
22
      "time_iso": null,
23
      "projected_time": 1795256615,
24
      "projected_time_iso": "2026-11-21T10:23:35.000Z"
25
    }
26
  },
27
  "locked": {
28
    "stx": {
29
      "stx_only": "489755614113160",
30
      "bonds": "24156674220429",
31
      "total": "513912288333589"
32
    },
33
    "btc": {
34
      "total": "173526933003",
35
      "native": "107021450000",
36
      "sbtc": "66505483003"
37
    }
38
  },
39
  "participants": {
40
    "stakers": {
41
      "stx_only": 3371,
42
      "bonds": 28
43
    },
44
    "signers": 35
45
  },
46
  "bonds": {
47
    "total": 3,
48
    "indexes": [
49
      1,
50
      2,
51
      3
52
    ]
53
  },
54
  "rewards": {
55
    "btc": {
56
      "total": "0",
57
      "waterfall": {
58
        "bonds": "0",
59
        "stx_only": "0",
60
        "reserve_deposit": "0"
61
      },
62
      "claimed": "0"
63
    }
64
  }
65
}

1
{
2
  "number": 147,
3
  "status": "reward_phase",
4
  "schedule": {
5
    "start": {
6
      "bitcoin_height": 974750,
7
      "time": 1793931729,
8
      "time_iso": "2026-11-06T02:22:09.000Z",
9
      "projected_time": null,
10
      "projected_time_iso": null
11
    },
12
    "prepare_phase_start": {
13
      "bitcoin_height": 976750,
14
      "time": null,
15
      "time_iso": null,
16
      "projected_time": 1795197215,
17
      "projected_time_iso": "2026-11-20T17:53:35.000Z"
18
    },
19
    "end": {
20
      "bitcoin_height": 976849,
21
      "time": null,
22
      "time_iso": null,
23
      "projected_time": 1795256615,
24
      "projected_time_iso": "2026-11-21T10:23:35.000Z"
25
    }
26
  },
27
  "locked": {
28
    "stx": {
29
      "stx_only": "489755614113160",
30
      "bonds": "24156674220429",
31
      "total": "513912288333589"
32
    },
33
    "btc": {
34
      "total": "173526933003",
35
      "native": "107021450000",
36
      "sbtc": "66505483003"
37
    }
38
  },
39
  "participants": {
40
    "stakers": {
41
      "stx_only": 3371,
42
      "bonds": 28
43
    },
44
    "signers": 35
45
  },
46
  "bonds": {
47
    "total": 3,
48
    "indexes": [
49
      1,
50
      2,
51
      3
52
    ]
53
  },
54
  "rewards": {
55
    "btc": {
56
      "total": "0",
57
      "waterfall": {
58
        "bonds": "0",
59
        "stx_only": "0",
60
        "reserve_deposit": "0"
61
      },
62
      "claimed": "0"
63
    }
64
  }
65
}

Don't have an account yet?

Create your Quicknode endpoint in seconds and start building

Get started for free