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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://userguide.cryptoquant.com/ko/api/time-convention.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
