Get PoX details

RPC node

Retrieves Proof-of-Transfer (PoX) information.

GET

Parameters

Query Parameters

tip
string Stacks chain tip to query from. Options: - (empty/omitted): Use latest anchored tip (canonical confirmed state) - `latest`: Use latest known tip including unconfirmed microblocks - `{block_id}`: Use specific block ID (64 hex characters)
Status codeDescription
200Success
cURL
curl -L \
"https://api.hiro.so/v2/pox?tip={tip}" \
-H 'Accept: application/json'
Response
{
"contract_id": "SP000000000000000000002Q6VF78.pox",
"pox_activation_threshold_ustx": 52329761604388,
"first_burnchain_block_height": 666050,
"current_burnchain_block_height": 812345,
"prepare_phase_block_length": 100,
"reward_phase_block_length": 2000,
"reward_slots": 4000,
"rejection_fraction": 25,
"total_liquid_supply_ustx": 1046595232087772,
"current_cycle": {
"id": 2,
"min_threshold_ustx": 70000000000,
"stacked_ustx": 202157971547640,
"is_pox_active": true
},
"next_cycle": {
"id": 3,
"min_threshold_ustx": 70000000000,
"min_increment_ustx": 52329761604,
"stacked_ustx": 162057034977640,
"prepare_phase_start_block_height": 672250,
"blocks_until_prepare_phase": 407,
"reward_phase_start_block_height": 672350,
"blocks_until_reward_phase": 507,
"ustx_until_pox_rejection": 261648808021925
},
"min_amount_ustx": 70000000000,
"prepare_cycle_length": 100,
"reward_cycle_id": 2,
"reward_cycle_length": 2100,
"rejection_votes_left_required": 261648808021925,
"next_reward_cycle_in": 507,
"contract_versions": [
{
"contract_id": "SP000000000000000000002Q6VF78.pox",
"activation_burnchain_block_height": 666050,
"first_reward_cycle_id": 0
},
{
"contract_id": "SP000000000000000000002Q6VF78.pox-2",
"activation_burnchain_block_height": 712345,
"first_reward_cycle_id": 123
}
],
"epochs": [
{
"epoch_id": "Epoch0",
"start_height": 0,
"end_height": 200000,
"block_limit": {
"read_count": 15000,
"read_length": 100000000,
"write_count": 15000,
"write_length": 15000000,
"runtime": 5000000000
},
"network_epoch": 0
},
{
"epoch_id": "Epoch1",
"start_height": 200000,
"end_height": 300000,
"block_limit": {
"read_count": 15000,
"read_length": 100000000,
"write_count": 15000,
"write_length": 15000000,
"runtime": 5000000000
},
"network_epoch": 1
}
]
}

How is this guide?