Skip to main content

GET /extended/v3/staking/bonds/{bond_index}/events - Stacks REST API V3

Returns the PoX-5 event history for a bond, newest first, including registrations, unstakes, reward distributions, and claims.

Updated on
Nov 12, 2026

Path Parameters

bond_index
integer
REQUIRED

PoX-5 bond index.

Query Parameters

limit
integer

Number of bond events to return.

cursor
string

Opaque cursor from a previous 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

Bond events in reverse chronological order.

name
string

PoX-5 bond event type.

bond_index
integer

PoX-5 bond index.

transaction
object

Transaction and event position.

tx_id
string

Transaction ID.

event_index
integer

Event index within the transaction.

block
object

Stacks block containing the record.

height
integer

Block height.

hash
string

Block hash.

index_hash
string

Stacks index block hash.

time
number

Unix timestamp in seconds when the block was mined.

time_iso
string

Block timestamp in ISO 8601 UTC format.

tx_index
integer

Zero-based transaction index within the block.

bitcoin_block
object

Bitcoin block anchoring the record.

height
integer

Block height.

time
number

Unix timestamp in seconds when the block was mined.

time_iso
string

Block timestamp in ISO 8601 UTC format.

data
object

Event payload. Fields are conditional on name. Bitcoin amounts are decimal strings in satoshis; STX amounts are decimal strings in microSTX.

staker
string

Present for add-to-allowlist, announce-l1-early-exit, claim-staker-rewards-for-signer, register-for-bond, unstake-sbtc, update-bond-registration. Staker principal.

max_sats
string

Present for add-to-allowlist. Maximum allowed Bitcoin stake in satoshis, encoded as a decimal string.

signer
string

Present for announce-l1-early-exit, register-for-bond, unstake-sbtc, update-bond-registration. Signer principal.

released
object

Present for announce-l1-early-exit. Bitcoin released by an early exit.

btc
string

Bitcoin amount in satoshis, encoded as a decimal string.

calculation
object

Present for bond-distribution. Reward-calculation position; it can differ from the event block position.

bitcoin_height
integer

Bitcoin block height.

reward_cycle
integer

PoX reward cycle associated with the calculation or claim.

target_yield
string

Present for bond-distribution. Target reward for this calculation, in satoshis as a decimal string.

rewards
object

Present for bond-distribution. Rewards earned by the bond in this calculation.

btc
string

Bitcoin amount in satoshis, encoded as a decimal string.

staked
object

Present for bond-distribution. Bitcoin staked at calculation time.

btc
string

Bitcoin amount in satoshis, encoded as a decimal string.

accrued_rewards_per_sat
string

Present for bond-distribution. Per-satoshi reward increment as a decimal fixed-point integer scaled by 10^18.

cumulative_rewards_per_sat
string

Present for bond-distribution. Cumulative per-satoshi reward as a decimal fixed-point integer scaled by 10^18.

signer_manager
string

Present for claim-staker-rewards-for-signer. Signer manager contract principal.

reward_cycle
integer

Present for claim-staker-rewards-for-signer. PoX reward cycle associated with the calculation or claim.

claimed
object

Present for claim-staker-rewards-for-signer. Claimed rewards.

btc
string

Bitcoin amount in satoshis, encoded as a decimal string.

type
string

Present for register-for-bond, update-bond-registration. Stake source: l1 for Bitcoin L1 locks or sbtc for sBTC.

balances
object

Present for register-for-bond, update-bond-registration. Bitcoin and STX balances represented by the registration.

btc
string

Bitcoin amount in satoshis, encoded as a decimal string.

stx
string

STX amount in microSTX, encoded as a decimal string.

parameters
object

Present for setup-bond. Bond configuration.

target_rate_bps
integer

Target reward rate in basis points.

stx_value_ratio
integer

STX valuation ratio used by the bond.

minimum_stx_ratio
integer

Minimum STX backing ratio.

early_unlock_bytes
string

Present for setup-bond. Hexadecimal Bitcoin script for the early-exit branch of the lockup.

schedule
object

Present for setup-bond. Bond or cycle schedule.

enrollment_cutoff
object

