GetEpoch - Sui

GetEpoch. Returns information about an epoch, by default the current one.

GetEpoch - sui [Value: 20CU]
Returns information about an epoch: checkpoint range, start and end time, reference gas price, committee and protocol config.
gRPC: sui.rpc.v2.LedgerService/GetEpoch
Use cases

Use cases

  • Read reference gas price
  • Get epoch start and end
  • Inspect validator committee
Constraints

Constraints

  • Omit epoch for current
  • Committee and system state need read_mask
  • Reference gas price is in MIST
Get started
Unlock Access to 100+ chains
Boost your app's speed and reliability with dRPC - get your access API key

Language

Request
Examples
grpcurl \
  -H "x-drpc-key: {API-KEY}" \
  -H "x-drpc-chain: sui" \
  -d '{
  "read_mask": "epoch,firstCheckpoint,lastCheckpoint,start,end,referenceGasPrice"
}' \
  grpc.drpc.live:443 \
  sui.rpc.v2.LedgerService/GetEpoch
Copy
Response
200
{
  "epoch": {
    "epoch": "1084",
    "first_checkpoint": "260097312",
    "start": "2026-03-31T17:00:04.731Z",
    "reference_gas_price": "500"
  }
}
Copy

Request params

Parametersobject
object
epochstring
Optional. The requested epoch. If omitted, the current epoch is returned.
read_maskstring
Optional. google.protobuf.FieldMask with the fields to return, as comma-separated paths. Defaults to `epoch,first_checkpoint,last_checkpoint,start,end,reference_gas_price,protocol_config.protocol_version`. Use `*` to return all fields.

Response

200
Returns information about an epoch: checkpoint range, start and end time, reference gas price, committee and protocol config.

Response params

object
epochobject
The epoch. Only fields included in `read_mask` are populated.
object
epochstring
The epoch number.
committeeobject
The validator committee governing the epoch.
system_stateobject
Snapshot of `0x3::sui_system::SystemState` at the beginning of the epoch for past epochs, or the current state for the current epoch.
first_checkpointstring
First checkpoint of the epoch.
last_checkpointstring
Last checkpoint of the epoch.
startstring
Start time of the epoch (RFC 3339).
endstring
End time of the epoch (RFC 3339).
reference_gas_pricestring
Reference gas price for the epoch, in MIST.
protocol_configobject
Protocol version and configuration.
GetCheckpointListCheckpoints