Chain

epochs.list

Epochs, newest first, with gas price and transaction counts.

Details

Endpoint: GET /v1/epochs
Credits: 1
Rate class: Light. Counts against your light requests per second.

Returns epochs newest first: epoch number, start and end time (unix seconds, end is null for the current epoch), checkpoint count, transaction count, the reference gas price in MIST, gas fees, stake rewards and the storage fund in MIST. Page back with cursor. Use it for staking and fee history.

Parameters

Name	Type	Description
limit	integer	Epochs per page, default 20.From 1 to 100.
cursor	string	Cursor from the previous page: return epochs older than this epoch number.

Request

Send your key in the x-api-key header, or leave it out to use the keyless tier.

curl

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

TypeScript

const res = await fetch("https://api.tide.ad/v1/epochs?limit=3", {
  headers: {
    "x-api-key": process.env.TIDE_API_KEY!,
  },
});
const data = await res.json();

Response

JSON

{
  "items": [
    {
      "epoch": 1301,
      "startTimestamp": 1793750744,
      "endTimestamp": null,
      "checkpoints": 77430,
      "txCount": 3412312,
      "referenceGasPrice": 100,
      "gasFeesMist": null,
      "stakeRewardsMist": null,
      "storageFundMist": "2875812506341173"
    },
    {
      "epoch": 1300,
      "startTimestamp": 1793664344,
      "endTimestamp": 1793750744,
      "checkpoints": 354117,
      "txCount": 12585600,
      "referenceGasPrice": 100,
      "gasFeesMist": "2288931895041",
      "stakeRewardsMist": "256475468233083",
      "storageFundMist": "2875702763329330"
    },
    {
      "epoch": 1299,
      "startTimestamp": 1793577944,
      "endTimestamp": 1793664344,
      "checkpoints": 356363,
      "txCount": 12573950,
      "referenceGasPrice": 100,
      "gasFeesMist": "2198486588266",
      "stakeRewardsMist": "256385024768347",
      "storageFundMist": "2875432971627645"
    }
  ],
  "cursor": "1299",
  "asOf": {
    "checkpoint": 341451606,
    "timestamp": "2026-11-04T05:19:18.307Z",
    "lagMs": 821
  }
}