TRtrueblocks
Chain Data

Get block dates

Changed on

Find block(s) based on date, blockNum, timestamp, or 'special'. Corresponds to the <a href="/chifra/chaindata/#chifra-when">chifra when</a> command line.

get/when

Request

  • Base URL
    http://localhost:8080
  • Auth
    none declared

Query parameters

blocksstring[]

one or more dates, block numbers, hashes, or special named blocks (see notes)

listboolean

export a list of the 'special' blocks

timestampsboolean

display or process timestamps

countboolean

with --timestamps only, returns the number of timestamps in the cache

repairboolean

with --timestamps only, repairs block(s) in the block range by re-querying from the chain

checkboolean

with --timestamps only, checks the validity of the timestamp data

updateboolean

with --timestamps only, bring the timestamp database forward to the latest block

deepnumber

with --timestamps --check only, verifies every N timestamp directly from the chain (slow)

chainstring

the chain to use

noHeaderboolean

suppress the header in the output

cacheboolean

force the results of the query into the cache

decacheboolean

removes related items from the cache

fmtstring

export format, one of [ txt | csv | json ]

Response

returns the requested data

Example response

{
  "blockNumber": 52029,
  "date": "2015-08-08 06:22:55 UTC",
  "name": "firstLog",
  "timestamp": 1439014975
}

Changes

  • 63aba50a45cbRevision changes
    • breaking

      for the query request parameter deep, the type changed from boolean to number, and format from no format to uint64

  • 2428f6f19a07Revision changes
    • breaking

      added to the / response property oneOf list for the response status

    • info

      removed from the / response property oneOf list for the response status