Last enrollment point.

bitcoin_height
integer

Bitcoin block height.

pox_cycle
integer

PoX reward cycle number.

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.

activation
object

Bond activation point.

bitcoin_height
integer

Bitcoin block height.

pox_cycle
integer

PoX reward cycle number.

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.

unlock
object

Bond unlock point.

bitcoin_height
integer

Bitcoin block height.

pox_cycle
integer

PoX reward cycle number.

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.

withdrawn
object

Present for unstake-sbtc. Bitcoin withdrawn from the bond.

btc
string

Bitcoin amount in satoshis, encoded as a decimal string.

remaining
object

Present for unstake-sbtc. Bitcoin remaining in the bond; zero represents a full exit.

btc
string

Bitcoin amount in satoshis, encoded as a decimal string.

old_signer
string

Present for update-bond-registration. Previous signer principal.

Request
Response
1
{
2
"total": 117,
3
"limit": 1,
4
"cursor": {
5
"next": "9426096:2147483647:1:114",
6
"previous": null,
7
"current": "9451259:2147483647:0:1"
8
},
9
"results": [
10
{
11
"name": "unstake-sbtc",
12
"bond_index": 1,
13
"transaction": {
14
"tx_id": "0xb64887ac07bed8059ce91da679053277bc8e1512301bb4d459d89b04a56b4c3f",
15
"event_index": 1
16
},
17
"block": {
18
"height": 9451259,
19
"hash": "0xec597d9266b548e510331ba2fb6681e1adfa3df461bc563e38f0ea8ce4e32d89",
20
"index_hash": "0x7b5bd80c936c8d1b6c457ca92d7362dca778fcbba2fac432c49d860a879d0646",
21
"time": 1794266966,
22
"time_iso": "2026-11-09T23:29:26.000Z",
23
"tx_index": 0
24
},
25
"bitcoin_block": {
26
"height": 975223,
27
"time": 1794266292,
28
"time_iso": "2026-11-09T23:18:12.000Z"
29
},
30
"data": {
31
"staker": "SPFCGF789WX1B737VQYAQ6BG3QYVMJGPDKRKYK00.esbee-dao-bond-staker-1",
32
"signer": "SPMPMA1V6P430M8C91QS1G9XJ95S59JS1TZFZ4Q4.fastpool-max500-signer-manager",
33
"withdrawn": {
34
"btc": "480000000"
35
},
36
"remaining": {
37
"btc": "19370783"
38
}
39
}
40
}
41
]
42
}
1
{
2
"total": 117,
3
"limit": 1,
4
"cursor": {
5
"next": "9426096:2147483647:1:114",
6
"previous": null,
7
"current": "9451259:2147483647:0:1"
8
},
9
"results": [
10
{
11
"name": "unstake-sbtc",
12
"bond_index": 1,
13
"transaction": {
14
"tx_id": "0xb64887ac07bed8059ce91da679053277bc8e1512301bb4d459d89b04a56b4c3f",
15
"event_index": 1
16
},
17
"block": {
18
"height": 9451259,
19
"hash": "0xec597d9266b548e510331ba2fb6681e1adfa3df461bc563e38f0ea8ce4e32d89",
20
"index_hash": "0x7b5bd80c936c8d1b6c457ca92d7362dca778fcbba2fac432c49d860a879d0646",
21
"time": 1794266966,
22
"time_iso": "2026-11-09T23:29:26.000Z",
23
"tx_index": 0
24
},
25
"bitcoin_block": {
26
"height": 975223,
27
"time": 1794266292,
28
"time_iso": "2026-11-09T23:18:12.000Z"
29
},
30
"data": {
31
"staker": "SPFCGF789WX1B737VQYAQ6BG3QYVMJGPDKRKYK00.esbee-dao-bond-staker-1",
32
"signer": "SPMPMA1V6P430M8C91QS1G9XJ95S59JS1TZFZ4Q4.fastpool-max500-signer-manager",
33
"withdrawn": {
34
"btc": "480000000"
35
},
36
"remaining": {
37
"btc": "19370783"
38
}
39
}
40
}
41
]
42
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free