Time Convention

For all metrics, window parameter is used to specify the time intervals for which the data is aggregated. Windows are provided in window=min, window=day and window=block, and each metric supports different windows. For on-chain data, the smallest period available is block. Daily units are provided for added versatility. We use two parameters from and to to specify the start and end time for which data will be gathered. Generally, it can be formatted as YYYYMMDDTHHMMSS (e.g. from = 20191003T220000) for all windows, and additional formats are supported for each window type.

Please note that end-of-day data of exchange/miner/inter-entity flow will be ready to serve from UTC 00:00 AM that may take up to an hour. Since block confirmation takes time due to the nature of the blockchain, blocks created before 00:00 AM are reflected in the calculation sequentially. The block confirmation time varies from time to time, so the safe time to query the endpoint for a full day would be an hour after the day. (i.e., UTC 1:00AM) Note that Top 10 data will return null until the block confirmation is complete.

Window	Description	from, to parameter format
block	Data representing a specific block.	Datetime(YYYYMMDDTHHMMSS) or block height(e.g. 550000). If datetime is used, data for blocks corresponding to that time period will be returned.
min	Currently, window=min is supported for market data only. For time 18:12:00, it represents data from 18:12:00 UTC to 18:12:59 UTC.	Datetime(YYMMDDTHHMMSS).
hour	Data calculated for all blocks produced in an hour. An hourly data is from 12:00:00 UTC to 12:59:00 UTC.	Datetime(YYYYMMDDTHHMMSS).
day	Data calculated for all blocks produced in a day. Each day begins at 00:00:00 UTC and end at 23:59:59 UTC.	Datetime(YYYYMMDDTHHMMSS) or date(YYYYMMDD).