🚧

Statistics API는 현재 이더리움 메인넷만 지원됩니다.

통계 API는 테스트넷 환경 미지원 예정으로, 현재 이더리움 메인넷에 대해서만 지원됩니다.

Overview

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

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

Usecases

• GETlistAvailableStats
  • 현재 사용가능한 모든 통계 인터페이스 path 목록을 조회합니다.
• GETgetDailyTransactionStats
  • 특정 프로토콜-네트워크에서 발생한 일일 트랜잭션 수 통계를 조회합니다.
• GETgetHourlyTransactionStats
  • 특정 프로토콜-네트워크에서 발생한 시간별 트랜잭션 수 통계를조회합니다.
• GETgetDailyActiveAccountStats
  • 특정 프로토콜-네트워크의 일일 활성 계정 수 통계를 조회합니다.
• GETgetHourlyActiveAccountStats
  • 특정 프로토콜-네트워크의 시간별 활성 계정 수 통계를 조회합니다.
• GETgetDailyContractTransactionsStats
  • 특정 스마트 컨트랙트에 발생한 일일 트랜잭션 수 통계를 조회합니다.
• GETgetHourlyContractTransactionsStats
  • 특정 스마트 컨트랙트에 발생한 시간별 트랜잭션 수 통계를 조회합니다.
• GETgetDailyContractActiveAccountStats
  • 특정 스마트 컨트랙트에 대해 일일 활성 계정 수 통계를 조회합니다.
• GETgetHourlyContractActiveAccountStats
  • 특정 스마트 컨트랙트에 대해 시간별 활성 계정 수 통계를 조회합니다.

📘

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

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

📘

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

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