Overview
통계 API는 루니버스만의 고도화된 데이터 파이프라인을 통해 수집되는 네트워크의 유용한 통계 항목들을 조회할 수 있는 API입니다. 노드에서 직접 제공하는 인터페이스만으로는 조회하기 어려운 네트워크의 활성화 지표, 특정 컨트랙트의 사용자 수 및 트랜잭션 수에 대한 지표 등을 원하는 Time Window에 대해 조회하실 수 있습니다. 현재 각 항목에 대한 일일 집계와 시간별 집계 통계를 제공합니다.
현재 제공되는 API들 외에도 유용한 통계 지표 항목들이 지속적으로 추가될 예정입니다. 통계 API가 제공하는 데이터 항목 및 Aggregation 방식에 대해서는 각 API 명세를 참조해주세요.
Usecases
GETlistAvailableStats- 현재 사용가능한 모든 통계 인터페이스 path 목록을 조회합니다.
GETgetDailyTransactionStat- 특정 프로토콜-네트워크에서 발생한 일일 트랜잭션 수 통계를 조회합니다.
GETgetHourlyTransactionStat- 특정 프로토콜-네트워크에서 발생한 시간별 트랜잭션 수 통계를조회합니다.
GETgetDailyActiveAccountStat- 특정 프로토콜-네트워크의 일일 활성 계정 수 통계를 조회합니다.
GETgetHourlyActiveAccountStat- 특정 프로토콜-네트워크의 시간별 활성 계정 수 통계를 조회합니다.
GETgetDailyContractTransactionsStat- 특정 스마트 컨트랙트에 발생한 일일 트랜잭션 수 통계를 조회합니다.
GETgetHourlyContractTransactionsStat- 특정 스마트 컨트랙트에 발생한 시간별 트랜잭션 수 통계를 조회합니다.
GETgetDailyContractActiveAccountStats- 특정 스마트 컨트랙트에 대해 일일 활성 계정 수 통계를 조회합니다.
GETgetHourlyContractActiveAccuntStats- 특정 스마트 컨트랙트에 대해 시간별 활성 계정 수 통계를 조회합니다.
일일(Daily) 통계 집계 및 반영 시점에 대하여
현재 일 통계 API에서 '1일'의 기준은 UTC 기준으로, 해당 일자의 UTC 00:00:00부터 UTC 24:00:00이전까지의 데이터를 취합합니다. 일일 통계의 경우 이전 일자의 통계치 반영이 다음날 오전 00:30:00까지 지연될 수 있으므로 최신 데이터 조회 시 고려가 필요합니다.
시간별(Hourly) 통계 집계 및 반영 시점에 대하여
현재 시간별 통계 API에서 시간은 UTC 기준으로, 응답의 각 항목에는 date로부터 +1시간 내의 통계치가 제공됩니다. 시간별 통계의 경우 최근 1시간의 통계치 반영이 최대 40분까지 지연될 수 있으므로 최신 데이터 조회 시 고려가 필요합니다.