Skip to main content

Get total and unlocked STX supply

Retrieves the total and unlocked STX supply. More information on Stacking can be found [here] (https://docs.stacks.co/understand-stacks/stacking). Note: This uses the estimated future total supply for the year 2050.

Query Parameters
height number

Supply details are queried from specified block height. If the block height is not specified, the latest block height is taken as default value. Note that the block height is referred to the stacks blockchain.

Responses
200

Success

Schema OPTIONAL
unlocked_percent string

String quoted decimal number of the percentage of STX that have unlocked

total_stx string

String quoted decimal number of the total possible number of STX

unlocked_stx string

String quoted decimal number of the STX that have been mined or unlocked

block_height integer

The block height at which this information was queried