# Public Trades Channel

### Description

To subscribe the public trades channel

During Reality market closed hours, on-exchange trade data can be obtained via this channel; during market open hours, off-exchange trade data is currently available via [Get Reality Fills](/docs/catalog/reality/market-data#get-reality-fills).

Real-time Push

<div className="api-aligning">

```json title="Request Example"
{
    "op": "subscribe",
    "args": [
        {
            "instType": "usdt-futures",
            "topic": "publicTrade",
            "symbol": "BTCUSDT"
        }
    ]
}
```

### 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/>`spot` Spot trading<br/>`usdt-futures` USDT futures <br/> `coin-futures` Coin-M futures <br/> `usdc-futures` USDC futures |
| &gt; topic       | String               | Yes      | Topic <br/> `publicTrade` Public trade                                                                                                     |
| &gt; [symbol](/docs/catalog/market/market-data#get-instruments)      | String               | Yes      | Symbol name <br/> e.g. `BTCUSDT`                                                                                                           |




</div>

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

<div className="api-aligning">

```json title="Response Example"
{
  "event": "subscribe",
  "arg": {
    "instType": "usdt-futures",
    "topic": "publicTrade",
    "symbol": "BTCUSDT"
  },
  "connId": "xxxxxxxxxx"
}
```

### Response Parameters

| Parameters    | Type   | Description                                                                                                                                |
|---------------|--------|--------------------------------------------------------------------------------------------------------------------------------------------|
| event         | String | Operation <br/> `subscribe` Subscribe <br/> `unsubscribe` Unsubscribe <br/> `error` Parameter error                                        |
| arg           | Object | Subscribed channel                                                                                                                         |
| &gt; instType | String | Product type<br/>`spot` Spot trading<br/>`usdt-futures` USDT futures <br/> `coin-futures` Coin-M futures <br/> `usdc-futures` USDC futures |
| &gt; topic    | String | Topic <br/> `publicTrade` Public trade channel                                                                                             |
| &gt; symbol   | String | Symbol name                                                                                                                                |
| 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": [
    {
      "p": "100000",
      "S": "buy",
      "T": "1736348770627",
      "v": "0.00118",
      "i": "1260903622036942849",
      "L": "1234568787787878787",
      "isRPI": "no"
    }
  ],
  "arg": {
    "instType": "usdt-futures",
    "symbol": "BTCUSDT",
    "topic": "publicTrade"
  },
  "action": "snapshot",
  "ts": 1736371104297
}
```

### Push Parameters

| Parameters    | Type               | Description                                                                                                                                |
|---------------|--------------------|--------------------------------------------------------------------------------------------------------------------------------------------|
| arg           | Object             | Subscribed channel                                                                                                                         |
| &gt; instType | String             | Product type<br/>`spot` Spot trading<br/>`usdt-futures` USDT futures <br/> `coin-futures` Coin-M futures <br/> `usdc-futures` USDC futures |
| &gt; topic    | String             | Topic <br/> `publicTrade`                                                                                                                  |
| &gt; symbol   | String             | Symbol name                                                                                                                                |
| action        | String             | Push data action <br/> `snapshot` Full data <br/> `update` Incremental data                                                                |
| data          | List&lt;Object&gt; | Subscribed data                                                                                                                            |
| &gt; i        | String             | Fill execution ID                                                                                                                          |
| &gt; L        | String             | Execution correlation ID                                                                                                                   |
| &gt; p        | String             | Fill price                                                                                                                                 |
| &gt; v        | String             | Fill size <br/>`COIN-Futures`：The unit is **quote coin** <br/>`Others`：The unit is **base coin**<br/>                                      |
| &gt; S        | String             | Fill side <br/> `sell`/`buy`                                                                                                               |
| &gt; T        | String             | Fill timestamp <br/> A Unix timestamp in milliseconds                                                                                      |
| &gt; isRPI    | String             | Whether it is an RPI fill<br/>`yes` Yes<br/>`no` No                                                                                        |






</div>