Skip to main content

/v2/pox REST API Endpoint

Retrieves Proof-of-Transfer (PoX) information. Can be used for Stacking.

Updated on
Jun 13, 2025

/v2/pox REST API Endpoint

Parameters

This method does not accept any parameters

Returns

object
GET request to retrieve Proof of Transfer (PoX) information
contract_id
string
The contract ID associated with the current active Proof of Transfer (PoX) contract
pox_activation_threshold_ustx
integer
The threshold of uSTX that must be stacked to activate PoX for a cycle
first_burnchain_block_height
integer
The block height of the first burnchain block
current_burnchain_block_height
integer
The current height of the burnchain (Bitcoin)
prepare_phase_block_length
integer
The length of the prepare phase in blocks
reward_phase_block_length
integer
The length of the reward phase in blocks
reward_slots
integer
The maximum number of reward slots available per cycle
rejection_fraction
integer
The fraction of miners required to reject a block for it to be considered invalid, or null if not applicable
total_liquid_supply_ustx
integer
The total liquid supply of microstacks (uSTX)
current_cycle
object
Information about the current reward cycle
id
integer
The ID of the current reward cycle
min_threshold_ustx
integer
The minimum threshold of uSTX required to participate in the current cycle
stacked_ustx
integer
The total amount of uSTX stacked in the current cycle
is_pox_active
boolean
Indicates whether PoX is active for the current cycle
next_cycle
object
Information about the upcoming reward cycle
id
integer
The ID of the next reward cycle
min_threshold_ustx
integer
The minimum threshold of uSTX required to participate in the next cycle
min_increment_ustx
integer
The minimum increment of uSTX that can be stacked
stacked_ustx
integer
The total amount of uSTX currently stacked for the next cycle
prepare_phase_start_block_height
integer
The burnchain block height at which the prepare phase for the next cycle begins
blocks_until_prepare_phase
integer
The number of blocks until the prepare phase of the next cycle begins
reward_phase_start_block_height
integer
The burnchain block height at which the reward phase for the next cycle begins
blocks_until_reward_phase
integer
The number of blocks until the reward phase of the next cycle begins
ustx_until_pox_rejection
integer
The amount of uSTX needed to reach the rejection threshold, or null if not applicable
epochs
array
Array of epoch information defining protocol parameters at different block heights
epoch_id
string
The identifier of the epoch
start_height
integer
The starting block height of this epoch
end_height
integer
The ending block height of this epoch
block_limit
object
The block resource limits for this epoch
write_length
integer
The maximum write length limit for blocks in this epoch
write_count
integer
The maximum write count limit for blocks in this epoch
read_length
integer
The maximum read length limit for blocks in this epoch
read_count
integer
The maximum read count limit for blocks in this epoch
runtime
integer
The maximum runtime limit for blocks in this epoch
network_epoch
integer
The network epoch number
min_amount_ustx
integer
The minimum amount of microstacks (uSTX) required for PoX participation
prepare_cycle_length
integer
The length of the prepare cycle in blocks
reward_cycle_id
integer
The ID of the current reward cycle
reward_cycle_length
integer
The total length of a reward cycle in blocks (prepare + reward phases)
rejection_votes_left_required
integer
The number of rejection votes required to invalidate a block, or null if not applicable
next_reward_cycle_in
integer
The number of blocks until the next reward cycle begins
contract_versions
array
History of PoX contract versions and their activation details
contract_id
string
The contract ID of this PoX version
activation_burnchain_block_height
integer
The burnchain block height at which this contract version was activated
first_reward_cycle_id
integer
The ID of the first reward cycle that used this contract version
Request
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free