api to retrieve leverage maintenance margin ratio and collateral rate (#28)

Author: maxkaneco

v2/account_service.go

@@ -220,3 +220,29 @@ type APIKeyPermission struct {
 	EnableSpotAndMarginTrading     bool   `json:"enableSpotAndMarginTrading"`
 	TradingAuthorityExpirationTime uint64 `json:"tradingAuthorityExpirationTime"`
 }
+
+// GetCollateralRateService get collateral rates for coins
+type GetCollateralRateService struct {
+	c *Client
+}
+
+// Do send request
+func (s *GetCollateralRateService) Do(ctx context.Context, opts ...RequestOption) ([]*CollateralRate, error) {
+	r := &request{
+		method:   http.MethodGet,
+		endpoint: "/sapi/v1/portfolio/collateralRate",
+		secType:  secTypeSigned,
+	}
+	data, err := s.c.callAPI(ctx, r, opts...)
+	if err != nil {
+		return nil, err
+	}
+
+	res := make([]*CollateralRate, 0)
+	return res, json.Unmarshal(data, &res)
+}
+
+type CollateralRate struct {
+	Asset string `json:"asset"`
+	Rate  string `json:"collateralRate"`
+}

v2/client.go

@@ -1046,3 +1046,7 @@ func (c *Client) NewSubAccountFuturesTransferV1Service() *SubAccountFuturesTrans
 func (c *Client) NewGetEarnAccountSerice() *GetEarnAccountService {
 	return &GetEarnAccountService{c: c}
 }
+
+func (c *Client) NewGetCollateralRateService() *GetCollateralRateService {
+	return &GetCollateralRateService{c: c}
+}

v2/portfolio/account_service.go

@@ -74,7 +74,7 @@ func (s *GetBalanceService) Do(ctx context.Context, opts ...RequestOption) ([]*B
 	}
 	data, err := s.c.callAPI(ctx, r, opts...)
 	if err != nil {
-		return []*Balance{}, err
+		return nil, err
 	}
 
 	res := make([]*Balance, 0)
@@ -97,3 +97,71 @@ type Balance struct {
 	NegativeBalance     string `json:"negativeBalance"`
 	UpdateTime          int64  `json:"updateTime"`
 }
+
+type GetLeverageBracketServiceCM struct {
+	c      *Client
+	symbol *string
+}
+
+func (s *GetLeverageBracketServiceCM) Do(ctx context.Context, opts ...RequestOption) ([]*LeverageBrackets, error) {
+	r := &request{
+		method:   http.MethodGet,
+		endpoint: "/papi/v1/cm/leverageBracket",
+		secType:  secTypeSigned,
+	}
+	if s.symbol != nil {
+		r.setParam("symbol", *s.symbol)
+	}
+	data, err := s.c.callAPI(ctx, r, opts...)
+	if err != nil {
+		return nil, err
+	}
+
+	res := make([]*LeverageBrackets, 0)
+	return res, json.Unmarshal(data, &res)
+}
+
+func (s *GetLeverageBracketServiceCM) Symbol(symbol string) *GetLeverageBracketServiceCM {
+	s.symbol = &symbol
+	return s
+}
+
+type GetLeverageBracketServiceUM struct {
+	c      *Client
+	symbol *string
+}
+
+func (s *GetLeverageBracketServiceUM) Do(ctx context.Context, opts ...RequestOption) ([]*LeverageBrackets, error) {
+	r := &request{
+		method:   http.MethodGet,
+		endpoint: "/papi/v1/um/leverageBracket",
+		secType:  secTypeSigned,
+	}
+	if s.symbol != nil {
+		r.setParam("symbol", *s.symbol)
+	}
+	data, err := s.c.callAPI(ctx, r, opts...)
+	if err != nil {
+		return nil, err
+	}
+
+	res := make([]*LeverageBrackets, 0)
+	return res, json.Unmarshal(data, &res)
+}
+
+func (s *GetLeverageBracketServiceUM) Symbol(symbol string) *GetLeverageBracketServiceUM {
+	s.symbol = &symbol
+	return s
+}
+
+type LeverageBrackets struct {
+	Symbol   string `json:"symbol"`
+	Brackets []struct {
+		Bracket                int     `json:"bracket"`
+		NotionalFloor          float64 `json:"notionalFloor"`
+		NotionalCap            float64 `json:"notionalCap"`
+		QtyFloor               float64 `json:"qtyFloor"`
+		QtyCap                 float64 `json:"qtyCap"`
+		MaintenanceMarginRatio float64 `json:"maintMarginRatio"`
+	} `json:"brackets"`
+}

v2/portfolio/client.go

@@ -390,3 +390,15 @@ func (c *Client) NewGetAccountService() *GetAccountService {
 func (c *Client) NewGetBalanceService() *GetBalanceService {
 	return &GetBalanceService{c: c}
 }
+
+func (c *Client) NewGetLeverageBracketServiceCM() *GetLeverageBracketServiceCM {
+	return &GetLeverageBracketServiceCM{
+		c: c,
+	}
+}
+
+func (c *Client) NewGetLeverageBracketServiceUM() *GetLeverageBracketServiceUM {
+	return &GetLeverageBracketServiceUM{
+		c: c,
+	}
+}