Trigger Order

Trigger Order

A trigger order is an order type where the system automatically places an order when the market price reaches a preset trigger price.

Rate limit: 1 request per second

Request URL

POST /deepcoin/trade/triggerOrder

Request Parameters

Field	Required	Type	Description
instId	Yes	string	Product ID
productGroup	Yes	string	Trading type Spot: Spot Perpetual: Swap
sz	Yes	string	Order quantity
side	Yes	string	Order side Buy: buy Sell: sell
posSide	No	string	Position side Required when product type is SWAP Long: long Short: short
price	No	string	Limit order price Required for limit orders, not needed for market orders
isCrossMargin	Yes	string	Cross margin mode Isolated: 0 Cross: 1
orderType	Yes	string	Order price type Limit: limit Market: market
triggerPrice	Yes	string	Trigger price The order will be triggered when the market price reaches this price
mrgPosition	No	string	Merge position Required when product type is SWAP Merge: merge Split: split
tdMode	Yes	string	Trading mode Non-margin: cash Cross margin: cross Isolated margin: isolated

Request Examples

// Scenario 1: Cross margin merge position, open position trigger market order
triggerOrder = &triggerOrderRequest{
    InstId:        "BTC-USDT-SWAP",
    ProductGroup:  "Swap",
    Sz:            "1",
    Side:          "buy",
    PosSide:       "long",
    IsCrossMargin: "1",
    OrderType:     "market", // Market order
    TriggerPrice:  "150000",
    MrgPosition:   "merge",
    TdMode:        "cross",
}

// Scenario 2: Cross margin merge position, open position trigger limit order
triggerOrder = &triggerOrderRequest{
    InstId:        "BTC-USDT-SWAP",
    ProductGroup:  "Swap",
    Sz:            "1",
    Side:          "buy",
    PosSide:       "long",
    Price:         "140000",
    IsCrossMargin: "1",
    OrderType:     "limit", // Limit order
    TriggerPrice:  "150000",
    MrgPosition:   "merge",
    TdMode:        "cross",
}

// Scenario 3: Cross margin split position, open position trigger market order
triggerOrder = &triggerOrderRequest{
    InstId:        "BTC-USDT-SWAP",
    ProductGroup:  "Swap",
    Sz:            "1",
    Side:          "buy",
    PosSide:       "long",
    IsCrossMargin: "1",
    OrderType:     "market", // Market order
    TriggerPrice:  "150000",
    MrgPosition:   "split",
    TdMode:        "cross",
}

// Scenario 4: Cross margin split position, open position trigger limit order
triggerOrder = &triggerOrderRequest{
    InstId:        "BTC-USDT-SWAP",
    ProductGroup:  "Swap",
    Sz:            "1",
    Side:          "buy",
    PosSide:       "long",
    Price:         "140000",
    IsCrossMargin: "1",
    OrderType:     "limit", // Limit order
    TriggerPrice:  "150000",
    MrgPosition:   "split",
    TdMode:        "cross",
}

// Scenario 5: Isolated margin merge position, open position trigger market order
triggerOrder = &triggerOrderRequest{
    InstId:        "BTC-USDT-SWAP",
    ProductGroup:  "Swap",
    Sz:            "1",
    Side:          "buy",
    PosSide:       "long",
    IsCrossMargin: "0",
    OrderType:     "market", // Market order
    TriggerPrice:  "150000",
    MrgPosition:   "merge",
    TdMode:        "isolated",
}

// Scenario 6: Isolated margin merge position, open position trigger limit order
triggerOrder = &triggerOrderRequest{
    InstId:        "BTC-USDT-SWAP",
    ProductGroup:  "Swap",
    Sz:            "1",
    Side:          "buy",
    PosSide:       "long",
    Price:         "140000",
    IsCrossMargin: "0",
    OrderType:     "limit", // Limit order
    TriggerPrice:  "150000",
    MrgPosition:   "merge",
    TdMode:        "isolated",
}

// Scenario 7: Isolated margin split position, open position trigger market order
triggerOrder = &triggerOrderRequest{
    InstId:        "BTC-USDT-SWAP",
    ProductGroup:  "Swap",
    Sz:            "1",
    Side:          "buy",
    PosSide:       "long",
    IsCrossMargin: "0",
    OrderType:     "market", // Market order
    TriggerPrice:  "150000",
    MrgPosition:   "split",
    TdMode:        "isolated",
}

// Scenario 8: Isolated margin split position, open position trigger limit order
triggerOrder = &triggerOrderRequest{
    InstId:        "BTC-USDT-SWAP",
    ProductGroup:  "Swap",
    Sz:            "1",
    Side:          "buy",
    PosSide:       "long",
    Price:         "140000",
    IsCrossMargin: "0",
    OrderType:     "limit", // Limit order
    TriggerPrice:  "150000",
    MrgPosition:   "split",
    TdMode:        "isolated",
}

Response Parameters

Field	Type	Description
ordId	string	Order ID
clOrdId	string	Client-defined order ID
tag	string	Order tag
sCode	string	Event execution result status code 0: Success
sMsg	string	Message when event execution fails

Response Example

{
  "code": "0",
  "msg": "",
  "data": {
    "ordId": "1000595855275418",
    "clOrdId": "",
    "tag": "",
    "sCode": "0",
    "sMsg": "Success"
  }
}