react-native-trading-charts is a high-speed, resource-efficient React Native
library for rendering live and historical trading data from traditional and
crypto markets. React owns configuration and data delivery; native code owns
chart state, gestures, geometry, and rendering.
The library uses a shared C++ chart and geometry engine, Metal on iOS, and OpenGL ES 3 on Android. Frames are rendered on demand, immutable snapshots are reused between updates, and high-frequency trade streams can be batched before they cross the native boundary.
React Native trading charts are commonly built with either a WebView or a general-purpose 2D engine such as Skia. Both are useful tools, but each carries costs that are unnecessary for a purpose-built OHLC renderer.
A WebView embeds a browser runtime and its view lifecycle. Chart updates pass through an additional execution context, while the browser still handles the JavaScript, DOM, CSS, layout, and rendering pipeline required by the charting application. That flexibility is valuable for reusing web charts, but it makes native performance and resource usage harder to control.
Skia provides an extensive cross-platform 2D graphics API. Trading charts need only a small subset of that functionality, while the application still carries the runtime and memory cost of a general-purpose graphics engine.
react-native-trading-charts takes a narrower approach: trading semantics and
geometry live in a small shared C++ engine, while each platform uses its native
GPU API and native text stack. The result is designed specifically for dense,
frequently updated market data without introducing a browser or a third-party
2D rendering runtime.
- Zero third-party runtime dependencies beyond React Native. React and React Native are peer dependencies; the package does not add a browser, graphics framework, or utility runtime.
- Shared C++ engine and geometry. Candle storage, raw-trade aggregation, viewport behavior, autoscale, ticks, selection, and tessellation are shared by iOS and Android.
- Native GPU rendering. Metal renders on iOS and OpenGL ES 3 renders on Android.
- Resource-efficient frames. Rendering is on demand, unchanged snapshots are cached, and content geometry is reused for crosshair-only updates.
- Multiple display types. Candlestick, hollow candlestick, OHLC bar, line, area, and histogram series are supported.
- Multiple panes and series. Add independently scaled panes, derived volume, SMA, EMA, RSI, MACD, Williams %R and KDJ, comparison series, and custom histogram data.
- Detailed presentation control. Configure themes, role-specific styles, native number/date formatting, axes, badges, and tooltips.
- Streaming-ready data APIs. Send completed candles, raw trades, batches, or use the built-in trade batcher to reduce native calls.
- Native interaction. Pan, pinch zoom, Y-axis scaling, momentum, crosshair, current-price overlays, and visible extrema are handled natively.
- Installation
- Chart Types
- Indicators and Panes
- Themes, Axes and Formatting
- Gestures and Crosshair
- Price Markers and Overlays
- Live Data and API
npm install react-native-trading-chartsRequires React Native 0.80+ with the New Architecture enabled. Native setup and first chart · Documentation portal
Choose filled or hollow candles, OHLC bars, a line, an area or a baseline chart. Switching the main series keeps its history and visible range.
The candlestick example shows each interval's open, high, low and close. Customize the rising and falling colors or round the candle bodies. The baseline example uses different line and fill colors on either side of a reference price. For line and area charts, choose the price field, stroke width and dash pattern.
Chart types and configuration examples
Overlay SMA, EMA, Bollinger Bands or Parabolic SAR on price. Give volume, RSI, MACD, Williams %R or KDJ their own panes. Each pane shares the time axis and has its own vertical scale.
The first example overlays two moving averages with different periods and line styles. The second places volume and RSI below price. You can set pane heights, allow users to drag the separators, change RSI thresholds and toggle each indicator's legend.
Moving averages · Volume and histograms · RSI · Pane layout
- Appearance. Set the background, grid opacity and candle colors. Choose fonts and colors for axis labels, and adjust badge and tooltip borders.
- Axes. Use elapsed-time spacing to show gaps between sessions or space candles evenly across closures. Set axis dimensions and leave space above and below the visible price range.
- Labels. Choose a locale, time zone and date pattern. Use compact numbers for volume, set price precision to match the instrument, or show more decimals in the tooltip than on the axis.
Themes and appearance · Axes and value formatting
Choose how many candles are visible at first, then enable horizontal pan, pinch zoom and vertical price scaling independently. A long press selects a candle. Choose solid or dashed crosshair lines, show or hide the time header, and pick the tooltip rows, their order and their labels.
Gestures and viewport · Crosshair and tooltips
Show the latest price with a line and an axis badge, pin the badge to the edge when its price is off-screen, or label the visible high and low. To mark an entry price or order target, add a horizontal line with your own price, color and label.
Current price and visible extremes · Custom price markers
Load candle history with setHistory, then call updateCandle as prices change. If your feed sends individual trades, createTradeBatcher groups them for delivery and the native engine aggregates them into candles at the chart's resolution.
The example shows one-minute candles with volume for each interval. Set the resolution to match your feed, align candles to the exchange open, and supply a calendar for holidays or shorter sessions.
Data and streaming · Time and trade aggregation · Trade batcher
View props · Commands · Events













