Time Convention

For all metrics, the window parameter is used to specify the time intervals for which the data is aggregated. Windows are provided in window=min, window=hour, 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.

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 supported for market data only. For time 18:12:00, it represents data from 18:12:00 UTC to 18:12:59 UTC.	Datetime (`YYYYMMDDTHHMMSS`).
`hour`	Data calculated for all blocks produced in an hour. An hourly data is from 12:00:00 UTC to 12:59:59 UTC.	Datetime (`YYYYMMDDTHHMMSS`).
`day`	Data calculated for all blocks produced in a day. Each day begins at 00:00:00 UTC and ends at 23:59:59 UTC.	Datetime (`YYYYMMDDTHHMMSS`) or date (`YYYYMMDD`).

End-of-day data of exchange/miner/inter-entity flow will be ready to serve from UTC 00:00 AM and 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, so the safe time to query the endpoint for a full day would be an hour after the day (i.e., UTC 1:00 AM). Top 10 data will return null until block confirmation is complete.

Getting Started

Concepts

AI Tools