# Trigger Order Channel

### Description

Subscribe trigger order channel

<div className="api-aligning">

```json title="Request Example"
{
    "op": "subscribe",
    "args": [
        {
            "instType": "SPOT",
            "channel": "orders-algo",
            "instId": "default"
        }
    ]
}
```

### Request Parameters

| Parameter | Type | Required | Description                              | 
| :---- | :---- | :---- |:-----------------------------------------|
| op | String | Yes | Operation, subscribe unsubscribe         |
| args | List&lt;Object&gt; | Yes | List of channels to request subscription |
| &gt; channel | String | Yes | Channel name: orders-algo                |
| &gt; instType | String | Yes | Product type<br/>`SPOT`                  |
| &gt; instId | String | No | Trading pair or default                  |

</div>

<div className="api-br-10"></div>

<div className="api-aligning">

```json title="Response Example"
{
    "event": "subscribe",
    "arg": {
        "instType": "SPOT",
        "channel": "orders-algo",
        "instId": "default"
    }
}
```

### Response Parameters

| Parameter | Type | Description               | 
| :---- | :---- |:--------------------------|
| event | String | Event                     |
| arg | Object | Subscribed channels       |
| &gt; channel | String | Channel name: orders-algo |
| &gt; instType | String | Product type<br/>`SPOT`   |
| &gt; instId | String | Product ID/default        |
| code | String | Error code                |
| msg | String | Error message             |

</div>

<div className="api-br-10"></div>

<div className="api-aligning">

```json title="Push Data"
{
    "action": "snapshot",
    "arg": {
        "instType": "USDT-FUTURES",
        "channel": "orders-algo",
        "instId": "default"
    },
    "data": [
        {
            "instId": "BTCUSDT",
            "orderId": "1",
            "clientOid": "1",
            "triggerPrice": "27000.000000000",
            "triggerType": "fill_price",
            "planType": "amount",
            "price": "27000.000000000",
            "size": "0.020000000",
            "actualSize": "0.000000000",
            "orderType": "market",
            "side": "buy",
            "status": "live",
            "executePrice": "0.1",
            "enterPointSource": "web",
            "cTime": "1695719197612",
            "uTime": "1695719197612",
            "stpMode": "cancel_taker"
        }
    ],
    "ts": 1695719197733
}
```

### Push Parameters

| Parameter             | Type | Description                                                                                                                                                                                                                                                     | 
|:----------------------| :---- |:----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| action                | String | Push action                                                                                                                                                                                                                                                     |
| arg                   | Object | Channels with successful subscription                                                                                                                                                                                                                           |
| &gt; channel          | String | Channel name: orders-algo                                                                                                                                                                                                                                       |
| &gt; instType         | String | Product type<br/>`SPOT`                                                                                                                                                                                                                                         |
| &gt; instId           | String | Product ID                                                                                                                                                                                                                                                      |
| data                  | List&lt;Object&gt; | Subscription data                                                                                                                                                                                                                                               |
| &gt; instId           | String | Product ID                                                                                                                                                                                                                                                      |
| &gt; orderId          | String | Bot order ID                                                                                                                                                                                                                                                    |
| &gt; clientOid        | String | Customized bot order ID                                                                                                                                                                                                                                         |
| &gt; triggerPrice     | String | Trigger price                                                                                                                                                                                                                                                   |
| &gt; triggerType      | String | Trigger type<br/>fill_price: filled price<br/>mark_price: mark price                                                                                                                                                                                            |
| &gt; planType         | String | Websocket planType, ws Trigger order type<br/>`amount`<br/>`total`                                                                                                                                                                                     |
| &gt; price            | String | Order price                                                                                                                                                                                                                                                     |
| &gt; size             | String | Original order amount in coin                                                                                                                                                                                                                                   |
| &gt; actualSize       | String | Actual number of orders in coin                                                                                                                                                                                                                                 |
| &gt; orderType        | String | Order type<br/>limit: limit order<br/>market                                                                                                                                                                                                                    |
| &gt; side             | String | Order direction,                                                                                                                                                                                                                                                |
| &gt; status           | String | Order status                                                                                                                                                                                                                                                    |
| &gt; executePrice | String | Execute price                                                                                                                                                                                                                                                   |
| &gt; enterPointSource | String | Order source<br/>WEB: Orders created on the website<br/>API: Orders created on API<br/>SYS: System managed orders, usually generated by forced liquidation logic<br/>ANDROID: Orders created on the Android app<br/>IOS: Orders created on the iOS app          |
| &gt; cTime            | String | Order create time, Milliseconds format of updated data timestamp Unix, e.g. 1597026383085                                                                                                                                                                       |
| &gt; uTime            | String | Order update time, Milliseconds format of updated data timestamp Unix, e.g. 1597026383085                                                                                                                                                                       |
| &gt; stpMode          | String             | STP Mode <br/> `none` not setting STP <br/> `cancel_taker` cancel taker order <br/>  `cancel_maker` cancel maker order <br/>  `cancel_both` cancel both of taker and maker orders                                                                                                                                                         |

</div>
