> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chainstream.io/llms.txt
> Use this file to discover all available pages before exploring further.

# 캔들 (OHLC)

> 토큰 / 페어 / 풀의 다구간 OHLC — 전체 거래 스트림에서 사전 집계.

**Candles (OHLC)** 데이터 제품은 원래 [Trades](/ko/docs/data-products/trades)에서 직접 집계해야 할 바 (Open / High / Low / Close / Volume)의 사전 집계 버전입니다. 다중 구간으로 토큰 / 페어 / 풀 단위로 제공됩니다.

## 필드

| 필드                                       | 설명                      |
| :--------------------------------------- | :---------------------- |
| `open`, `high`, `low`, `close`           | USD 또는 quote 표시 (설정 가능) |
| `volumeUsd`, `volumeBase`, `volumeQuote` | 방향별 거래량                 |
| `trades`                                 | 바 내 거래 수                |
| `buyers`, `sellers`                      | 고유 주소 수                 |
| `timestamp`                              | 바 시작 시각 (UTC)           |

## 구간

`1s` / `1m` / `5m` / `15m` / `1h` / `4h` / `1d` / `1w`

## 접근

<CardGroup cols={2}>
  <Card title="REST" icon="database" href="/ko/api-reference/endpoint/data/token/v2/token-chain-tokenaddress-candles-get">
    `tokens/{address}/candles`, `pools/{address}/candles`.
  </Card>

  <Card title="WebSocket" icon="bolt" href="/ko/api-reference/endpoint/websocket/api">
    `dex-candle:{chain}_{tokenAddress}_{resolution}`(USD) 및 `dex-candle-in-native:...`(네이티브 통화). SDK: `client.stream.subscribeTokenCandles({ chain, tokenAddress, resolution, callback })`.
  </Card>

  <Card title="GraphQL" icon="diagram-project" href="/ko/graphql/getting-started/overview">
    메타데이터와 함께 조회.
  </Card>

  <Card title="SDK" icon="box" href="/ko/sdks/overview">
    `client.token.getCandles(chain, tokenAddress, { resolution })`는 타입이 부여된 배열을 반환합니다.
  </Card>
</CardGroup>

## 다음 단계

<CardGroup cols={2}>
  <Card title="Trades" icon="right-left" href="/ko/docs/data-products/trades">
    틱 단위가 필요한 경우.
  </Card>

  <Card title="DEX Pools" icon="droplet" href="/ko/docs/data-products/dex-pools">
    풀 단위 OHLC.
  </Card>
</CardGroup>