> For the complete documentation index, see [llms.txt](https://docs.origami.tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.origami.tech/reference/grid-language/functions/candles.md).

# candles()

candles() returns candlestick data for a pair and interval, from 10 seconds to 1 month.

A candlestick is a type of price chart that represents the high, low, opening, and closing prices of a token over a defined time frame.

## `candles`(*interval*: *str*, *symbol*: *str*, *exchange*: *str*, *count*: *Optional*\[*int*] = *100*) -> *List*\[\[*Candle*]]

`interval` can be one of the following: `s10`, `m1`, `m3`, `m5`, `m15`, `m30`, `m45`, `h1` , `h2`, `h3`, `h4`, `h6`, `h8`, `h12`, `d1`, `w1`, `M1`

If exchange does not support selected interval, the minimum supported interval will be used.

Candles sorted by ascending timestamp. Candle with index \[0] this is the newest candle.

by default return list of 100 Candles and max size 100 Candles.

Example: