2/18/24, 9:12 PM GitHub - louisnw01/lightweight-charts-python: Python framework for TradingView's Lightweight Charts JavaScript library.
louisnw01 / lightweight-charts-python Public
Python framework for TradingView's Lightweight Charts JavaScript library.
MIT license
629 stars 108 forks Branches Tags Activity
Star Notifications
Code Issues 16 Pull requests 2 Actions Projects Security Insights
main 1 Branch 30 Tags Go to file Go to file Code
louisnw01 Added the marker_list function for setting multiple markers. 4 days ago
.github pandas ambigious hotfix 4 months ago
docs Added the render_drawings para… last month
examples Added the render_drawings para… last month
lightweight_charts Added the marker_list function f… 4 days ago
.gitignore chore(.gitignore): remove docs/so… last month
.readthedocs.yaml add .readthedocs.yaml 7 months ago
LICENSE first commit 9 months ago
README.md Added the render_drawings para… last month
cover.png Enhancements and Bug Fixes 7 months ago
setup.py Added the render_drawings para… last month
README MIT license
lightweight-charts-python
PyPi v1.0.19 Python 3.8+ license MIT documentation
https://github.com/louisnw01/lightweight-charts-python 1/8
2/18/24, 9:12 PM GitHub - louisnw01/lightweight-charts-python: Python framework for TradingView's Lightweight Charts JavaScript library.
lightweight-charts-python aims to provide a simple and pythonic way to access and implement
TradingView's Lightweight Charts.
Installation
pip install lightweight-charts
Features
1. Streamlined for live data, with methods for updating directly from tick data.
2. Multi-pane charts using Subcharts.
3. The Toolbox, allowing for trendlines, rays and horizontal lines to be drawn directly onto charts.
4. Events allowing for timeframe selectors (1min, 5min, 30min etc.), searching, hotkeys, and more.
5. Tables for watchlists, order entry, and trade management.
6. Direct integration of market data through Polygon.io's market data API.
Supports: Jupyter Notebooks, PyQt5, PySide6, wxPython, Streamlit, and asyncio.
PartTimeLarry: Interactive Brokers API and TradingView Charts in Python
1. Display data from a csv:
import pandas as pd
from lightweight_charts import Chart
if __name__ == '__main__':
https://github.com/louisnw01/lightweight-charts-python 2/8
2/18/24, 9:12 PM GitHub - louisnw01/lightweight-charts-python: Python framework for TradingView's Lightweight Charts JavaScript library.
chart = Chart()
# Columns: time | open | high | low | close | volume
df = pd.read_csv('ohlcv.csv')
chart.set(df)
chart.show(block=True)
2. Updating bars in real-time:
import pandas as pd
from time import sleep
from lightweight_charts import Chart
if __name__ == '__main__':
chart = Chart()
df1 = pd.read_csv('ohlcv.csv')
df2 = pd.read_csv('next_ohlcv.csv')
chart.set(df1)
chart.show()
last_close = df1.iloc[-1]['close']
for i, series in df2.iterrows():
chart.update(series)
if series['close'] > 20 and last_close < 20:
chart.marker(text='The price crossed $20!')
https://github.com/louisnw01/lightweight-charts-python 3/8
2/18/24, 9:12 PM GitHub - louisnw01/lightweight-charts-python: Python framework for TradingView's Lightweight Charts JavaScript library.
last_close = series['close']
sleep(0.1)
3. Updating bars from tick data in real-time:
import pandas as pd
from time import sleep
from lightweight_charts import Chart
if __name__ == '__main__':
df1 = pd.read_csv('ohlc.csv')
# Columns: time | price
df2 = pd.read_csv('ticks.csv')
chart = Chart()
chart.set(df1)
chart.show()
for i, tick in df2.iterrows():
chart.update_from_tick(tick)
sleep(0.03)
https://github.com/louisnw01/lightweight-charts-python 4/8
2/18/24, 9:12 PM GitHub - louisnw01/lightweight-charts-python: Python framework for TradingView's Lightweight Charts JavaScript library.
4. Line Indicators:
import pandas as pd
from lightweight_charts import Chart
def calculate_sma(df, period: int = 50):
return pd.DataFrame({
'time': df['date'],
f'SMA {period}': df['close'].rolling(window=period).mean()
}).dropna()
if __name__ == '__main__':
chart = Chart()
chart.legend(visible=True)
df = pd.read_csv('ohlcv.csv')
chart.set(df)
line = chart.create_line('SMA 50')
sma_data = calculate_sma(df, period=50)
line.set(sma_data)
chart.show(block=True)
https://github.com/louisnw01/lightweight-charts-python 5/8
2/18/24, 9:12 PM GitHub - louisnw01/lightweight-charts-python: Python framework for TradingView's Lightweight Charts JavaScript library.
5. Styling:
import pandas as pd
from lightweight_charts import Chart
if __name__ == '__main__':
chart = Chart()
df = pd.read_csv('ohlcv.csv')
chart.layout(background_color='#090008', text_color='#FFFFFF', font_size=16,
font_family='Helvetica')
chart.candle_style(up_color='#00ff55', down_color='#ed4807',
border_up_color='#FFFFFF', border_down_color='#FFFFFF',
wick_up_color='#FFFFFF', wick_down_color='#FFFFFF')
chart.volume_config(up_color='#00ff55', down_color='#ed4807')
chart.watermark('1D', color='rgba(180, 180, 240, 0.7)')
chart.crosshair(mode='normal', vert_color='#FFFFFF', vert_style='dotted',
horz_color='#FFFFFF', horz_style='dotted')
chart.legend(visible=True, font_size=14)
chart.set(df)
chart.show(block=True)
https://github.com/louisnw01/lightweight-charts-python 6/8
2/18/24, 9:12 PM GitHub - louisnw01/lightweight-charts-python: Python framework for TradingView's Lightweight Charts JavaScript library.
6. Callbacks:
import pandas as pd
from lightweight_charts import Chart
def get_bar_data(symbol, timeframe):
if symbol not in ('AAPL', 'GOOGL', 'TSLA'):
print(f'No data for "{symbol}"')
return pd.DataFrame()
return pd.read_csv(f'bar_data/{symbol}_{timeframe}.csv')
def on_search(chart, searched_string): # Called when the user searches.
new_data = get_bar_data(searched_string, chart.topbar['timeframe'].value)
if new_data.empty:
return
chart.topbar['symbol'].set(searched_string)
chart.set(new_data)
def on_timeframe_selection(chart): # Called when the user changes the timeframe.
new_data = get_bar_data(chart.topbar['symbol'].value, chart.topbar['timeframe'].value)
if new_data.empty:
return
chart.set(new_data, True)
def on_horizontal_line_move(chart, line):
print(f'Horizontal line moved to: {line.price}')
if __name__ == '__main__':
https://github.com/louisnw01/lightweight-charts-python 7/8
2/18/24, 9:12 PM GitHub - louisnw01/lightweight-charts-python: Python framework for TradingView's Lightweight Charts JavaScript library.
chart = Chart(toolbox=True)
chart.legend(True)
chart.events.search += on_search
chart.topbar.textbox('symbol', 'TSLA')
chart.topbar.switcher('timeframe', ('1min', '5min', '30min'), default='5min',
func=on_timeframe_selection)
df = get_bar_data('TSLA', '5min')
chart.set(df)
chart.horizontal_line(200, func=on_horizontal_line_move)
chart.show(block=True)
Releases 30
v1.0.19 Latest
last month
+ 29 releases
Sponsor this project
louisnw01
https://www.buymeacoffee.com/7wzcr2p9vxM/
Learn more about GitHub Sponsors
Contributors 5
Languages
Python 54.0% JavaScript 46.0%
https://github.com/louisnw01/lightweight-charts-python 8/8
