Gas and network tracker example

All requests on this page target the Whitechain Sepolia explorer at https://explorer.testnet.whitechain.io (chain id 1874). The API is public, read-only, and needs no API key. This dashboard reads chain-wide metrics, so it takes no address input.

Every request below has a Run this request button. It sends that exact request from your browser to Whitechain Sepolia and prints the live response, so you can compare it with the sample response above it. The requests are read-only GET calls with no key and no wallet connection.

What you can build

A network tracker reads two Blockscout API surfaces to show:

Slow, average, and fast gas tiers in Gwei.
Coin price in USD and BTC, and circulating supply.
Transaction fees for the most recent completed day.
Chain counters: total transactions, addresses, average block time, and a live chain head.

API surfaces and base URLs

Surface	Base URL	Use it for
RPC API (Etherscan-compatible)	`https://explorer.testnet.whitechain.io/api?module=…&action=…`	Coin price, supply, daily fees, and the chain head.
REST API v2	`https://explorer.testnet.whitechain.io/api/v2`	The gas tiers and the aggregate network counters.

The Etherscan-compatible module set is account, block, contract, logs, stats, token, and transaction. It has no gas-oracle action, so the gas tiers come from REST v2 /stats, which is the canonical source for them. A client written against the Etherscan API works against the RPC surface unchanged.

Endpoint map

Task	Interface	Request
Coin price (USD, BTC)	RPC API	`GET /api?module=stats&action=coinprice`
Circulating supply	RPC API	`GET /api?module=stats&action=coinsupply`
Daily transaction fees	RPC API	`GET /api?module=stats&action=totalfees&date=YYYY-MM-DD`
Chain head	RPC API	`GET /api?module=block&action=eth_block_number`
Slow, average, fast gas tiers	REST API	`GET /api/v2/stats` (`gas_prices`)
Transactions, addresses, block time	REST API	`GET /api/v2/stats`

Reading headline metrics with the RPC API

Send GET requests to /api and select the call with module and action. Most actions return a { status, message, result } envelope; eth_block_number returns a JSON-RPC envelope. Read result in both cases.

Coin price

Request

curl "https://explorer.testnet.whitechain.io/api?module=stats&action=coinprice" \
  -H "accept: application/json"

Response

{
  "status": "1",
  "message": "OK",
  "result": {
    "coin_usd": "57.38",
    "coin_btc": "0.00087178",
    "coin_usd_timestamp": "1784713251",
    "coin_btc_timestamp": "1784713251"
  }
}

Read coin_usd and coin_btc for the price cards. The timestamps are Unix seconds marking when each price was set.

Circulating supply

Request

curl "https://explorer.testnet.whitechain.io/api?module=stats&action=coinsupply" \
  -H "accept: application/json"

Response

{ "status": "1", "message": "OK", "result": "116244402085899461811944309200000000000000000000000000000000" }

result is the circulating supply in wei as a string. Divide by 10^18 for WBT, and use big-integer or decimal math because the value overflows a JavaScript number.

Daily transaction fees

Request

curl "https://explorer.testnet.whitechain.io/api?module=stats&action=totalfees&date=2026-07-21" \
  -H "accept: application/json"

Response

{ "status": "1", "message": "OK", "result": "129648734562000000" }

result is the total fees paid that day, in wei. Here 129648734562000000 is about 0.1296 WBT.

totalfees is aggregated per completed day, so the current day reads 0 until it closes. Query the previous completed day for a real value.

Chain head

Poll this on a short interval for a live block-height indicator.

Request

curl "https://explorer.testnet.whitechain.io/api?module=block&action=eth_block_number" \
  -H "accept: application/json"

Response

{ "jsonrpc": "2.0", "id": 1, "result": "0x2f915e" }

result is a hex quantity. 0x2f915e is block 3117406. Note this call returns a JSON-RPC envelope, not the { status, message, result } shape the other RPC actions use.

Reading gas tiers and counters with REST v2

One request to /api/v2/stats covers the gas tiers and the network counters.

Request

curl "https://explorer.testnet.whitechain.io/api/v2/stats" \
  -H "accept: application/json"

Response (trimmed)

{
  "gas_prices": { "slow": 4.38, "average": 4.38, "fast": 4.38 },
  "gas_prices_update_in": 15173,
  "average_block_time": 1000,
  "total_blocks": "3110938",
  "total_transactions": "3594744",
  "total_addresses": "69677",
  "transactions_today": "86581",
  "network_utilization_percentage": 0.1178324,
  "gas_used_today": "4098201458",
  "coin_price": "57.38"
}

Field	Meaning	How to use it
`gas_prices.slow` / `.average` / `.fast`	Suggested gas prices in Gwei	Populate the three tier cards. Tiers can be equal on a quiet chain, as here (all 4.38).
`gas_prices_update_in`	Milliseconds until the next tier refresh	Time your own refresh to match.
`average_block_time`	Mean block time in milliseconds	Here 1000, so one block per second.
`total_blocks` / `total_transactions` / `total_addresses`	Chain totals as strings	Parse before formatting.
`network_utilization_percentage`	Recent utilization, 0 to 1	Multiply by 100 for a percentage.

Errors

An RPC action that fails returns status "0" with a message describing the problem, while result is empty; check status before trusting result. An empty result set (for example, a day with no fees) is not an error. REST v2 returns HTTP 422 with an errors array for a malformed request, where each entry carries a title, a source.pointer naming the bad field, and a detail string.

Refresh cadence

The metrics change at different rates, so refresh them on separate timers. Poll eth_block_number about once per second for a live head. Refetch the price, supply, fees, and /api/v2/stats together on a slower timer, for example every 15 seconds, which also lines up with gas_prices_update_in.

Wallet

Dapps

Deploy

Bridge

Block Explorer

Ecosystem

Gas and network tracker example

What you can build

API surfaces and base URLs

Endpoint map

Reading headline metrics with the RPC API

Coin price

Circulating supply

Daily transaction fees

Chain head

Reading gas tiers and counters with REST v2

Errors

Refresh cadence

​What you can build

​API surfaces and base URLs

​Endpoint map

​Reading headline metrics with the RPC API

​Coin price

​Circulating supply

​Daily transaction fees

​Chain head

​Reading gas tiers and counters with REST v2

​Errors

​Refresh cadence

​Related

What you can build

API surfaces and base URLs

Endpoint map

Reading headline metrics with the RPC API

Coin price

Circulating supply

Daily transaction fees

Chain head

Reading gas tiers and counters with REST v2

Errors

Refresh cadence

Related