Skip to main content
GET
/
v1
/
network-stats
/
history
Retrieve historical network statistics
curl --request GET \
  --url https://relayer.xoxno.com/v1/network-stats/history
const options = {method: 'GET'};

fetch('https://relayer.xoxno.com/v1/network-stats/history', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
import requests

url = "https://relayer.xoxno.com/v1/network-stats/history"

response = requests.get(url)

print(response.text)
false
{
  "networkBlocks": [
    {
      "timestampMs": 123,
      "nonce": 123,
      "round": 123,
      "epoch": 123,
      "globalTxCount": 123,
      "notarizedTps": 123,
      "currentAps": 123,
      "shardTpsShare": {}
    }
  ],
  "shardBlocks": {},
  "nextFromMs": 123,
  "truncated": true
}
{
  "error": "fromMs must be less than or equal to toMs"
}
{
  "error": "network stats tracker is not available"
}

Query Parameters

​
fromMs
integer<int64>

Start of time range in Unix milliseconds. Defaults to 72 hours before toMs.

​
toMs
integer<int64>

End of time range in Unix milliseconds. Defaults to current server time.

​
shards
string

Comma-separated shard IDs to include (e.g., 0,1,2 or meta). Omit to include all shards.

​
limit
integer

Maximum number of frames to return. Server applies a default if omitted.

Required range: x >= 1

Response

Historical network statistics.

​
networkBlocks
object[]

Metachain-level block history entries sorted by timestamp.

​
shardBlocks
object

Per-shard block history keyed by shard ID string ("0", "1", "2").

​
nextFromMs
integer<int64> | null

Cursor value. Pass as fromMs in the next request to continue pagination. null when there are no more results.

​
truncated
boolean

true when the result set was limited by limit and more data is available.