Tools reference · Market data
Price candles
Read
candles 10 credits a callGets price candles for a ticker (open, high, low, close and volume for each period), oldest first. Useful when you want your AI to look at the chart data itself.
What it does
By default it returns 100 daily candles from regular trading hours. You can ask for up to 500. The newest candle may still be forming.
Read only
This tool reads data. It changes nothing in your account.
Inputs
| Name | Description |
|---|---|
symbol Required | text. The ticker, such as QQQ. Futures (ES1!), indexes (^VIX) and pairs (BTC/USD) work too. |
timeframe Optional | one of 1m, 5m, 10m, 15m, 30m, 1h, 4h, 1d. The length of each candle: 1m, 5m, 10m, 15m, 30m, 1h, 4h or 1d. The default is 1d (one day). |
limit Optional | whole number, 1 to 500. How many candles to return, from 1 to 500. The default is 100. |
session Optional | one of regular, extended. "regular" for regular trading hours (the default) or "extended" to include pre-market and after-hours. Daily candles always use regular hours. |
Example
You ask
“Pull the last two weeks of hourly candles for QQQ.”
{
"symbol": "QQQ",
"timeframe": "1h",
"session": "regular",
"count": 2,
"columns": [
"time",
"open",
"high",
"low",
"close",
"volume"
],
"bars": [
[
"2026-11-17T14:30:00.000Z",
608.1,
611.9,
607.6,
611.2,
6840210
],
[
"2026-11-17T15:30:00.000Z",
611.2,
613.4,
610.5,
612.85,
3120455
]
]
}Your AI reads this result and answers in plain words. Most results include an open_in_senntric link to see the same thing in Senntric.
Related
See all tools, example prompts and limits and credits.
Updated November 17, 2026. Education, not investment advice.