Tools reference · Market data

Price candles

Read candles 10 credits a call

Gets 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

symbol Requiredtext. The ticker, such as QQQ. Futures (ES1!), indexes (^VIX) and pairs (BTC/USD) work too.
timeframe Optionalone 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 Optionalwhole number, 1 to 500. How many candles to return, from 1 to 500. The default is 100.
session Optionalone 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.”

Result (trimmed, example values)
{
  "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.

See all tools, example prompts and limits and credits.

Updated November 17, 2026. Education, not investment advice.