| name | history |
| description | Use whenever you reach for a `History()` request — a startup seed, a one-off lookback, or a recent past value like the previous daily close. For a rolling statistic recomputed every bar, prefer a streaming indicator (see indicators). |
History requests — seeds, lookbacks, and recent past values
Use History() for a one-off need: seeding a signal at startup, a single lookback, or reading a recent past value (like yesterday's close). If instead you need a rolling statistic recomputed on every bar or scheduled event — a moving average, momentum, rolling volatility — register a streaming indicator once and read it (see the indicators skill); don't call History() every time to recompute it (slow, and easy to get the as-of bar wrong).
Typed bars — read them directly, and match times on the END stamp
History() returns typed bars you read directly; the one thing to get right is the bar timestamp.
- Iterating bar-by-bar → use the TYPED overload
History<TradeBar>(symbol, period, resolution) (or <QuoteBar>). It yields TradeBar objects you read directly — bar.EndTime, bar.Open, bar.High, bar.Low, bar.Close, bar.Volume. This is the right tool for building per-day/per-bar records or finding the bar at a specific time.
- Timestamp gotcha: every LEAN bar is stamped at its END time. For US Equities specifically, the first regular-hours minute bar is stamped 09:31 (the 09:30→09:31 bar), not 09:30 — so matching a target time to the bar's start silently yields empty results; match target times against
bar.EndTime.
A prior daily value — Identity on daily resolution
var ind = Identity(symbol, Resolution.Daily) gives an indicator whose ind.Current.Value is the close of the last COMPLETED daily bar — a clean way to reference "the previous day's close" each day without a per-event history request.
- Read intraday (e.g. a few minutes before today's close), it holds the PRIOR trading day's close — today's daily bar is not built yet. Verified: on Monday 2024-05-20 at 15:44 ET,
ind.Current.Value = 68.40 = Friday 2024-05-17's close (matching a daily-history last close), while the live intraday price was 68.38.
- Warm it up so
ind.IsReady is true at the start; for the warm-up options and the full automatic/manual indicator toolkit, see indicators.
Current session OHLC + recent daily bars — security.Session
security.Session is a built-in RollingWindow of daily session bars — reach for it instead of a hand-rolled per-day tracker (a record class / Queue<T> you update yourself) or repeated daily History() calls. It defaults to size 0; set the size, then read:
var session = Securities[symbol].Session;
session.Size = 252;
var todayOpen = session.Open;
var prevClose = session[1].Close;
var closes = session.Select(x => x.Close).ToList();
session.Open is the running open from the day's first bar, so it is the clean way to read "today's open" intraday.
Index [0] is the CURRENT, still-forming session — intraday its .Close is the live price, not a completed daily close (verified: at 15:00 session[0].Close equals the live price while session[1].Close equals the prior day's official close). For any previous daily value use session[1], never session[0].
security.Session starts empty — warm it up before you read session[1].
- Static universe:
SetWarmUp(n, Resolution.Daily) warms it.
- Dynamic universe:
SetWarmUp does NOT warm sessions for assets that join later — in OnSecuritiesChanged, replay daily history through Session.Update(bar):
public override void OnSecuritiesChanged(SecurityChanges changes)
{
var history = History<TradeBar>(changes.AddedSecurities.Select(s => s.Symbol), 2, Resolution.Daily);
foreach (var security in changes.AddedSecurities)
{
security.Session.Size = 2;
foreach (var bars in history)
{
if (bars.TryGetValue(security.Symbol, out var bar))
{
security.Session.Update(bar);
}
}
}
}
- Alternative (intraday data): set
Settings.AutomaticIndicatorWarmUp = true, then register a daily Identity per added security and keep it in a Dictionary<Symbol, Identity> field: _previousClose[security.Symbol] = Identity(security.Symbol, Resolution.Daily) — its .Current.Value is the last completed daily close.
When you do legitimately need History()
A startup seed or a one-off lookback is a fine use of History(). It returns data from before the start date, so a single request can seed a signal with no warm-up. Request it ONCE for all the symbols and the full window you need — do not loop a separate request per symbol or per bar. One request per genuine need is fine; what's wasteful is using a history request to check whether names have enough history — pulling N bars for every candidate in a universe screen just to count them stalls the algorithm. For a listing-age / minimum-history filter, read the Fundamental data point's f.SecurityReference.IPODate instead.
Start date placement — seed the lookback, don't idle into it
Because History() and SetWarmUp read from BEFORE the start date, set the backtest start to the first date you intend to trade, with the lookback seeded from earlier data — not to the data's inception. If you start at the inception, there is no earlier data to seed from, so the strategy spends its first lookback-worth of bars accumulating the window in-sample: a flat warm-up stretch at the start of the equity curve (which also understates CAGR/Sharpe). When the data itself begins partway in (e.g. an ETF that incepts mid-history), set the start to roughly (inception + the longest lookback) so bar 1 already has its window.
This is about being eligible to trade from bar 1 — NOT about being always invested. A strategy whose signal legitimately holds cash and moves in/out at precise moments will still show flat stretches (possibly including the start), and those are correct — only a flat stretch caused by an unseeded lookback is the defect.
