Reference

Crypto OHLCV Timeframes

OHLCV candles at every common timeframe through one API: one minute, five, fifteen and thirty minutes, one hour, four hours, one day and one week, plus raw ticks. The same candles across all venues, so you pick the granularity your strategy needs instead of rebuilding candles from trades yourself.

The candle intervals BytNode accepts, from one minute to one week, plus raw ticks. How far back each one goes depends on your plan: see the usage limits.

#Candle timeframes for AI agents and LLMs

“Give me BTC’s daily candles for the last month”, “Compare ETH’s 15-minute and 4-hour trend”: an AI agent picks the timeframe as one argument of the get_pair_data MCP tool, and get_system_info tells it how far back your plan goes at each one.

MCP tools/call
Thirty daily candles of BTC in one MCP call.
{
  "name": "get_pair_data",
  "arguments": {
    "symbol": "BTCUSDT",
    "fields": ["klines"],
    "timeframe": "1d",
    "last": "30d"
  }
}
  • For the LLM: without a timeframe, get_pair_data uses 1h for a current value and, for a history, a step giving about 200 points; 1w serves candles only.
  • For developers: in your own AI agent (tool calling), declare the timeframe as an enum in the tool schema (1m to 1w), so the model cannot ask for one that does not exist.
  • Where it runs: Claude, ChatGPT, Cursor and any MCP client, including agent frameworks with MCP support such as LangChain or n8n.

Connect your AI agent with the MCP server guide, or teach it BytNode with the open-source Agent Skills.

#1m

One candle per minute. The finest aggregated view, for intraday strategies and execution.

#5m

Five minutes. Short-term trading without the noise of the minute.

#15m

A quarter of an hour. A common base for intraday signals.

#30m

Half an hour, between intraday and the hourly view. Not served on the intraday macro candles.

#1h

One hour. The usual timeframe for dashboards and swing signals.

#4h

Four hours. Reads the trend of a trading session.

#1d

One day. Backtests, daily reporting and long trends.

#1w

One week, starting Monday 00:00 UTC. Served on candles (/v1/klines) and technical indicators; the other bucketed routes stop at the day.

#ticks

No timeframe: each trade one by one, spot and futures, up to ten thousand per call. The raw material the candles are built from.