tv-scraper 1.3.0

A powerful Python library for scraping real-time market data, indicators, and ideas from TradingView.

TV Scraper

A powerful, real-time Python library for extracting financial data, indicators, and ideas from TradingView.com.

🔥 New in v1.3.0: Streamer now supports analyst forecast data (price targets, EPS, revenue estimates) for stock symbols via WebSocket.

---

Attribution

This project is based on mnwato/tradingview-scraper. Thanks to the original author for the foundational work.

📚 Documentation

For complete documentation, installation guides, API references, and examples, visit:

📖 Full Documentation

Quick Links

• 🚀 Quick Start Guide
• 📦 Installation
• 📊 Supported Data
• 🔧 API Reference

---

✨ Key Features

• 🕯️ Candle + Indicators: Stream OHLCV candles with built-in/custom indicators via Streamer.get_candles().
• 📈 Forecast Data: Fetch analyst price targets and EPS/revenue estimates for stocks via Streamer.get_forecast().
• 💡 Ideas: Scrape community trading ideas with Ideas.
• 🧠 Minds: Access TradingView discussions with Minds.
• 📰 News: Fetch market headlines and filters with News.
• 🔎 Screener: Run market scans with custom fields/filters via Screener.
• 🏁 Market Movers: Track top gainers/losers and actives via Market Movers.
• 📊 Fundamentals: Get financial statements and ratios via Fundamentals.
• 🧩 Pine Workflow: Manage custom scripts with Pine and stream them through Streamer.
• 📋 API Contract: Consistent status/data/metadata/error response envelope across modules (API conventions).

---

🛠️ Development & Testing

For contributors and developers, use the Development Guide:

• 🛠️ Development Guide

---

🤝 Contributing

We welcome contributions! Please see our Contributing Guide for details.

• 🐛 Bug Reports: Open an issue
• 💡 Feature Requests: Start a discussion

---

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.