# Margin Coins Channel

### Description

Push changes to margin coin information. This channel pushes when a margin coin's status is enabled/disabled, or when its discount rate tiers change. A full snapshot of the current margin coin information is pushed immediately after a successful subscription.

<div className="api-aligning">

```json title="Request Example"
{
    "op": "subscribe",
    "args": [
        {
            "instType": "uta",
            "topic": "margin-coins",
            "coin": "BTC"
        }
    ]
}
```

### Request Parameters

| Parameters    | Type               | Required | Description                                         |
|---------------|--------------------|----------|------------------------------------------------------|
| op            | String             | Yes      | Operation <br/> `subscribe` Subscribe <br/> `unsubscribe` Unsubscribe |
| args          | List&lt;Object&gt; | Yes      | Subscribed channel                                  |
| &gt; instType | String             | Yes      | Product type<br/>`uta` Unified Trading Account       |
| &gt; topic    | String             | Yes      | Topic <br/> `margin-coins` Margin coins channel       |
| &gt; coin     | String             | Yes      | Coin name <br/> e.g. `BTC`                           |

</div>

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

<div className="api-aligning">

```json title="Response Example"
{
  "event": "subscribe",
  "arg": {
    "instType": "uta",
    "topic": "margin-coins",
    "coin": "BTC"
  },
  "connId": "xxxxxxxxxx"
}
```

### Response Parameters

| Parameters    | Type   | Description                                      |
|---------------|--------|----------------------------------------------------|
| event         | String | Event                                            |
| arg           | Object | Subscribed channel                               |
| &gt; instType | String | Product type<br/>`uta` Unified Trading Account   |
| &gt; topic    | String | Topic <br/> `margin-coins` Margin coins channel   |
| &gt; coin     | String | Coin name <br/> e.g. `BTC`                       |
| code          | String | Error code                                        |
| msg           | String | Error message                                    |
| connId        | String | Connection ID                                     |

</div>

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

<div className="api-aligning">

```json title="Push Data"
{
  "data": [
    {
      "coin": "BTC",
      "list": [
        {
          "marginCoin": "BTC",
          "discountRateList": [
            {
              "tierStartValue": "0",
              "discountRate": "0.9"
            },
            {
              "tierStartValue": "10000",
              "discountRate": "0.8"
            }
          ],
          "status": "enabled"
        }
      ]
    }
  ],
  "arg": {
    "instType": "uta",
    "topic": "margin-coins",
    "coin": "BTC"
  },
  "action": "snapshot",
  "ts": 1736371332162
}
```

### Push Parameters

| Parameters    | Parameter Type     | Description                                                               |
|---------------|--------------------|-----------------------------------------------------------------------------|
| arg           | Object             | Subscribed successful channel                                              |
| &gt; instType | String             | Product type<br/>`uta` Unified Trading Account                             |
| &gt; topic    | String             | Topic <br/> `margin-coins` Margin coins channel                             |
| &gt; coin     | String             | Coin name <br/> e.g. `BTC`                                                 |
| action        | String             | Data push action <br/> `snapshot` Full data <br/> `update` Incremental data |
| data          | List&lt;Object&gt; | Subscribed data                                                             |
| &gt; coin     | String             | Coin name                                                                   |
| &gt; list     | List&lt;Object&gt; | List                                                                        |
| &gt;&gt; marginCoin | String        | Margin coin                                                                 |
| &gt;&gt; discountRateList | List&lt;Object&gt; | Discount rate list                                                   |
| &gt;&gt;&gt; tierStartValue | String | Tier start value <br/> e.g. `[0, 10000 U)`: `tierStartValue=0` <br/> `[10000 U, 20000 U)`: `tierStartValue=10000` <br/> `[20000 U, ∞)`: `tierStartValue=20000` |
| &gt;&gt;&gt; discountRate | String | Discount rate <br/> Returned as a decimal, e.g. `0.9` represents 90% |
| &gt;&gt; status | String           | Margin coin status <br/> `enabled` Enabled <br/> `disabled` Disabled      |

</div>