Skip to main content

/extended/v1/stx_supply REST API Endpoint

Retrieves the total and unlocked STX supply.

Updated on
Oct 4, 2023

/extended/v1/stx_supply REST API Endpoint

Query Parameters

height
number
The block height at which to query supply details from, if not provided then the latest block height is used.

Returns

object
object
Network Target Block Times Object
unlocked_percent
string
A string representation of the decimal number indicating the percentage of STX that have unlocked.
total_stx
string
A string representation of the decimal number indicating the total possible number of STX.
unlocked_stx
string
A string representation of the decimal number indicating the STX that have been mined or unlocked.
block_height
integer
The block height at which this information was queried.
Request
1
curl -X 'GET' \
2
'https://docs-demo.stacks-mainnet.quiknode.pro/extended/v1/stx_supply' \
3
-H 'Content-Type: application/json'
Don't have an account yet?
Create your QuickNode endpoint in seconds and start building
Get started for free