getEpochInfo

getEpochInfo is a Solana JSON-RPC method that returns details about the epoch the cluster is currently in. Solana groups its ~400ms slots into epochs, and this call hands back the epoch number, the slotIndex (offset within the epoch) and slotsInEpoch that bound it, the global absoluteSlot, the blockHeight, and the running transactionCount for the chain that settles SOL transfers. Send it as a JSON-RPC 2.0 POST to https://solana.therpc.io/YOUR_API_KEY, optionally passing a config object with commitment or minContextSlot.

Use cases

• Render an epoch-progress bar in a dashboard from slotIndex / slotsInEpoch — useful for staking UIs like Marinade where rewards land on epoch boundaries.
• Estimate the time left in the current epoch by multiplying the remaining slots (slotsInEpoch - slotIndex) by Solana's ~400ms slot time.
• Read the current absoluteSlot and blockHeight in a single round trip instead of calling getSlot and getBlockHeight separately.

Parameters

Response

Example request

1curl https://solana.therpc.io/YOUR_API_KEY \
2  -X POST \
3  -H "Content-Type: application/json" \
4  -d '{
5  "jsonrpc": "2.0",
6  "id": 1,
7  "method": "getEpochInfo",
8  "params": [
9    {}
10  ]
11}'

Errors & troubleshooting

Common pitfalls

• slotIndex is the offset inside the current epoch, not a global position — use absoluteSlot whenever you need the chain-wide slot number.
• Every field reflects the chosen commitment: processed advances fastest but can be rolled back, while finalized is settled. Pick the level that matches how confirmed you need the numbers to be.

Supported networks

• Mainnet
• Devnet

See also

• getEpochSchedule
• getSlot
• getBlockHeight