> For the complete documentation index, see [llms.txt](https://ajaib.gitbook.io/ajaib-exchange-open-api/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ajaib.gitbook.io/ajaib-exchange-open-api/websocket-references/web-socket-streams/kline-candlestick.md).

# Kline / Candlestick

**Functionality:** To subscribe kline / candlestick price event stream.

**Authentication:** Required

**Stream Name:** \<symbol>@kline\_\<interval>

**Available interval**: 1m, 15m, 1h, 4h, 1d, 1w (Refer to [this](https://ajaib.gitbook.io/coin-exchange-open-api/getting-started/quickstart#time-intervals-candlestick-kline:~:text=Time%20Intervals%20\(Candlestick%20/%20Kline\))).

**Update Time:** 2000ms

Request Sample

```
{
  "method": "SUBSCRIBE|UNSUBSCRIBE",
  "params": [
    "btc_usdt@kline_1m"
  ],
  "id": 1
}
```

Response

<table><thead><tr><th width="145">Name</th><th width="210">Type</th><th>Description</th></tr></thead><tbody><tr><td>e</td><td>string</td><td>Websocket event type.</td></tr><tr><td>E</td><td>long</td><td>Timestamp</td></tr><tr><td>s</td><td>string</td><td>The trading pair symbol. Refer to <a href="https://ajaib.gitbook.io/coin-exchange-open-api/getting-started/quickstart#:~:text=Asset%20Symbols%20/%20Trading%20Pairs">this</a>.</td></tr><tr><td>k</td><td>List of KlineData</td><td>List of kline prices.</td></tr></tbody></table>

#### Response Body Object > KlineData&#x20;

<table><thead><tr><th width="193">Name</th><th width="213">Type</th><th>Description</th></tr></thead><tbody><tr><td>t</td><td>long</td><td>Start timestamp of klines.</td></tr><tr><td>T</td><td>long</td><td>End timestamp of klines</td></tr><tr><td>s</td><td>string</td><td>The trading pair symbol. Refer to <a href="https://ajaib.gitbook.io/coin-exchange-open-api/getting-started/quickstart#:~:text=Asset%20Symbols%20/%20Trading%20Pairs">this</a>.</td></tr><tr><td>i</td><td>string</td><td>Interval of kline. Refer to <a href="https://ajaib.gitbook.io/coin-exchange-open-api/getting-started/quickstart#:~:text=Time%20Intervals%20(Candlestick%20/%20Kline)">this</a>.</td></tr><tr><td>o</td><td>string</td><td>Open price of kline.</td></tr><tr><td>c</td><td>string</td><td>Close price of kline.</td></tr><tr><td>h</td><td>string</td><td>High price of kline.</td></tr><tr><td>l</td><td>string</td><td>Low price of kline.</td></tr><tr><td>v</td><td>string</td><td>Base asset volume of kline.</td></tr></tbody></table>

Response Sample

{% tabs %}
{% tab title="Success" %}

```javascript
{
  "e": "kline",
  "E": 1672515782136,
  "s": "BNB_BTC",
  "k": {
    "t": 1672515780000,
    "T": 1672515839999,
    "s": "BNB_BTC",
    "i": "1m",
    "o": "0.0010",
    "c": "0.0020",
    "h": "0.0025",
    "l": "0.0015",
    "v": "1000",
  }
}
```

{% endtab %}
{% endtabs %}
