Get Triggered Order History

Get Triggered Order History

Query triggered condition order history

Rate Limit: 1 request per second

Request URL

GET /deepcoin/trade/trigger-orders-history

Request Parameters

Field	Required	Type	Description
instType	Yes	string	Instrument type Spot: SPOT Swap: SWAP
instId	Yes	string	Instrument ID, e.g.BTC-USDT-SWAP
OrderType	No	string	Trigger order type Limit: limit Market: market
limit	No	integer	Number of results per request. The maximum is 100; The default is 100. Range: 1-100
ordId	No	string	Order ID

Response Parameters

Field	Type	Description
instType	string	Instrument type, e.g.SWAP
instId	string	Instrument ID, e.g.BTC-USDT-SWAP
ordId	string	Order ID
px	string	Order price
sz	string	Order size
triggerPx	string	Trigger price
triggerPxType	string	Trigger price type Last: last Index: index Mark: mark
ordType	string	Trigger order type TPSL: Take-profit/Stop-loss Conditional: Conditional order Serial: Serial order Indicator: Indicator order Complex: Complex indicator Tracking: Tracking exit Line: Line drawing order
side	string	Order side Buy: buy Sell: sell
posSide	string	Position side Long in open/close mode: long Short in open/close mode: short Net mode: net
tdMode	string	Trade mode Cross: cross Isolated: isolated Cash: cash
lever	string	Leverage
triggerTime	string	Trigger time, Unix timestamp in milliseconds format, e.g.1597026383085 Value 0 means not triggered
uTime	string	Order status update time, Unix timestamp in milliseconds format
cTime	string	Order creation time, Unix timestamp in milliseconds format
errorCode	string	Error code 0: Success 4: Invalid operation
errorMsg	string	Error message, e.g.InvalidAction:OrderType=5,CFDPriceIsNull

Response Example

{
    "code": "0",
    "msg": "",
    "data": [
        {
            "instType": "SWAP",
            "instId": "BTC-USDT-SWAP",
            "ordId": "1000595886219036",
            "px": "140000",
            "sz": "100",
            "triggerPx": "150000",
            "triggerPxType": "last",
            "ordType": "Conditional",
            "side": "buy",
            "posSide": "long",
            "tdMode": "cross",
            "lever": "11",
            "triggerTime": "0",
            "uTime": "1758026276000",
            "cTime": "1757918143",
            "errorCode": "0",
            "errorMsg": ""
        },
        {
            "instType": "SWAP",
            "instId": "BTC-USDT-SWAP",
            "ordId": "1000595882098321",
            "px": "0",
            "sz": "200",
            "triggerPx": "0",
            "triggerPxType": "last",
            "ordType": "TPSL",
            "side": "sell",
            "posSide": "long",
            "tdMode": "cross",
            "lever": "11",
            "triggerTime": "0",
            "uTime": "1758026278000",
            "cTime": "1757660515",
            "errorCode": "0",
            "errorMsg": ""
        },
        {
            "instType": "SWAP",
            "instId": "BTC-USDT-SWAP",
            "ordId": "1000594091040387",
            "px": "0",
            "sz": "0",
            "triggerPx": "80000",
            "triggerPxType": "last",
            "ordType": "TPSL",
            "side": "sell",
            "posSide": "long",
            "tdMode": "cross",
            "lever": "1",
            "triggerTime": "1751505074",
            "uTime": "1751505074000",
            "cTime": "1749695677",
            "errorCode": "4",
            "errorMsg": "InvalidAction:OrderType=5,CFDPriceIsNull"
        }
    ]
}

Notes

1. This endpoint returns triggered condition order history, including both successfully triggered and failed triggered orders
2. triggerTime of 0 indicates the order has not been triggered yet
3. errorCode of 0 means success, other values indicate failure
4. px of 0 indicates a market order, non-zero value indicates a limit order
5. Results are sorted in descending order by update time, with the most recent records first