> This page is for NinjaScript. > For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.ninjatrader.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ninjatrader.com/_mcp/server. # BarsRequest ## Definition BarsRequest can be used to request [Bars](/ninjascript/bars) data and subscribe to real-time Bars data events. > **Note** > > 1. When using the DateTime fromLocal and toLocal parameters, the dates are converted to local daily timestamps (12:00 AM) and return a BarsRequest representing full trading days. If you need to request less than one full trading day, please use the barsBack parameter. > 2. A BarsRequest should be called only once and subscribe to the .Update event. Remember to unsubscribe from the .Update Event handler if you are no longer using the subscription. > 3. A BarsRequest provides underlying market data for an instrument, but is not synchronized with an indicator or strategies primary data series. You will need to implement your own BarsUpdateEvent logic. > 4. BarsRequest data CANNOT be used as input for a NinjaTrader indicator. > 5. Performing a BarsRequest in Playback will always yield bars up to the current playback time / slider position. > 6. The documented BarsRequest behavior would be the same for all NinjaScript types. ## Syntax `BarsRequest(Cbi.Instrument instrument, int barsBack)` `BarsRequest(Cbi.Instrument instrument, DateTime fromLocal, DateTime toLocal)` ## Parameters | Parameter | Description | | ---------- | -------------------------------------------------------------------------------- | | Instrument | The [Instrument](/ninjascript/instrument) to request | | barsBack | An **int** value determining the number of bars to request from the current time | | fromLocal | A DateTime value determining the starting date to request | | toLocal | A DateTime value determining the ending date to request | ## Methods and Properties | Property | Description | | ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | | Bars | The [Bars](/ninjascript/bars) object returned from the request | | BarsBack | An int representing the number of bars back used in the request | | BarsPeriod | A [BarsPeriod](/ninjascript/barsperiod) for the bars request | | FromLocal | A DateTime representing the starting date used in the request | | IsDividendAdjusted | A bool representing if the bars request will be [dividend adjusted](https://ninjatrader.com/support/helpGuides/nt8/?splits_and_dividends.htm) | | IsResetOnNewTradingDay | A bool representing if the bars request will [Break at EOD](https://ninjatrader.com/support/helpGuides/nt8/NT%20HelpGuide%20English.html?break_at_eod.htm) | | IsSplitAdjusted | A bool representing if the bars request will be [split adjusted](https://ninjatrader.com/support/helpGuides/nt8/?splits_and_dividends.htm) | | Instrument | The [Instrument](/ninjascript/instrument) of the bars request | | LookupPolicy | The lookup policies for the bars request. Possible Values are: | | MergePolicy | The [merge policy](/ninjascript/mergepolicy) for the bars request. | | Request() | Requests the bars as parametrized | | TradingHours | The [trading hours](/ninjascript/tradinghours) for the bars request | | ToLocal | A DateTime representing the end date used in the request | | Update | A BarsUpdateEvent handler for subscribing/unsubscribing to bar update events | ## Examples ```csharp /* Example of subscribing/unsubscribing to bars data events from an Add On as well as making bars requests. The concept can be carried over to any NinjaScript object you may be working on. */ public class MyAddOnTab : NTTabPage { private int daysBack = 5; private bool barsRequestSubscribed = false; private BarsRequest barsRequest; public MyAddOnTab() { // create a new bars request. This will determine the insturment and range for the bars to be requested barsRequest = new BarsRequest(Cbi.Instrument.GetInstrument("AAPL"), DateTime.Now.AddDays(-daysBack), DateTime.Now); // Parametrize your request. barsRequest.BarsPeriod = new BarsPeriod { BarsPeriodType = BarsPeriodType.Minute, Value = 1 }; barsRequest.TradingHours = TradingHours.Get("Default 24 x 7"); // Attach event handler for real-time events if you want to process real-time data barsRequest.Update += OnBarUpdate; // Request the bars barsRequest.Request(new Action((bars, errorCode, errorMessage) => { if (errorCode != ErrorCode.NoError) { // Handle any errors in requesting bars here NinjaTrader.Code.Output.Process(string.Format("Error on requesting bars: {0}, {1}", errorCode, errorMessage), PrintTo.OutputTab1); return; } // Output the bars we requested. Note: The last returned bar may be a currently in-progress bar for (int i = 0; i < bars.Bars.Count; i++) { // Output the bars NinjaTrader.Code.Output.Process(string.Format("Time: {0} Open: {1} High: {2} Low: {3} Close: {4} Volume: {5}", bars.Bars.GetTime(i), bars.Bars.GetOpen(i), bars.Bars.GetHigh(i), bars.Bars.GetLow(i), bars.Bars.GetClose(i), bars.Bars.GetVolume(i)), PrintTo.OutputTab1); } // If requesting real-time bars, but there are currently no connections lock (Connection.Connections) if (Connection.Connections.FirstOrDefault() == null) NinjaTrader.Code.Output.Process("Real-Time Bars: Not connected.", PrintTo.OutputTab1); })); } // This method is fired on real-time bar events private void OnBarUpdate(object sender, BarsUpdateEventArgs e) { /* Depending on the BarsPeriod type of your barsRequest you can have situations where more than one bar is updated by a single tick. Be sure to process the full range of updated bars to ensure you did not miss a bar. */ // Output bar information on each tick for (int i = e.MinIndex; i <= e.MaxIndex; i++) { // Processing every single tick NinjaTrader.Code.Output.Process(string.Format("Time: {0} Open: {1} High: {2} Low: {3} Close: {4}", e.BarsSeries.GetTime(i), e.BarsSeries.GetOpen(i), e.BarsSeries.GetHigh(i), e.BarsSeries.GetLow(i), e.BarsSeries.GetClose(i)), PrintTo.OutputTab1); } } // Called by TabControl when tab is being removed or window is closed public override void Cleanup() { // Make sure to unsubscribe to the bars request subscription if (barsRequest != null) { barsRequest.Update -= OnBarUpdate; barsRequest.Dispose(); barsRequest = null; } } // Other required NTTabPage members left out for demonstration purposes. Be sure to add them in your own code. } ```