getBlockTime RPC Method

Returns the estimated production time of a block.

Each validator reports their UTC time to the ledger on a regular interval by intermittently adding a timestamp to a Vote for a particular block. A requested block's time is calculated from the stake-weighted mean of the Vote timestamps in a set of recent blocks recorded on the ledger.

params

u64required

Block number, identified by Slot

result

available

unavailable

i64

Estimated production time, as Unix timestamp (seconds since the Unix epoch)

Request

$ curl https://api.devnet.solana.com -s -X \
>   POST -H "Content-Type: application/json" -d ' 
>   {
>     "jsonrpc": "2.0",
>     "id": 1,
>     "method": "getBlockTime",
>     "params": [
>       5
>     ]
>   }
> '

Response

{
  "jsonrpc": "2.0",
  "result": 1574721591,
  "id": 1
}