Stock aggregates

Stock aggregates API for bars, open-close, and indicators

Build historical stock charts, research screens, watchlist baselines, opening ranges, and indicator workflows with OHLC bars, grouped bars, open-close records, and SMA, EMA, MACD, and RSI endpoints.

Quick answer

Use stock aggregates for bar-level research and chart context. Record the adjusted flag, timespan, bar end timestamp, indicator window, and pagination cursor before joining a stock signal to options data.

Real-time dataHistorical market dataQuotes & tradesAggregates & indicators

Why teams use it

Historical stock bars are signal context, not fill evidence

One account, two products

Use one CuteMarkets login and API keys while keeping options and stocks subscriptions independent.

Developer delayed access

The Developer stock plan includes 15-minute delayed data, unlimited requests, and a 7-year historical lookback.

Expert quote tier

Quote endpoints are available on Expert and Commercial for quote-heavy workflows.

Aggregate semantics

Bars, open-close records, and indicators are different evidence layers

This stock aggregates guide teaches developers how bar-level data supports signals while staying separate from trade prints, quotes, and option fill evidence.

Adjusted state is part of the result

Historical stock research should store whether bars were adjusted, especially when a result is compared across long windows or joined to option studies.

Bar timing controls causality

The bar end timestamp defines when a completed-bar signal becomes available. Options fills before that timestamp are lookahead unless an order already existed.

Indicators need reproducible windows

SMA, EMA, MACD, and RSI should carry the requested timespan, window, and timestamp boundary in the research artifact.

Bars and indicators

Choose the right historical stock object before testing a signal

ObjectUse it forDo not use it for
Custom aggregatesIntraday charts, opening ranges, VWAP context, relative volume, and bar-based signals.Proof that a stock or option fill was available at a bid or ask.
Grouped barsDaily market-wide snapshots and cross-ticker research baselines.Single-ticker tick review or quote-sensitive execution checks.
Open-close recordsSession summaries, daily reports, and close-versus-open review.Intraday signal timing or same-bar fill evidence.
Previous-day barsFast watchlist baselines and prior-session comparison.Historical event replay when a precise time window is required.
SMA, EMA, MACD, RSIIndicator columns and research context with documented windows.A complete trading system without signal timestamps and fill rules.

Research audit

What to store with every stock aggregate request

Artifact fieldWhy it mattersRelated workflow
Adjusted flagClarifies whether corporate-action handling changed historical prices.Historical stock research and stock/options joins.
Timespan and multiplierDefines the actual bar width behind an opening range, indicator, or chart.Backtests, watchlists, and event studies.
Bar end timestampPrevents same-bar lookahead when a signal hands off to options.Options contract selection and quote windows.
Indicator windowMakes SMA, EMA, MACD, and RSI reproducible.Signal debugging and provider comparisons.
Pagination cursorKeeps long historical pulls auditable and restartable.Bulk research and support tickets.

Developer examples

Two code paths teams usually need first

Custom bars
curl "https://api.cutemarkets.com/v1/stocks/aggs/AAPL/5/minute/2026-05-01/2026-05-06/?adjusted=true&limit=5000" \
  -H "Authorization: Bearer YOUR_API_KEY"
Previous day
curl "https://api.cutemarkets.com/v1/stocks/aggs/AAPL/prev/?adjusted=true" \
  -H "Authorization: Bearer YOUR_API_KEY"

FAQ

Common questions about this stock data API

What is a stock aggregate?

A stock aggregate is an OHLC-style bar summary over a requested interval. It is useful for charts and signals, but it is not the same as a trade print or bid/ask quote.

Can stock aggregates prove execution price?

No. Aggregates are bar summaries. Use trades for prints and quotes for bid/ask context when the workflow needs execution-quality evidence.

What should I log with stock indicator results?

Log ticker, timespan, window, adjusted flag, bar timestamp, product plan, and the earliest timestamp when the strategy could act on the indicator.

Build stock bar workflows

Use stock aggregates and indicators for historical research, then join into quotes, trades, or options when the workflow requires deeper evidence.