This demo shows you how to create a JavaScript User Annotated Stock Chart using SciChart.js. Custom modifiers allow you to add lines and markers, then use the built in serialisation functions to save and reload the chart, including the data and all your custom annotations.
// SCICHART EXAMPLE
import {
AnnotationClickEventArgs,
CategoryAxis,
configure2DSurface,
EAutoRange,
EBaseType,
ECoordinateMode,
EMultiLineAlignment,
ENumericFormat,
EVerticalAnchorPoint,
FastCandlestickRenderableSeries,
FastLineRenderableSeries,
MouseWheelZoomModifier,
NativeTextAnnotation,
NumberRange,
NumericAxis,
OhlcDataSeries,
registerFunction,
SciChartSurface,
SmartDateLabelProvider,
TOhlcSeriesData,
XyMovingAverageFilter,
ZoomExtentsModifier,
ZoomPanModifier,
} from "scichart";
import { appTheme } from "./appTheme";
import { CreateTradeMarkerModifier } from "./CreateTradeMarkerModifier";
import { CreateLineAnnotationModifier } from "./CreateLineAnnotationModifier";
import { ExampleDataProvider } from "./ExampleDataProvider";
const deleteOnClick = (args: AnnotationClickEventArgs) => {
if (args.sender.isSelected && args.mouseArgs.ctrlKey) {
args.sender.parentSurface.annotations.remove(args.sender, true);
}
};
registerFunction(EBaseType.OptionFunction, "deleteOnClick", deleteOnClick);
export const drawExample = async (divElementId: string | HTMLDivElement) => {
// Create a SciChartSurface
const { sciChartSurface, wasmContext } = await SciChartSurface.create(divElementId, {
theme: appTheme.SciChartJsTheme,
});
const xAxis = new CategoryAxis(wasmContext, {
// autoRange.never as we're setting visibleRange explicitly below. If you dont do this, leave this flag default
autoRange: EAutoRange.Never,
labelProvider: new SmartDateLabelProvider(),
});
sciChartSurface.xAxes.add(xAxis);
// Create a NumericAxis on the YAxis with 2 Decimal Places
sciChartSurface.yAxes.add(
new NumericAxis(wasmContext, {
growBy: new NumberRange(0.1, 0.1),
labelFormat: ENumericFormat.Decimal,
labelPrecision: 2,
labelPrefix: "$",
autoRange: EAutoRange.Always,
})
);
const day = 24 * 60 * 60;
const startDate = new Date(Date.now() - 300 * day);
const { xValues, openValues, highValues, lowValues, closeValues } = ExampleDataProvider.getRandomOHLCVData(
300,
1.5,
startDate,
day
);
// Create and add the Candlestick series
// The Candlestick Series requires a special dataseries type called OhlcDataSeries with o,h,l,c and date values
const candleDataSeries = new OhlcDataSeries(wasmContext, {
xValues,
openValues,
highValues,
lowValues,
closeValues,
dataSeriesName: "BTC/USDT",
});
const candlestickSeries = new FastCandlestickRenderableSeries(wasmContext, {
id: "Candles",
dataSeries: candleDataSeries,
stroke: appTheme.ForegroundColor, // used by cursorModifier below
strokeThickness: 1,
brushUp: appTheme.VividGreen + "77",
brushDown: appTheme.MutedRed + "77",
strokeUp: appTheme.VividGreen,
strokeDown: appTheme.MutedRed,
});
sciChartSurface.renderableSeries.add(candlestickSeries);
// Add some moving averages using SciChart's filters/transforms API
// when candleDataSeries updates, XyMovingAverageFilter automatically recomputes
sciChartSurface.renderableSeries.add(
new FastLineRenderableSeries(wasmContext, {
dataSeries: new XyMovingAverageFilter(candleDataSeries, {
dataSeriesName: "Moving Average (20)",
length: 20,
}),
stroke: appTheme.VividSkyBlue,
})
);
sciChartSurface.renderableSeries.add(
new FastLineRenderableSeries(wasmContext, {
dataSeries: new XyMovingAverageFilter(candleDataSeries, {
dataSeriesName: "Moving Average (50)",
length: 50,
}),
stroke: appTheme.VividPink,
})
);
// Optional: Add some interactivity modifiers
sciChartSurface.chartModifiers.add(
new ZoomExtentsModifier(),
new MouseWheelZoomModifier(),
new ZoomPanModifier({ id: "pan" }),
new CreateTradeMarkerModifier({ id: "marker" }),
new CreateLineAnnotationModifier({ id: "line" })
);
sciChartSurface.chartModifiers.getById("marker").isEnabled = false;
sciChartSurface.chartModifiers.getById("line").isEnabled = false;
const helpAnnotation = new NativeTextAnnotation({
x1: 20,
y1: 20,
xCoordinateMode: ECoordinateMode.Pixel,
yCoordinateMode: ECoordinateMode.Pixel,
verticalAnchorPoint: EVerticalAnchorPoint.Top,
multiLineAlignment: EMultiLineAlignment.Left,
textColor: appTheme.ForegroundColor,
});
// Add this to modifierAnnotations so it is not saved/loaded
sciChartSurface.modifierAnnotations.add(helpAnnotation);
const getDefinition = () => {
return {
visibleRange: xAxis.visibleRange,
annotations: sciChartSurface.annotations.asArray().map((annotation) => annotation.toJSON()),
data: candleDataSeries.toJSON(),
};
};
const applyDefinition = (definition: any) => {
if (definition) {
configure2DSurface({ annotations: definition.annotations }, sciChartSurface, wasmContext);
xAxis.visibleRange = definition.visibleRange;
const newData = definition.data.options as TOhlcSeriesData;
candleDataSeries.clear();
candleDataSeries.appendRange(
newData.xValues,
newData.openValues,
newData.highValues,
newData.lowValues,
newData.closeValues
);
}
};
const setChartMode = (mode: string) => {
if (mode === "pan") {
sciChartSurface.chartModifiers.getById("marker").isEnabled = false;
sciChartSurface.chartModifiers.getById("line").isEnabled = false;
sciChartSurface.chartModifiers.getById("pan").isEnabled = true;
helpAnnotation.text = `Click and drag to pan the chart`;
} else if (mode === "line") {
sciChartSurface.chartModifiers.getById("marker").isEnabled = false;
sciChartSurface.chartModifiers.getById("line").isEnabled = true;
sciChartSurface.chartModifiers.getById("pan").isEnabled = false;
helpAnnotation.text = `Click and drag to draw a line.
Ctrl + click a line to delete it`;
} else if (mode === "marker") {
sciChartSurface.chartModifiers.getById("marker").isEnabled = true;
sciChartSurface.chartModifiers.getById("line").isEnabled = false;
sciChartSurface.chartModifiers.getById("pan").isEnabled = false;
helpAnnotation.text = `Left click to place a buy marker.
Right click to place a sell marker
Ctrl + Click to delete a marker`;
}
};
const resetChart = () => {
sciChartSurface.annotations.clear(true);
// Zoom to the latest 100 candles
xAxis.visibleRange = new NumberRange(xValues.length - 100, xValues.length - 1);
};
resetChart();
setChartMode("line");
return {
sciChartSurface,
controls: { getDefinition, applyDefinition, resetChart, setChartMode },
};
};
This example demonstrates how to build an interactive candlestick stock chart using SciChart.js in a JavaScript application. It offers advanced customization features, including the ability to add custom line annotations and trade markers for enhanced financial charting. The implementation also leverages state serialization to save and reload chart configurations, ensuring a persistent and responsive user experience.
The chart is initialized asynchronously using the SciChartSurface.create() method, which sets up the WebGL rendering context for high-performance graphics. Custom chart modifiers such as the CreateLineAnnotationModifier and CreateTradeMarkerModifier extend the SciChart.js ChartModifierBase2D class to handle mouse events and enable interactive annotation creation. Coordinate conversions are performed with the translateFromCanvasToSeriesViewRect utility, which transforms canvas pixel positions into data coordinates. This approach is detailed in the Custom Chart Modifier API and the Axis APIs - Convert Pixel to Data Coordinates documentation.
The example integrates several advanced features:
FastCandlestickRenderableSeries combined with XyMovingAverageFilters ensures efficient data visualization.CreateLineAnnotationModifier and CreateTradeMarkerModifier, line and trade marker annotations are created on-click and modified on-the-fly, allowing for detailed chart analysis. More information is available in Tutorial 06 - Adding Annotations.This JavaScript implementation follows best practices for asynchronous module initialization and performance optimization. By leveraging WebGL for rendering and maintaining chart state through JSON configurations, developers can achieve both high performance and robust interactivity. For further details on asynchronous setup, see Getting Started with SciChart JS. The example also demonstrates practical techniques for managing persistent state via the localStorage API, ensuring that user annotations and configurations are preserved across sessions.
Overall, this example serves as a comprehensive guide to building high-performance, interactive financial charts in JavaScript with SciChart.js, combining advanced customization, real-time data processing, and robust state persistence.












