Skip to main content

/extended/v3/staking/bonds REST API Endpoint

Get bonds

Updated on
Aug 18, 2026

Query Parameters

limit
integer

Number of results per page

cursor
string

(Optional) Cursor for paginating bonds. Format: bond_index

Returns

total
integer

Total number of matching records.

limit
integer

Number of results per page

cursor
object

Cursor metadata for this page of results.

next
string | null

Cursor for the next page, or null when there is no next page.

previous
string | null

Cursor for the previous page, or null when there is no previous page.

current
string

Cursor identifying the current page.

results
array

Items returned for the current page.

index
integer

The index of the bond in the PoX-5 bond list

pox_version
string

Proof-of-Transfer protocol version.

status
string

Current status of the transaction or record.

parameters
object

Parameters that configure the stacking schedule.

target_rate_bps
integer

The target yield rate (APY) in basis points

stx_value_ratio
integer

This is a representation of the STXBTC price. The value represents "uSTX per 100 sats"

minimum_stx_ratio
integer

The amount of STX that must be locked relative to BTC, in equal-valued terms (ie in USD terms). This value is represented in basis points.

btc_capacity
string

The total capacity of BTC that can be locked up for this bond

registrations
object

Stacker registrations associated with the bond.

allowed_count
integer

The number of entries in the allowlist for this bond

registered_count
integer

The number of registrations for this bond

schedule
object

Stacking reward or unlock schedule.

activation
object

Bond activation details.

bitcoin_height
integer

The height at which the bond was activated

pox_cycle
integer

The POX cycle at which the bond was activated

unlock
object

Unlock details for the stacked funds.

bitcoin_height
integer

The height at which the bond can be unlocked

pox_cycle
integer

The POX cycle at which the bond can be unlocked

balances
object

Asset balances for the principal.

locked
object

Locked STX balance or lock details.

btc
string

The total amount of BTC that is locked up for this bond

stx
string

The total amount of STX that is locked up for this bond

paid_out
object

Whether the reward has been paid out.

btc
string

The total amount of BTC that has been paid out for this bond

Request
Response
1
{
2
"total": 0,
3
"limit": 1,
4
"cursor": {
5
"next": null,
6
"previous": null,
7
"current": null
8
},
9
"results": []
10
}
1
{
2
"total": 0,
3
"limit": 1,
4
"cursor": {
5
"next": null,
6
"previous": null,
7
"current": null
8
},
9
"results": []
10
}
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free