# Cross-Margin Orders Channel

### Description

<div className="api-aligning">

```json title="Request Example"
{
    "args":[
        {
            "channel":"orders-crossed",
            "instId":"BTCUSDT",
            "instType":"MARGIN"
        }
    ],
    "op":"subscribe"
}
```

### Request Parameters

| Parameter | Type | Required | Description                                                         | 
| :---- | :---- | :---- |:--------------------------------------------------------------------|
| op | String | Yes | Operation<br/>`subscribe`: Subscribe<br/>`unsubscribe`: Unsubscribe |
| args | List&lt;Object&gt; | Yes | List of channels to request subscription                            |
| &gt; instType | String | Yes | Product type: MARGIN                                                |
| &gt; channel | String | Yes | Channel name                                                        |
| &gt; instId | String | Yes | Product ID<br/>e.g. ETHUSDT                                         |

</div>

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

<div className="api-aligning">

```json title="Response Example"
{
    "event":"subscribe",
    "arg":{
        "instType":"MARGIN",
        "channel":"orders-crossed",
        "instId":"BTCUSDT"
    }
}
```

### Response Parameters

| Parameter | Type | Description                        | 
| :---- | :---- |:-----------------------------------|
| event | String | Event                              |
| arg | Object | Subscribed channels                |
| &gt; instType | String | Product type: MARGIN               |
| &gt; channel | String | Channel name                       |
| &gt; instId | String | Product ID<br/>e.g. ETHUSDT        |
| code | String | Error code, returned only on error |
| msg | String | Error message                      |

</div>

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

<div className="api-aligning">

```json title="Push Data"
{
    "action":"snapshot",
    "arg":{
        "instType":"MARGIN",
        "channel":"orders-crossed",
        "instId":"BTCUSDT"
    },
    "data":[
        {
            "force":"gtc",
            "orderType":"market",
            "price":"0.000000000",
            "quoteSize":"0.000000000",
            "side":"buy",
            "feeDetail":[
                {
                    "feeCoin":"USDT",
                    "deduction":"no",
                    "totalDeductionFee":"0",
                    "totalFee":"0.01538693"
                }
            ],
            "enterPointSource":"web",
            "status":"partially_filled",
            "baseSize":"0.000000000",
            "cTime":"1695881543701",
            "uTime":"1695881543701",
            "clientOid":"2000000000",
            "fillPrice":"26426.800000000",
            "baseVolume":"0.000200000",
            "fillTotalAmount":"5.285360000",
            "loanType":"normal",
            "orderId":"1",
            "stpMode": "cancel_taker"
        }
    ],
    "ts":1695881543805
}
```

### Push Data Parameters

| Parameter | Type | Description | 
| :---- | :---- | :---- |
| arg | Object | Successful channel subscriptions |
| &gt; instType | String | Product type: MARGIN |
| &gt; channel | String | Channel name |
| &gt; instId | String | Product ID, e.g. ETHUSDT |
| action | String | Push data action, `snapshot` or `update` |
| data | List&lt;Object&gt; | Subscribed data |
| &gt; baseSize | String | Number of base coins |
| &gt; cTime | String | Creation time, Unix millisecond timestamp  |
| &gt; uTime  | String | Update time, Unix millisecond timestamp |
| &gt; clientOid | String | Client Unique Identifier |
| &gt; fillPrice | String | Sale price |
| &gt; baseVolume | String | Filled quantity |
| &gt; fillTotalAmount | String | sum of money sold |
| &gt; loanType | String | Margin order model<br/>normal: place a normal order<br/>autoLoan place an order with auto-borrow<br/>autoRepay place an order with auto-repay<br/>autoLoanAndRepay place an order with auto-borrow and auto-repay  |
| &gt; orderId | String | Order ID |
| &gt; orderType | String | Order type<br/>limit: limit order<br/>market |
| &gt; price | String | Order price |
| &gt; quoteSize | String | Number of denominated coins |
| &gt; side | String | Methods of Sale and Purchase |
| &gt; feeDetail                         | List&lt;Object&gt; | Transaction fee of the order                                                                                                                      |
| &nbsp;&nbsp;&gt;&gt; deduction         | String             | Is discount                                                                                                                       |
| &nbsp;&nbsp;&gt;&gt; totalDeductionFee | String             | Fee of discount                                                                                                                      |
| &nbsp;&nbsp;&gt;&gt; totalFee               | String             | Order transaction fee, the transaction fee charged by the platform from the user.                                                                                                                       |
| &nbsp;&nbsp;&gt;&gt; feeCoin           | String             | The currency of the transaction fee                                                                                                                      |
| &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; status | String | Order status<br/>`live`:new order;<br/>`partially_filled`:partially filled;<br/>`filled`:full filled;<br/>`cancelled`: cancelled; |
| &gt; force | String | Order Strategy |
| &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                                                                                                                                                         |
| ts | Long | Timestamp ms |

</div>
