Info

Read-only endpoints to obtain network, Proof-of-Transfer, Stacking, STX token, and node information

API status

get

Retrieves the running status of the Stacks Blockchain API, including the server version and current chain tip information.

Authorizations
Responses
200
Default Response
application/json
get
GET /extended HTTP/1.1
Host: stacks.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "server_version": "text",
  "status": "text",
  "pox_v1_unlock_height": 1,
  "pox_v2_unlock_height": 1,
  "pox_v3_unlock_height": 1,
  "chain_tip": {
    "block_height": 1,
    "block_hash": "text",
    "index_block_hash": "text",
    "microblock_hash": "text",
    "microblock_sequence": 1,
    "burn_block_height": 1
  }
}

Get total and unlocked STX supply

get

Retrieves the total and unlocked STX supply. More information on Stacking can be found [here] (https://docs.stacks.co/understand-stacks/stacking).

Authorizations
Query parameters
heightintegerOptional

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.

Example: 777678
unanchoredbooleanOptional

Include data from unanchored (i.e. unconfirmed) microblocks

Default: falseExample: true
Responses
200
GET request that returns network target block times
application/json
get
GET /extended/v1/stx_supply/ HTTP/1.1
Host: stacks.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "unlocked_percent": "text",
  "total_stx": "text",
  "total_stx_year_2050": "text",
  "unlocked_stx": "text",
  "block_height": 1
}

Get the network target block time

get

Retrieves the target block times for mainnet and testnet. The block time is hardcoded and will change throughout the implementation phases of the testnet.

Authorizations
Responses
200
GET request that returns network target block times
application/json
get
GET /extended/v1/info/network_block_times HTTP/1.1
Host: stacks.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "mainnet": {
    "target_block_time": 1
  },
  "testnet": {
    "target_block_time": 1
  }
}

Get a given network's target block time

get

Retrieves the target block time for a given network. The network can be mainnet or testnet. The block time is hardcoded and will change throughout the implementation phases of the testnet.

Authorizations
Path parameters
networkany ofRequired
string · enumOptionalPossible values:
or
string · enumOptionalPossible values:
Responses
200
GET request that target block time for a given network
application/json
get
GET /extended/v1/info/network_block_time/{network} HTTP/1.1
Host: stacks.nownodes.io
api-key: YOUR_API_KEY
Accept: */*

{
  "target_block_time": 1
}
PreviousFaucetsNextMicroblocks