# Equity Channel

### Description

Subscribe equity channel

Data will be pushed when the following events occurred:

1. Transfer balance to Futures account
2. Trading voucher deposit
3. Open/close orders are filled

<div className="api-aligning">

```json title="Request Example"
{
    "op": "subscribe",
    "args": [
        {
            "instType": "USDT-FUTURES",
            "channel": "equity"
        }
    ]
}
```

### 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; instType | String             | Yes      | Product type<br/>`USDT-FUTURES` USDT-M Futures<br/>`COIN-FUTURES` Coin-M Futures<br/>`USDC-FUTURES` USDC-M Futures |
| &gt; channel  | String             | Yes      | Channel name                                                                                                       |

</div>

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

<div className="api-aligning">

```json title="Response Example"
{
  "event": "subscribe",
  "arg": {
    "instType": "USDT-FUTURES",
    "channel": "equity",
    "instId": "default"
  }
}
```

### Response Parameters

| Parameter     | Type   | Description                                                                                                        | 
|:--------------|:-------|:-------------------------------------------------------------------------------------------------------------------|
| event         | String | Yes<br/>Operation                                                                                                  |
| arg           | Object | Subscribed channels                                                                                                |
| &gt; instType | String | Product type<br/>`USDT-FUTURES` USDT-M Futures<br/>`COIN-FUTURES` Coin-M Futures<br/>`USDC-FUTURES` USDC-M Futures |
| &gt; channel  | String | Channel name                                                                                                       |
| &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": "equity",
    "instId": "default"
  },
  "data": [
    {
      "btcEquity": "0.0021",
      "usdtEquity": "13.985457617660",
      "usdtUnrealized": "0.000000000000",
      "unionTotalMargin": "100",
      "unionAvailable": "11",
      "unionMm": "11"
    }
  ],
  "ts": 1695717225146
}
```

### Push Parameters

| Parameter            | Type               | Description                                                                                                        |
|:---------------------|:-------------------|:-------------------------------------------------------------------------------------------------------------------|
| action               | String             | action, `snapshot`                                                                                                 |
| arg                  | Object             | Channel                                                                                                            |
| &gt; instType        | String             | Product type<br/>`USDT-FUTURES` USDT-M Futures<br/>`COIN-FUTURES` Coin-M Futures<br/>`USDC-FUTURES` USDC-M Futures |
| &gt; channel         | String             | Channel name                                                                                                       |
| &gt; instId          | String             | Product ID `default`                                                                                               |
| data                 | List&lt;Object&gt; | Subscribed data                                                                                                    |
| &gt;usdtEquity       | String             | Account equity (USDT)                                                                                              |
| &gt;btcEquity        | String             | Account equity (BTC)                                                                                               |
| &gt;usdtUnrealized   | String             | Unrealized profit and loss （USDT）                                                                                  |
| &gt;unionTotalMargin | String             | Total multi-asset margin                                                                                           |
| &gt;unionAvailable   | String             | Available balance under multi-asset margin mode                                                                    |
| &gt;unionMm          | String             | Maintenance margin under multi-asset margin mode                                                                   |

</div>