Skip to main content
Global UTXO index statistics
curl --request GET \
  --url http://localhost:3001/v1/stats
{
  "total_utxos": 150000,
  "latest_absolute_index": 149999
}
Use this endpoint to get a quick snapshot before deciding which tree and index range to scan. Response encoding is always application/x-protobuf — content negotiation is not supported for this endpoint.

Response

Statistics retrieved successfully.

Protobuf StatsResponse message returned by GET /v1/stats.

Aggregate statistics for the UTXO index. The latest_absolute_index field is absent in the Protobuf encoding when the store is empty (optional field).

​
total_utxos
integer<int64>
required

Total number of UTXO records indexed across all Merkle trees.

Example:

150000

​
latest_absolute_index
integer<int64> | null

The highest absolute insertion index seen by the indexer, or absent when the store is empty. Computed as tree_index * MAX_LEAVES_PER_TREE + insertion_index where MAX_LEAVES_PER_TREE = 1,048,576.

Example:

149999