Get total and unlocked STX supply

Retrieves the total and unlocked STX supply.

GET

Parameters

Query Parameters

height
integer 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.
unanchored
boolean Include data from unanchored (i.e. unconfirmed) microblocks
Status codeDescription
200GET request that returns network target block times
4XXDefault Response
cURL
curl -L \
"https://api.hiro.so/extended/v1/stx_supply/?height=777678&unanchored=true" \
-H 'Accept: application/json'
Response
{
"unlocked_percent": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"total_stx": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"total_stx_year_2050": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"unlocked_stx": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
"block_height": 144000
}

How is this guide?