# Market Channel

### Description

Retrieve the latest traded price, bid price, ask price and 24-hour trading volume of the instruments. When there is
a change (deal, buy, sell, issue): 300ms to 400ms.

<div className="api-aligning">

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

### 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                             |
| &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": "USDT-FUTURES",
    "channel": "ticker",
    "instId": "BTCUSDT"
  }
}
```

### Response Parameters

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

</div>

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

<div className="api-aligning">

```json title="Push Data"
{
  "data": [
    {
      "lastPr": "87673.6",
      "symbol": "BTCUSDT",
      "indexPrice": "87714.0732915359034044",
      "open24h": "87027.0",
      "nextFundingTime": "1766678400000",
      "bidPr": "87673.6",
      "change24h": "0.00743",
      "quoteVolume": "1521198076.61216",
      "deliveryPrice": "0",
      "askSz": "14.333",
      "low24h": "86542.5",
      "symbolType": "1",
      "openUtc": "87628.9",
      "instId": "BTCUSDT",
      "bidSz": "6.9129",
      "markPrice": "87673.7",
      "high24h": "88022.1",
      "askPr": "87673.7",
      "holdingAmount": "28135.5456",
      "baseVolume": "17398.1612",
      "fundingRate": "0.000055",
      "ts": "1766674540816"
    }
  ],
  "arg": {
    "instType": "USDT-FUTURES",
    "instId": "BTCUSDT",
    "channel": "ticker"
  },
  "action": "snapshot",
  "ts": 1766674540817
}
```

### Push Parameters

| Parameter           | Type   | Description                                                                                                                                                                                                         | 
|:--------------------|:-------|:--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| arg                 | Object | Channels with successful subscription                                                                                                                                                                               |
| &gt; instType       | String | Product type                                                                                                                                                                                                        |
| &gt; channel        | String | Channel name                                                                                                                                                                                                        |
| &gt; instId         | String | Product ID                                                                                                                                                                                                          |
| action              | String | Push data action, `snapshot`                                                                                                                                                                                        |
| data                | List   | Subscription data                                                                                                                                                                                                   |
| &gt; instId         | String | Product ID, BTCUSDT                                                                                                                                                                                                 |
| &gt;lastPr          | String | Latest price                                                                                                                                                                                                        |
| &gt;askPr           | String | Ask price                                                                                                                                                                                                           |
| &gt;bidPr           | String | Bid price                                                                                                                                                                                                           |
| &gt;high24h         | String | 24h high                                                                                                                                                                                                            |
| &gt;low24h          | String | 24h low                                                                                                                                                                                                             |
| &gt;change24h       | String | 24h change                                                                                                                                                                                                          |
| &gt;fundingRate     | String | Funding rate                                                                                                                                                                                                        |
| &gt;nextFundingTime | String | Next funding rate settlement time,  Milliseconds format of timestamp Unix, e.g. 1597026383085                                                                                                                       |
| &gt;ts              | String | System time, Milliseconds format of current data timestamp Unix, e.g. 1597026383085                                                                                                                                 |
| &gt;markPrice       | String | Mark price                                                                                                                                                                                                          |
| &gt;indexPrice      | String | Index price                                                                                                                                                                                                         |
| &gt;holdingAmount   | String | Open interest                                                                                                                                                                                                       |
| &gt;baseVolume      | String | Trading volume of the coin                                                                                                                                                                                          |
| &gt;quoteVolume     | String | Trading volume of quote currency                                                                                                                                                                                    |
| &gt;openUtc         | String | Price at 00:00 (UTC)                                                                                                                                                                                                |
| &gt;symbolType      | String | SymbolType: 1-&gt;perpetual 2-&gt;delivery                                                                                                                                                                          |
| &gt;symbol          | String | Trading pair                                                                                                                                                                                                        |
| &gt;deliveryPrice   | String | Delivery price of the delivery futures, when symbolType = 1(perpetual) it is always 0<br/>It will be pushed 1 hour before delivery<br/>Returns empty if delivery price does not exist                               |
| &gt;bidSz           | String | Buying amount                                                                                                                                                                                                       |
| &gt;askSz           | String | selling amount                                                                                                                                                                                                      |
| &gt;open24h         | String | Entry price of the last 24 hours, The opening time is compared on a 24-hour basis. i.e.: Now it is 7:00 PM of the 2nd day of the month, then the corresponding opening time is 7:00 PM of the 1st day of the month. |
| ts                  | String | Data streaming time                                                                                                                                                                                                 |

</div>
