Block

?module=block

https://instance_base_url/api?module=block

Get block reward by block number

getblockreward

Returns the block reward and 'uncle' block rewards when applicable.

Example:

https://instance_base_url/api
   ?module=block
   &action=getblockreward
   &blockno={blockNumber}

Request Param

ParameterDescription

blockno

integer block number to check block rewards for eg. 2165403

Example Result

{
  "message": "OK",
  "result": {
    "blockMiner": "0x13a06d3dfe21e0db5c016c03ea7d2509f7f8d1e3",
    "blockNumber": "2165403",
    "blockReward": "5314181600000000000",
    "timeStamp": "1472533979",
    "uncleInclusionReward": null,
    "uncles": null
  },
  "status": "1"
}

Get estimated block countdown time by block number

getblockcountdown

Returns the estimated time remaining, in seconds, until a certain block is included in blockchain.

Example:

https://instance_base_url/api
   ?module=block
   &action=getblockcountdown
   &blockno={blockNumber}

Request Param

ParameterDescription

blockno

integer block number to check block rewards for eg. 2165403

Example Result

{
  "message": "OK",
  "result": {
    "CurrentBlock": "115334213",
    "CountdownBlock": "116015880",
    "RemainingBlock": "681667",
    "EstimateTimeInSec": "1363349.0"
  },
  "status": "1"
}

Get block number by time stamp

getblocknobytime

Returns the block number created closest to a provided timestamp.

Example:

https://instance_base_url/api
   ?module=block
   &action=getblocknobytime
   &timestamp={blockTimestamp}
   &closest={before/after}

Request Param

ParameterDescription

timestamp

integer representing the Unix timestamp in seconds.

closest

closest block to the provided timestamp, either before or after.

Note: How to convert date/time to a Unix timestamp.

Example Result

{
  "message": "OK",
  "result": {
    "blockNumber": "2165403"
  },
  "status": "1"
}

Get the latest block number

eth_block_number

Mimics StarTower JSON RPC's eth_blockNumber.

Example:

https://instance_base_url/api
   ?module=block
   &action=eth_block_number

Request Param

ParameterDescription

id

optional nonnegative integer that represents the json rpc request id.

More on json rpc request id.

Example Result

{
  "jsonrpc": "2.0",
  "result": "0x103538a",
  "id": 1
}