Get total and unlocked STX supply

Retrieves the total and unlocked STX supply.

GET

/extended/v1/stx_supply

Retrieves the total and unlocked STX supply. More information on Stacking can be found here.

Note: This uses the estimated future total supply for the year 2050.

Query parameters

heightnumber

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

Example: 200
Status codeDescription
200Success
Terminal
curl -X GET "https://api.mainnet.hiro.so/extended/v1/stx_supply"

GET request that returns network target block times

Example response
{
  "unlocked_percent": "string",
  "total_stx": "string",
  "unlocked_stx": "string",
  "block_height": 0
}