/tvdatafeed

A simple TradingView historical Data Downloader

Primary LanguageJupyter NotebookMIT LicenseMIT

TvDatafeed

A simple TradingView historical Data Downloader

If you found the content useful and want to support my work, you can buy me a coffee! "Buy Me A Coffee"

Installation

This module is installed via pip:

pip install --upgrade --no-cache-dir git+https://github.com/StreamAlpha/tvdatafeed.git

For usage instructions watch these videos-

v1.1 tutorial with installation and backtrader usage

Watch the video

Full tutorial

Watch the video

Usage

Import the packages and initialize with your tradingview username and password. If running for first time it will prompt chromedriver download, type 'y' and press enter.

from tvDatafeed import TvDatafeed, Interval, symbols

username = 'YourTradingViewUsername'
password = 'YourTradingViewPassword'



tv = TvDatafeed(username, password, chromedriver_path=None)

If auto login fails, you can try logging in manually by specifying auto_login=False

tv = TvDatafeed(auto_login=False)

It will open TradingView website, you need to login manually. Once logged in return back to terminal and press 'enter', browser will automatically close. Whichever login method is used, login is required only once.

You may use without logging in, but in that case tradingview may limit the symbols and some symbols might not be available. To use it without logging in

tv = TvDatafeed()

Getting Data

To download the data use tv.get_hist method.

It accepts following arguments and returns pandas dataframe

(symbol: str, exchange: str = 'NSE', interval: Interval = Interval.in_daily, n_bars: int = 10, fut_contract: int | None = None) -> DataFrame)

for example-

# index
nifty_index_data = tv.get_hist(symbol='NIFTY',exchange='NSE',interval=Interval.in_1_hour,n_bars=1000)

# futures continuous contract
nifty_futures_data = tv.get_hist(symbol='NIFTY',exchange='NSE',interval=Interval.in_1_hour,n_bars=1000,fut_contract=1)

# crudeoil
crudeoil_data = tv.get_hist(symbol='CRUDEOIL',exchange='MCX',interval=Interval.in_1_hour,n_bars=5000,fut_contract=1)

Following timeframes intervals are supported-

Interval.in_1_minute

Interval.in_3_minute

Interval.in_5_minute

Interval.in_15_minute

Interval.in_30_minute

Interval.in_45_minute

Interval.in_1_hour

Interval.in_2_hour

Interval.in_3_hour

Interval.in_4_hour

Interval.in_daily

Interval.in_weekly

Interval.in_monthly

If you face any difficulty you can reset this tvdatafeed using clear_cache method. You will need to login again after reset.

tv.clear_cache()

Troubleshooting

Check this issue. A hard reset procedure mainly for linux but works on all platforms.

Read this before creating an issue

Before creating an issue in this library, please follow the following steps.

  1. Search the problem you are facing is already asked by someone else. There might be some issues already there, either solved/unsolved related to your problem. Go to issues page, use is:issue as filter and search your problem. image

  2. If you feel your problem is not asked by anyone or no issues are related to your problem, then create a new issue.

  3. Describe your problem in detail while creating the issue. If you don't have time to detail/describe the problem you are facing, assume that I also won't be having time to respond to your problem.

  4. Post a sample code of the problem you are facing. If I copy paste the code directly from issue, I should be able to reproduce the problem you are facing.

  5. Before posting the sample code, test your sample code yourself once. Only sample code should be tested, no other addition should be there while you are testing.

  6. Have some print() function calls to display the values of some variables related to your problem.

  7. Post the results of print() functions also in the issue.

  8. Use the insert code feature of github to inset code and print outputs, so that the code is displyed neat. !

  9. If you have multiple lines of code, use tripple grave accent ( ``` ) to insert multiple lines of code. Example: image