feat: added new endpoint GET /historical_fees?start_date=&end_date=&interval=

Signed-off-by: kevkevinpal <oapallikunnel@gmail.com>

Author: kevkevinpal

app/src/main/kotlin/xyz/block/augurref/api/HistoricalFeeEndpoint.kt

@@ -76,4 +76,95 @@ fun Route.configureHistoricalFeesEndpoint(mempoolCollector: MempoolCollector) {
       call.respond(response)
     }
   }
+
+  get("/historical_fees") {
+    logger.info("Received request for historical fee estimates")
+
+    // Extract params from query start_date, end_date, interval (seconds)
+    val startDateParam = call.request.queryParameters["start_date"]
+    val endDateParam = call.request.queryParameters["end_date"]
+    val intervalParam = call.request.queryParameters["interval"]
+    val interval: Int = intervalParam?.toIntOrNull() ?: 3600
+
+    if (startDateParam == null) {
+      call.respondText(
+        "start_date parameter is required",
+        status = HttpStatusCode.BadRequest,
+        contentType = ContentType.Text.Plain,
+      )
+      return@get
+    }
+
+    if (endDateParam == null) {
+      call.respondText(
+        "end_date parameter is required",
+        status = HttpStatusCode.BadRequest,
+        contentType = ContentType.Text.Plain,
+      )
+      return@get
+    }
+
+    // Validate and parse the date
+    val startDate = try {
+      startDateParam?.let { LocalDateTime.parse(it) }
+    } catch (e: DateTimeParseException) {
+      logger.warn("Invalid date format: $startDateParam")
+      call.respondText(
+        "Invalid date format. Use YYYY-MM-DDTHH:MM:SS",
+        status = HttpStatusCode.BadRequest,
+        contentType = ContentType.Text.Plain,
+      )
+      return@get
+    }
+    val endDate = try {
+      endDateParam?.let { LocalDateTime.parse(it) }
+    } catch (e: DateTimeParseException) {
+      logger.warn("Invalid date format: $endDateParam")
+      call.respondText(
+        "Invalid date format. Use YYYY-MM-DDTHH:MM:SS",
+        status = HttpStatusCode.BadRequest,
+        contentType = ContentType.Text.Plain,
+      )
+      return@get
+    }
+
+    // Fetch historical fee estimate based on date
+    val feeEstimate = if (startDate != null && endDate != null && interval != null) {
+      logger.info(
+        "Fetching historical fee estimate for start_date: $startDate to " +
+          "end_date: $endDate for intervals: $interval seconds",
+      )
+      mempoolCollector.getFeeEstimateForDateRange(startDate, endDate, interval)
+    } else {
+      logger.warn("internal error")
+      call.respondText(
+        "internal error",
+        status = HttpStatusCode.InternalServerError,
+        contentType = ContentType.Text.Plain,
+      )
+      return@get
+    }
+
+    if (feeEstimate == null) {
+      logger.warn(
+        "No historical fee estimates available for start_date $startDate to " +
+          "end_date: $endDate for interval: $interval seconds",
+      )
+      call.respondText(
+        "No historical fee estimates available for start_date $startDate to " +
+          "end_date: $endDate for interval: $interval seconds",
+        status = HttpStatusCode.ServiceUnavailable,
+        contentType = ContentType.Text.Plain,
+      )
+    } else {
+      var mutableResponse = mutableListOf<FeeEstimateResponse>()
+      logger.info("Transforming historical fee estimates for response")
+      for (estimate in feeEstimate) {
+        val response = transformFeeEstimate(estimate)
+        mutableResponse.add(response)
+      }
+      logger.debug("Returning historical fee estimates")
+      call.respond(mutableResponse)
+    }
+  }
 }

app/src/main/kotlin/xyz/block/augurref/service/MempoolCollector.kt

@@ -72,6 +72,48 @@ class MempoolCollector(
     return latestFeeEstimate.get()
   }
 
+  fun getFeeEstimateForDateRange(
+    start_date: LocalDateTime,
+    end_date: LocalDateTime,
+    interval: Int,
+  ): List<FeeEstimate>? {
+    // Ensure start_date is not after end_date
+    if (start_date.isAfter(end_date)) {
+      logger.warn("Start date is after end date")
+      return null
+    }
+
+    // Initialize result list to store fee estimates
+    val estimates = mutableListOf<FeeEstimate>()
+    var currentDate = start_date
+
+    // Iterate through the date range with the given interval
+    while (!currentDate.isAfter(end_date)) {
+      logger.debug("Processing fee estimate for $currentDate")
+      val feeEstimate = getFeeEstimateForDate(currentDate)
+
+      // If fee estimate is non-null and has estimates, merge them
+      if (feeEstimate != null && feeEstimate.estimates.isNotEmpty()) {
+        // estimates.putAll(feeEstimate.estimates as Map<Int, BlockTarget>)
+        estimates.add(feeEstimate)
+      } else {
+        logger.debug("No valid fee estimate for $currentDate")
+      }
+
+      // Increment currentDate by interval (in minutes)
+      currentDate = currentDate.plusSeconds(interval.toLong())
+    }
+
+    // Return null if no estimates were collected
+    if (estimates.isEmpty()) {
+      logger.warn("No fee estimates collected for the date range")
+      return null
+    }
+
+    // Return a FeeEstimate with the aggregated estimates
+    return estimates
+  }
+
   /**
    * Get the fee estimate for specific date
    */