@alandlguo/tradingview-api/README.md

Tradingview instant stocks API, indicator alerts, trading bot, and more !

# TradingView API [![GitHub stars](https://img.shields.io/github/stars/Mathieu2301/TradingView-API.svg?style=social&label=Star&maxAge=2592000)](https://GitHub.com/Mathieu2301/TradingView-API/stargazers/)

[![Tests](https://github.com/Mathieu2301/TradingView-API/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/Mathieu2301/TradingView-API/actions/workflows/tests.yml)
[![CodeFactor](https://www.codefactor.io/repository/github/mathieu2301/tradingview-api/badge/main)](https://www.codefactor.io/repository/github/mathieu2301/tradingview-api/overview/main)
[![GitHub latest commit](https://img.shields.io/github/last-commit/Mathieu2301/TradingView-API)](https://GitHub.com/Mathieu2301/TradingView-API/commit/)
[![Npm package yearly downloads](https://badgen.net/npm/dt/@mathieuc/tradingview)](https://npmjs.com/@mathieuc/tradingview)
[![Minimum node.js version](https://badgen.net/npm/node/@mathieuc/tradingview)](https://npmjs.com/@mathieuc/tradingview)
[![Npm package version](https://badgen.net/npm/v/@mathieuc/tradingview)](https://npmjs.com/package/@mathieuc/tradingview)

Get realtime market prices and indicator values from Tradingview !

## 🟢 Need help with your project?

🚀 Click [here](https://forms.gle/qPp5RKo8L55C5oJE7) for personalized assistance on your project.

## 🔵 Telegram group

👉 To get help, exchange tips, find collaborators, developers, missions, etc...

Join the Telegram group of the TradingView-API Community: [t.me/tradingview_api](https://t.me/tradingview_api)

## 📦 Installation

```bash
npm install @mathieuc/tradingview
```

## 🚀 Publishing

To publish a new version:

1. Update version in `package.json`
2. Update `CHANGELOG.md` with new changes
3. Run tests: `npm test` 
4. Build: `npm run build`
5. Publish: `npm publish`

## Features

- [x] Premium features
- [x] Automatically backtest many strategies and try many settings in a very little time
- [x] Get drawings you made on your chart
- [x] Works with invite-only indicators
- [x] Unlimited simultaneous indicators
- [x] Realtime
- [x] Get TradingView's technical analysis
- [x] Replay mode + Fake Replay mode (for free plan)
- [x] Get values from a specific date range
- [ ] TradingView socket server emulation
- [ ] Interract with public chats
- [ ] Get Screener top values
- [ ] Get Hotlists
- [ ] Get Calendar
- IF YOU WANT A FEATURE, ASK ME !

## Possibilities

- Trading bot
- Discord alerts
- Hard backtest
- Machine Learning based indicator
- Free replay mode for all timeframes

___

## Examples

You can find all the examples and snippets in `./examples` folder.

## Before opening an issue

Please look at examples and previously resolved issues before opening a new one. I can't help everyone (especially for questions that are not library related but JavaScript related). Thank you for your understanding.
___

## Problems

 If you have errors in console or unwanted behavior,
 please create an issue [here](https://github.com/Mathieu2301/Tradingview-API/issues).