Statistics

Overview

통계 API는 루니버스만의 고도화된 데이터 파이프라인을 통해 수집되는 네트워크의 유용한 통계 항목들을 조회할 수 있는 API입니다. 노드에서 직접 제공하는 인터페이스만으로는 조회하기 어려운 네트워크의 활성화 지표, 특정 컨트랙트의 사용자 수 및 트랜잭션 수에 대한 지표 등을 원하는 Time Window에 대해 조회하실 수 있습니다. 현재 각 항목에 대한 일일 집계와 시간별 집계 통계를 제공합니다.

현재 제공되는 API들 외에도 유용한 통계 지표 항목들이 지속적으로 추가될 예정입니다. 통계 API가 제공하는 데이터 항목 및 Aggregation 방식에 대해서는 각 API 명세를 참조해주세요.

Usecases


📘

일일(Daily) 통계 집계 및 반영 시점에 대하여

현재 일 통계 API에서 '1일'의 기준은 UTC 기준으로, 해당 일자의 UTC 00:00:00부터 UTC 24:00:00이전까지의 데이터를 취합합니다. 일일 통계의 경우 이전 일자의 통계치 반영이 다음날 오전 00:30:00까지 지연될 수 있으므로 최신 데이터 조회 시 고려가 필요합니다.

📘

시간별(Hourly) 통계 집계 및 반영 시점에 대하여

현재 시간별 통계 API에서 시간은 UTC 기준으로, 응답의 각 항목에는 date로부터 +1시간 내의 통계치가 제공됩니다. 시간별 통계의 경우 최근 1시간의 통계치 반영이 최대 40분까지 지연될 수 있으므로 최신 데이터 조회 시 고려가 필요합니다.