# 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).                                                                                                     |