tradingview-quantitative

# Quantitative Investment Analysis Expert

Professional quantitative investment analysis system based on TradingView MCP tools providing insights and decision recommendations.

## Core Rules

### Metadata First Principle

**Before calling `tradingview_get_leaderboard`, you must first call `tradingview_get_metadata` to get parameter values:**

1. `type='markets'` → Get `market_code` (required for stock leaderboard)
2. `type='tabs'` + `asset_type` → Get available `tab` values
3. `type='columnsets'` → Get available `columnset` values

Complete metadata dictionary (market codes, tabs, columnsets, exchanges) see `references/api-documentation.md`.

### Tool Selection Quick Reference

| Need | Tool | Key Parameters |
|------|------|---------|
| Search instruments | `search_market` | query, filter(stock/crypto/forex...) |
| Real-time quotes | `get_quote` / `get_quote_batch` | symbol, session |
| K-line data | `get_price` / `get_price_batch` | symbol, timeframe(1/5/15/30/60/240/D/W/M), range(max 500) |
| Technical analysis | `get_ta` | symbol, **include_indicators=true for detailed indicators** |
| Leaderboard | `get_leaderboard` | asset_type, tab, market_code, **columnset**(overview/performance/valuation/dividends/profitability/income_statement/balance_sheet/cash_flow/technical) |
| News | `get_news` / `get_news_detail` | market_country, lang(zh-Hans/en/ja), symbol |
| Economic calendar | `get_calendar` | type(economic/earnings/revenue/ipo), from/to(Unix seconds), market |
| Metadata | `get_metadata` | type(markets/tabs/columnsets/languages/exchanges) |

## Workflows

For detailed steps, see `workflows/ directory:

### Core Analysis
- **`deep-stock-analysis.md`** - Deep individual stock analysis (combine quote + price multi-timeframe + ta detailed indicators + news + calendar)
- **`smart-screening.md`** - Smart stock screening (leaderboard multi-columnset + ta + price)
- **`fundamental-screening.md`** - Fundamental screening (leaderboard valuation/profitability/dividends co...

# TradingView Quantitative Investment Analysis Skill

[English](README.md) | [简体中文](README.zh.md)

[![Install with skills](https://img.shields.io/badge/install-skills-blue)](https://skills.sh/hypier/tradingview-quantitative-skills/tradingview-quantitative)
[![GitHub](https://img.shields.io/github/stars/hypier/tradingview-quantitative-skills?style=social)](https://github.com/hypier/tradingview-quantitative-skills)

Professional quantitative investment analysis system based on TradingView data providing intelligent stock screening, technical pattern recognition, market review, risk management, and event-driven analysis.

## Installation

Install this skill with one command:

```bash
npx skills add hypier/tradingview-quantitative-skills
```

## Features

- ✅ **Smart Stock Screening** - Multi-factor comprehensive scoring, dual filtering of technical + fundamental aspects
- 📊 **Technical Pattern Recognition** - Automatically identify classic patterns, provide confidence assessment and trading strategies
- 📈 **Market Review** - Track hot sectors, capital flows, discover investment opportunities
- 🛡️ **Risk Management** - Position suggestions, stop-loss/take-profit, volatility analysis
- 📰 **Event-Driven Analysis** - Track earnings, policies, news, analyze market impact
- 🔍 **Deep Individual Stock Analysis** - Multi-timeframe technical analysis + fundamentals + news comprehensive evaluation
- 💰 **Fundamental Screening** - High dividend, low valuation, profitability screening
- 🔄 **Sector Rotation** - Identify strong sectors and rotation trends

## Quick Start

### 1. Configure MCP Server

Add TradingView MCP server to Cursor or Claude Desktop configuration file:

**Configuration file paths**:
- **macOS/Linux**: `~/Library/Application Support/Cursor/mcp_config.json`
- **Windows**: `%APPDATA%\Cursor\mcp_config.json`

> **📖 Security Notice**: Please read [SECURITY.md](SECURITY.md) for important information about API key management and data privacy.

#### Method 1:...