JSON API · BTX Network Status

Files

/api/v1/status.json: the current status: verdicts, every value with its traffic light and time
/api/v1/metrics.json: what each value means: title, description, unit, thresholds
/api/v1/ecosystem.json: the projects of the ecosystem page with their activity

Fields of status.json

schema_version: version of the format; it only changes with an announcement
software_version: version of this page (see Changes)
generated_at: when the file was built (UTC)
data_as_of: time of the data from our archive nodes (UTC)
stale: true if our data is older than allowed: do not show it as current
overall: overall state: normal, degraded or incident
decentralisation: rating of block production: good, concentrated or critical
verdicts: the three verdicts (stable, performant, secure) with their level and the values that pull them down
metrics: every value with id, value, unit, level (green, yellow, red, unknown or null for values without a traffic light), observed_at and its sources

Using the data

Please name "BTX Network Status" with a link to this page as the source.
When stale is true, show a warning instead of the values.
Read at most once a minute; the data does not change faster.
Format v1 stays compatible: new fields and values may be added, nothing is removed or renamed without an announcement on the Changes page.

All values

Every id that can appear in status.json, built from the metric list.

Id	Value	Unit
`chain.height`	Block height	blocks
`chain.tip_age`	Age of last block	seconds
`chain.block_interval_avg_24h`	Average block interval (24 h)	seconds
`chain.block_interval_max_24h`	Longest gap (24 h)	seconds
`chain.blocks_24h`	Blocks (24 h)	blocks
`chain.reorgs_7d`	Reorgs seen by our node (7 days)	count
`chain.reorg_max_depth_24h`	Deepest reorg (24 h)	blocks
`chain.reorg_max_depth_7d`	Deepest reorg (7 days)	blocks
`chain.reorg_events`	Recent reorgs	table
`chain.sources_agree`	Explorers agree	boolean
`chain.source_comparison`	Public services: can they still see the chain?	table
`chain.confirmations`	Confirmed by other sources	table
`chain.confirmed_share`	Share of confirming answers	percent
`chain.competing_tips`	Competing chains (now)	count
`chain.competing_tips_15m`	Competing chains (15 minutes)	count
`chain.finality_warnings`	Finality warnings	count
`chain.fork_check`	Fork check	boolean
`chain.node_warnings`	Node warnings	count
`chain.headers_minus_blocks`	Header lag	blocks
`chain.size_on_disk`	Chain size	bytes
`mining.difficulty`	Difficulty	difficulty
`mining.rate_1d`	MatMul rate (1 day)	rate
`mining.rate_7d`	MatMul rate (7 days)	rate
`mining.top_producer_share_100`	Largest producer (100 blocks)	percent
`mining.top_producer_share_1000`	Largest producer (1,000 blocks)	percent
`mining.top_producer_100`	Name of the largest producer (100 blocks)	text
`mining.top_producer_pool_100`	Largest producer is a pool (100 blocks)	boolean
`mining.top_producer_miners_100`	Miners of the largest pool (100 blocks)	count
`mining.top_producer_1000`	Name of the largest producer (1,000 blocks)	text
`mining.top_producer_miners_1000`	Miners of the largest pool (1,000 blocks)	count
`mining.top_producer_pool_1000`	Largest producer is a pool (1,000 blocks)	boolean
`mining.distinct_producers_1000`	Distinct producers (1,000 blocks)	count
`mining.nakamoto_1000`	Nakamoto coefficient (1,000 blocks)	count
`mining.producer_table`	Block producers	table
`attest.active_signers_100`	Active signers (100 blocks)	count
`attest.signer_table`	Signers	table
`attest.named_signers_active`	Active signers with known operator	count
`attest.own_mirror_quorum`	Own mirror quorum	boolean
`attest.pinned_signers`	Signer keys pinned by our node	count
`attest.pinned_active`	Pinned signers that sign	count
`attest.pin_threshold`	Signatures our node needs	count
`attest.unsigned_recent`	Blocks without quorum (100 blocks)	count
`net.own_peers`	Peers of our node	count
`net.own_peers_synced`	Synced peers	count
`net.reachable_nodes`	Reachable nodes	count
`net.versions`	Software versions	table
`net.full_history_claimed`	Nodes advertising full history	count
`net.full_history_verified`	Verified full-history nodes	count
`net.full_history_at_tip`	Full history and at tip	count
`net.stranded_nodes`	Stranded nodes	count
`net.outdated_nodes`	Outdated nodes	count
`net.peers_far_behind`	Stuck peers seen by our archives	count
`net.stuck_peers`	Where stuck peers stand	table
`net.peer_versions`	Versions of our peers	table
`net.archive_list`	Public archives	table
`net.snapshot_height`	Latest signed datadir snapshot	blocks
`net.snapshot_age`	Age of the latest snapshot	seconds
`econ.supply_mined`	Issued so far (actual block rewards)	btx
`econ.utxo_total`	UTXO set (own node)	btx
`econ.utxo_height`	UTXO set at block	blocks
`econ.supply_other`	Other allocations	btx
`econ.supply_pct_max`	Share of maximum supply	percent
`econ.block_reward`	Block reward	btx
`econ.halving_countdown`	Next halving	blocks
`econ.tx_24h`	Transactions (24 h)	count
`econ.fees_24h`	Fees (24 h)	btx
`econ.mempool`	Mempool	count
`sw.latest_release`	Latest release	version
`sw.own_version`	Our node version	version
`sw.adoption_latest`	Adoption of latest release	percent
`sw.adoption_peers`	Latest release among our peers	percent
`sw.client_expiry`	Client expiry	days
`sw.upcoming_activation`	Upcoming activations	table
`meta.generated_at`	Data generated at	timestamp
`meta.node_synced`	Our node in sync	boolean
`meta.event_log`	Event log	table
`meta.source_status`	Data sources	table
`meta.archive_nodes`	Our archive nodes	table
`meta.archive_nodes_ok`	All archive nodes healthy	boolean
`meta.version`	Monitoring version	version
`meta.exporter_age`	Age of node data	seconds