feat: 接入 CoinGlass 清算热力图隔离链路

internal/controller/restapi/router.go

@@ -11,11 +11,13 @@ import (
 )
 
 type Deps struct {
-	Logger        *slog.Logger
-	MarketContext *usecase.MarketContextUsecase
-	MarketQuery   *usecase.MarketQueryUsecase
-	MarketData    usecase.MarketDataProvider
-	KlineRepo     usecase.KlineRepository
+	Logger           *slog.Logger
+	MarketContext    *usecase.MarketContextUsecase
+	MarketQuery      *usecase.MarketQueryUsecase
+	CoinglassQuery   *usecase.CoinglassQueryUsecase
+	CoinglassEnabled bool
+	MarketData       usecase.MarketDataProvider
+	KlineRepo        usecase.KlineRepository
 }
 
 func Register(app *fiber.App, deps Deps) {
@@ -30,4 +32,8 @@ func Register(app *fiber.App, deps Deps) {
 		MarketData:    deps.MarketData,
 		KlineRepo:     deps.KlineRepo,
 	})
+	v1.RegisterCoinglass(api, v1.CoinglassDeps{
+		Enabled: deps.CoinglassEnabled,
+		Query:   deps.CoinglassQuery,
+	})
 }

internal/controller/restapi/v1/coinglass_routes.go

@@ -0,0 +1,50 @@
+package v1
+
+import (
+	"strconv"
+	"strings"
+
+	"github.com/gofiber/fiber/v2"
+
+	"cryptoHermes/internal/usecase"
+)
+
+type CoinglassDeps struct {
+	Enabled bool
+	Query   *usecase.CoinglassQueryUsecase
+}
+
+func RegisterCoinglass(r fiber.Router, d CoinglassDeps) {
+	g := r.Group("/coinglass")
+
+	g.Get("/liq-heatmap", func(c *fiber.Ctx) error {
+		if !d.Enabled || d.Query == nil {
+			return fiber.NewError(fiber.StatusServiceUnavailable, "service-unavailable: coinglass disabled in config")
+		}
+
+		symbol := strings.ToUpper(strings.TrimSpace(c.Query("symbol")))
+		if symbol == "" {
+			return fiber.NewError(fiber.StatusBadRequest, "symbol is required")
+		}
+
+		interval := strings.TrimSpace(c.Query("interval", "5"))
+		if interval == "" {
+			interval = "5"
+		}
+
+		limit := 288
+		if l := c.Query("limit"); l != "" {
+			v, err := strconv.Atoi(l)
+			if err != nil || v <= 0 || v > 1000 {
+				return fiber.NewError(fiber.StatusBadRequest, "limit must be between 1 and 1000")
+			}
+			limit = v
+		}
+
+		rows, err := d.Query.GetLiqHeatMap(c.UserContext(), symbol, interval, limit)
+		if err != nil {
+			return fiber.NewError(fiber.StatusInternalServerError, err.Error())
+		}
+		return c.JSON(rows)
+	})
+}