# Auction Channel

### Description

Get the product's Call Auction information. Frequency of data push: 100ms ~ 300ms

<div className="api-aligning">

```json title="Request Example"
{
    "op": "subscribe",
    "args": [
        {
            "instType": "SPOT",
            "channel": "auction",
            "instId": "BTCUSDT"
        }
    ]
}
```

### Request Parameters

| Parameter | Type | Required | Description                      | 
| :---- | :---- | :---- |:---------------------------------|
| op | String | Yes | Operation, subscribe unsubscribe |
| args | List&lt;Object&gt; | Yes | List of channels to subscribe to |
| &gt; instType | String | Yes | Product Line Type                |
| &gt; channel | String | Yes | Channel name: `auction`          |
| &gt; instId | String | Yes | Product id For example: ETHUSDT  |

</div>

<div className="api-aligning">

```json title="Response Example"
{
    "event": "subscribe",
    "arg": {
        "instType": "SPOT",
        "channel": "auction",
        "instId": "BTCUSDT"
    }
}
```
### Response Parameters

| Parameter | Type | Description                             | 
| :---- | :---- |:----------------------------------------|
| event | String | is an <br/> event,                      |
| arg | Object | No<br/>Channel to subscribe to          |
| &gt; instType | String | Is<br/>product type                     |
| &gt; channel | String | is<br/>channel name                     |
| &gt; instId | String | is<br/>product id. For example: BTCUSDT |
| 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": "SPOT",
        "channel": "auction",
        "instId": "BTCUSDT"
    },
    "data": [
        {
            "stage": "stage_1",
            "stageEndTime": "1728876900000",
            "estOpeningPrice": null,
            "matchedVolume": null,
            "auctionEndTime": "1728877500000"
        }
    ],
    "ts": 1695711090682
}
```

### Push Parameters

| Parameter            | Type | Description | 
|:---------------------| :---- | :---- |
| arg                  | Object | Successfully subscribed channel |
| &gt; instType        | String | Product Type |
| &gt; channel         | String | Channel name |
| &gt; instId          | String | Product id For example: ETHUSDT |
| action               | String | Push data action, `snapshot` or `update` |
| data                 | List&lt;Object&gt; | Subscribed data |
| &gt; stage           | String | Call Auction <br/>`pre_market` pre market<br/>`stage_1` Auction 1<br/>`stage_2` Auction 2<br/>`stage_3` Auction 3<br/>`success`  Auction success<br/>`failure` Auction failed |
| &gt; stageEndTime    | String | Current phase end time , millseconds                                                                                                                                          |
| &gt; estOpeningPrice | String | Estimated Opening Price                                                                                                                                                       |
| &gt; matchedVolume   | String | Matched Volume ,base coin                                                                                                                                                     |
| &gt;auctionEndTime       | String | Call Auction end time , millseconds                                                                                                                                           |

</div>