Merge pull request #63 from latesun/feature/add-more-fields

feat(go): add more fields

Author: Sinclair-Ni

go/_examples/main.go

@@ -41,31 +41,34 @@ func main() {
 
 	// create callback functions for receive messages
 	callOrder := gate.NewCallBack(func(msg *gate.UpdateMsg) {
+		if msg.Event != "update" {
+			return
+		}
 		// parse the message to struct we need
 		var order []gate.SpotOrderMsg
 		if err := json.Unmarshal(msg.Result, &order); err != nil {
-			log.Printf("order Unmarshal err:%s", err.Error())
+			log.Printf("order %s unmarshal err: %v", msg.Result, err)
 		}
-		log.Printf("%+v", order)
+		log.Printf("order: %+v", order)
 	})
 
 	callTrade := gate.NewCallBack(func(msg *gate.UpdateMsg) {
 		var trade gate.SpotTradeMsg
 		if err := json.Unmarshal(msg.Result, &trade); err != nil {
-			log.Printf("trade Unmarshal err:%s", err.Error())
+			log.Printf("trade %s unmarshal err: %v", msg.Result, err)
 		}
-		log.Printf("%+v", trade)
+		log.Printf("trade: %+v", trade)
 	})
 
 	// first, we need set callback function
 	ws.SetCallBack(gate.ChannelSpotOrder, callOrder)
 	ws.SetCallBack(gate.ChannelSpotPublicTrade, callTrade)
 	// second, after set callback function, subscribe to any channel you are interested into
-	if err := ws.Subscribe(gate.ChannelSpotPublicTrade, []string{"BTC_USDT"}); err != nil {
+	if err := ws.Subscribe(gate.ChannelSpotOrder, []string{"BTC_USDT"}); err != nil {
 		log.Printf("Subscribe err:%s", err.Error())
 		return
 	}
-	if err := ws.Subscribe(gate.ChannelSpotBookTicker, []string{"BTC_USDT"}); err != nil {
+	if err := ws.Subscribe(gate.ChannelSpotPublicTrade, []string{"BTC_USDT"}); err != nil {
 		log.Printf("Subscribe err:%s", err.Error())
 		return
 	}

go/response_future.go

@@ -29,9 +29,8 @@ type FuturesTicker struct {
 	IndexPrice string `json:"index_price,omitempty"`
 	// Exchange rate of base currency and settlement currency in Quanto contract. Not existed in contract of other types
 	QuantoBaseRate string `json:"quanto_base_rate,omitempty"`
-
-	Low24h  string `json:"low_24h"`
-	High24h string `json:"high_24h"`
+	Low24h         string `json:"low_24h"`
+	High24h        string `json:"high_24h"`
 }
 
 type FuturesTrade struct {
@@ -124,10 +123,19 @@ type FuturesOrder struct {
 	// Order finished time. Not returned if order is open
 	FinishTime   int64 `json:"finish_time,omitempty"`
 	FinishTimeMs int64 `json:"finish_time_ms,omitempty"`
-	// How the order is finished.  - filled: all filled - cancelled: manually cancelled - liquidated: cancelled because of liquidation - ioc: time in force is `IOC`, finish immediately - auto_deleveraged: finished by ADL - reduce_only: cancelled because of increasing position while `reduce-only` set
+	// FinishAs indicates how the order was completed:
+	// - filled: all filled
+	// - cancelled: manually cancelled
+	// - liquidated: cancelled due to liquidation
+	// - ioc: time in force is IOC, finished immediately
+	// - auto_deleveraged: finished by ADL
+	// - reduce_only: cancelled due to increase in position while reduce-only set
+	// - position_closed: cancelled due to position close
+	// - stp: cancelled due to self trade prevention
+	// - _new: order created
+	// - _update: order filled, partially filled, or updated
+	// - reduce_out: only reduce position, excluding pending orders hard to execute
 	FinishAs string `json:"finish_as,omitempty"`
-	// Order status  - `open`: waiting to be traded - `finished`: finished
-	Status string `json:"status,omitempty"`
 	// Futures contract
 	Contract string `json:"contract"`
 	// Order size. Specify positive number to make a bid, and negative number to ask
@@ -160,6 +168,18 @@ type FuturesOrder struct {
 
 	StopProfitPrice string `json:"stop_profit_price"`
 	StopLossPrice   string `json:"stop_loss_price"`
+	// StpId represents the ID associated with the self-trade prevention mechanism.
+	StpId int64 `json:"stp_id,omitempty"`
+	// StpAct represents the self-trade prevention (STP) action:
+	// - cn: Cancel newest (keep old orders)
+	// - co: Cancel oldest (keep new orders)
+	// - cb: Cancel both (cancel both old and new orders)
+	// If not provided, defaults to 'cn'. Requires STP group membership; otherwise, an error is returned.
+	StpAct string `json:"stp_act,omitempty"`
+	// BizInfo represents business-specific information related to the order. The exact content and format can vary depending on the use case.
+	BizInfo string `json:"biz_info,omitempty"`
+	// AmendText provides the custom data that the user remarked when amending the order
+	AmendText string `json:"amend_text,omitempty"`
 }
 
 type FuturesUserTrade struct {
@@ -177,6 +197,7 @@ type FuturesUserTrade struct {
 	Fee          float64 `json:"fee"`
 	PointFee     float64 `json:"point_fee"`
 }
+
 type FuturesLiquidate struct {
 	// Liquidation time
 	Time int64 `json:"time,omitempty"`

go/response_spot.go

@@ -14,14 +14,15 @@ type SpotBalancesMsg struct {
 }
 
 type SpotCandleUpdateMsg struct {
-	Time   string `json:"t"`
-	Volume string `json:"v"`
-	Close  string `json:"c"`
-	High   string `json:"h"`
-	Low    string `json:"l"`
-	Open   string `json:"o"`
-	Name   string `json:"n"`
-	Amount string `json:"a"`
+	Time        string `json:"t"`
+	Volume      string `json:"v"`
+	Close       string `json:"c"`
+	High        string `json:"h"`
+	Low         string `json:"l"`
+	Open        string `json:"o"`
+	Name        string `json:"n"`
+	Amount      string `json:"a"`
+	WindowClose bool   `json:"w"`
 }
 
 // SpotUpdateDepthMsg update order book
@@ -115,6 +116,8 @@ type SpotUserTradesMsg struct {
 	PointFee     string `json:"point_fee"`
 	GtFee        string `json:"gt_fee"`
 	Text         string `json:"text"`
+	AmendText    string `json:"amend_text"`
+	BizInfo      string `json:"biz_info"`
 }
 
 type SpotTradeMsg struct {
@@ -136,8 +139,6 @@ type OrderMsg struct {
 	CreateTime string `json:"create_time,omitempty"`
 	// SpotOrderMsg last modification time
 	UpdateTime string `json:"update_time,omitempty"`
-	// SpotOrderMsg status  - `open`: to be filled - `closed`: filled - `cancelled`: cancelled
-	Status string `json:"status,omitempty"`
 	// Currency pair
 	CurrencyPair string `json:"currency_pair"`
 	// SpotOrderMsg type. limit - limit order
@@ -162,6 +163,8 @@ type OrderMsg struct {
 	FillPrice string `json:"fill_price,omitempty"`
 	// Total filled in quote currency
 	FilledTotal string `json:"filled_total,omitempty"`
+	// Average fill price
+	AvgDealPrice string `json:"avg_deal_price,omitempty"`
 	// Fee deducted
 	Fee string `json:"fee,omitempty"`
 	// Fee currency unit
@@ -176,6 +179,25 @@ type OrderMsg struct {
 	RebatedFee string `json:"rebated_fee,omitempty"`
 	// Rebated fee currency unit
 	RebatedFeeCurrency string `json:"rebated_fee_currency,omitempty"`
+	// StpId represents the ID associated with the self-trade prevention mechanism.
+	StpId int64 `json:"stp_id,omitempty"`
+	// StpAct represents the self-trade prevention (STP) action:
+	// - cn: Cancel newest (keep old orders)
+	// - co: Cancel oldest (keep new orders)
+	// - cb: Cancel both (cancel both old and new orders)
+	// If not provided, defaults to 'cn'. Requires STP group membership; otherwise, an error is returned.
+	StpAct string `json:"stp_act,omitempty"`
+	// FinishAs indicates how the order was finished:
+	// - open: processing
+	// - filled: fully filled
+	// - cancelled: manually cancelled
+	// - ioc: finished immediately (IOC)
+	// - stp: cancelled due to self-trade prevention
+	FinishAs string `json:"finish_as,omitempty"`
+	// BizInfo represents business-specific information related to the order. The exact content and format can vary depending on the use case.
+	BizInfo string `json:"biz_info,omitempty"`
+	// AmendText provides the custom data that the user remarked when amending the order
+	AmendText string `json:"amend_text,omitempty"`
 }
 
 type SpotOrderMsg struct {