Checkpoints and network

Checkpoints, epochs, validators, SuiNS names, search and gas price estimates.

When to use it

Show the latest checkpoint and how far behind the index is.
List validators with stake and commission.
Estimate gas, including congestion on the shared objects a transaction touches.

Quickstart

Replace YOUR_API_KEY with your key from the developer portal, or drop the key header to use the keyless tier. See Quickstart.

1. Get a checkpoint

Digest, time, transaction count and gas for one checkpoint.

curl "https://api.tide.ad/v1/checkpoints/341000000" \
  -H "x-api-key: YOUR_API_KEY"

2. List epochs

Epoch boundaries, stake and reward totals.

curl "https://api.tide.ad/v1/epochs?limit=3" \
  -H "x-api-key: YOUR_API_KEY"

3. List validators

Stake, commission and APY for the active set.

curl "https://api.tide.ad/v1/validators" \
  -H "x-api-key: YOUR_API_KEY"

4. Estimate gas

The reference price, with congestion for the objects you name.

curl -X POST "https://api.tide.ad/" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "getGasPriceEstimate",
  "params": {
    "objectIds": [
      "0x0000000000000000000000000000000000000000000000000000000000000006"
    ],
    "lookbackCheckpoints": 100
  }
}'

API reference

Method	What it does	Credits
checkpoints.getGET /v1/checkpoints/:seq	One checkpoint: header, gas and its transactions.	1
epochs.listGET /v1/epochs	Epochs, newest first, with gas price and transaction counts.	1
validators.listGET /v1/validators	The active validator set with stake, voting power, APY and commission.	1
getGasPriceEstimateJSON-RPC	Gas price levels from recent transactions, optionally for given shared objects.	1
names.resolveGET /v1/names/:name	Resolve a SuiNS name to the address it points at.	1
names.reverseGET /v1/names/reverse/:address	The SuiNS names of an address.	1
searchGET /v1/search	Find coins, names, packages, collections, addresses, objects and transactions.	1

Full lists: Chain, Gas. Every method page has its parameters, credits and an example response.