litecharts 0.1.0

Python wrapper for TradingView Lightweight Charts

litecharts

Warning: This library is in alpha. The API may change unexpectedly between versions.

Thin Python wrapper for TradingView Lightweight Charts.

Installation

pip install litecharts

Quick Start

from litecharts import createChart, CandlestickSeries

# Create a chart
chart = createChart({"width": 800, "height": 600})

# Add a candlestick series
candles = chart.addSeries(CandlestickSeries)
candles.setData([
    {"time": 1609459200, "open": 100, "high": 105, "low": 95, "close": 102},
    {"time": 1609545600, "open": 102, "high": 110, "low": 100, "close": 108},
    {"time": 1609632000, "open": 108, "high": 115, "low": 105, "close": 112},
])

# Display the chart
chart.show()  # Auto-detects Jupyter or opens browser

Features

• Candlestick, Line, Area, Bar, Histogram, and Baseline series
• Multi-pane layouts with synced time scales
• Pandas DataFrame and NumPy array support
• Jupyter notebook integration
• Self-contained HTML output

Data Input

Accepts multiple formats:

# List of dicts
candles.setData([{"time": 1609459200, "open": 100, "high": 105, "low": 95, "close": 102}])

# Pandas DataFrame
import pandas as pd
df = pd.DataFrame({"open": [100], "high": [105], "low": [95], "close": [102]},
                  index=pd.to_datetime(["2021-01-01"]))
candles.setData(df)

# NumPy array (columns: time, open, high, low, close)
import numpy as np
arr = np.array([[1609459200, 100, 105, 95, 102]])
candles.setData(arr)

Multi-Pane Charts

from litecharts import createChart, CandlestickSeries, HistogramSeries

chart = createChart({"width": 800, "height": 600})

# Main pane
mainPane = chart.addPane({"heightRatio": 3})
candles = mainPane.addSeries(CandlestickSeries)
candles.setData(ohlcData)

# Volume pane
volumePane = chart.addPane({"heightRatio": 1})
volume = volumePane.addSeries(HistogramSeries)
volume.setData(volumeData)

chart.show()

License

MIT - see LICENSE

This package bundles Lightweight Charts by TradingView, Inc., licensed under Apache 2.0. See THIRD_PARTY_LICENSES.md.