/tradingview

name: tradingview
description: "Datos de mercado de TradingView via APIs publicas internas sin auth: Scanner (~300 columnas con quote/indicadores tecnicos/financials/earnings/ratings/targets), Symbol Search v3 (ISIN/CUSIP/CIK), News Headlines, scraping HTML de subpages (technicals/financials/forecast/options/ideas). Cobertura GLOBAL: 100k+ stocks, 50k+ cryptos, indices, forex, bonos. 24 modos CLI."
license: MIT

TradingView — Market Data via APIs Publicas

Skill **premium** para extraer datos de mercado de [TradingView](https://www.tradingview.com) via sus **APIs publicas internas** descubiertas por reverse-engineering — **sin API key, sin autenticacion**.

TradingView es la plataforma de market data + analisis tecnico + social trading mas usada del mundo (>50M usuarios activos). Este skill expone:

• **Scanner API** con ~300 columnas: quote, indicadores tecnicos pre-calculados,

fundamentals, earnings, analyst targets, ratings BUY/SELL agregados.

• **Symbol Search v3** con **ISIN, CUSIP, CIK** (joineable con SEC EDGAR).
• **News Headlines** (~200 noticias por simbolo, Dow Jones / Reuters / etc.).
• **HTML scraping** de 16+ subpages (`technicals`, `financials-*`, `forecast`,

`options-chain`, `ideas`, etc.) con extraccion de `prs.init-data+json`.

• **Screener masivo** con filtros + sort + paginacion (~100k+ instrumentos).

---

⚠️ Aviso Legal

• TradingView **NO publica documentacion oficial** de estas APIs. Pueden cambiar sin aviso.
• En **~6 años** de tracking comunitario los cambios han sido graduales — la estructura del Scanner es estable desde 2017+.
• Respetar terminos de uso. Para uso comercial intensivo, contratar la **REST API oficial** (de pago).
• Los datos son **delayed** (~15 min tipico). Real-time va por WebSockets propietarios (no implementados aqui).

---

🚀 Quick start

# Quote rapido
py scripts/fetch_tradingview.py quote NASDAQ:GGAL

# Todo-en-uno (6 requests combinadas)
py scripts/fetch_tradingview.py all NASDAQ:GGAL

# Screener masivo
py scripts/fetch_tradingview.py country Argentina --limit 30
py scripts/fetch_tradingview.py sector Finance --market america --limit 20

# News (~200 por simbolo)
py scripts/fetch_tradingview.py news NASDAQ:AAPL

# Symbol Search con ISIN/CUSIP/CIK
py scripts/fetch_tradingview.py search "Galicia"

---

Estructura del skill

skills/tradingview/
├── SKILL.md                              # Este archivo (guia rapida)
├── references/                           # 8 documentos detallados
│   ├── REFERENCE.md                      # Overview general de la API
│   ├── SCANNER_COLUMNS.md                # Catalogo de 130+ columnas con tablas
│   ├── SCANNER_FILTERS.md                # Operaciones de filtro + queries complejos
│   ├── MARKETS_EXCHANGES.md              # Mercados validos + exchanges por pais
│   ├── NEWS_API.md                       # News API deep dive
│   ├── SYMBOL_SEARCH.md                  # Symbol Search v3 deep dive
│   ├── HTML_SCRAPING.md                  # Extraccion de prs.init-data+json
│   └── COOKBOOK.md                       # 30 recetas listas para copy-paste
├── assets/                               # 4 archivos JSON
│   ├── scanner_columns.json              # Catalogo de columnas con descripciones
│   ├── column_groups.json                # Bundles pre-armados por caso de uso
│   ├── markets.json                      # Mercados validos + cobertura
│   └── recommend_ratings.json            # Mapeo Recommend.* a STRONG_BUY/etc
└── scripts/
    └── fetch_tradingview.py              # Script principal con 24 modos CLI

---

Endpoints disponibles (4 HTTP unicos, 24 modos CLI)

Scanner API (1 endpoint, 14 modos CLI)

`POST https://scanner.tradingview.com/{market}/scan`

| Modo | Bundle de columnas | Descripcion | |------|-------------------|-------------| | `quote SYM` | `quote_basic` (14 cols) | Quote basico | | `quote-extended SYM` | `quote_extended` (30 cols) | Quote + indicadores + valuacion | | `technicals SYM` | `technicals` (36 cols) | RSI, MACD, EMAs, SMAs, ratings | | `pivots SYM` | `pivots` (17 cols) | Pivots mensuales (5 metodos) | | `financials SYM` | `financials` (35 cols) | Balance + income + cashflow + ratios | | `earnings SYM` | `earnings` (12 cols) | Earnings pasados + forecast | | `targets SYM` | `targets` (10 cols) | Price targets + analyst recommendations | | `performance SYM` | `performance` (18 cols) | Returns (W/1M/3M/6M/Y/YTD/5Y/All) + volatilidad + beta | | `dividends SYM` | `dividends` (8 cols) | Yield + DPS + payout + crecimiento | | `ownership SYM` | `ownership` (10 cols) | Float + institucional + insiders + short | | `screen` | custom | Screener generico con filtros + sort + paginacion | | `country COUNTRY` | `quote_basic` | Stocks de un pais | | `sector SECTOR` | `quote_basic` | Stocks de un sector | | `market MARKET` | `quote_basic` | Listar mercado completo |

Symbol Search v3 (1 endpoint, 1 modo)

`GET https://symbol-search.tradingview.com/symbol_search/v3/`

| Modo | Descripcion | |------|-------------| | `search QUERY` | Busqueda global con ISIN, CUSIP, CIK, logoid, exchange |

News API (1 endpoint, 3 modos)

`GET https://news-headlines.tradingview.com/v2/headlines`

| Modo | Descripcion | |------|-------------| | `news SYM` | Headlines de un simbolo (hasta 200 items) | | `news-global` | Headlines globales del mercado (hasta 200 items) | | `story STORY_PATH` | Detalle/body de una noticia (scraping HTML) |

HTML Scraping (1 endpoint, 1 modo)

`GET https://es.tradingview.com/symbols/{EX}-{SYM}/{path}/`

| Modo | Descripcion | |------|-------------| | `subpage SYM PATH` | Fetch HTML + extrae bloques `prs.init-data+json` |

Catalogos locales (3 modos)

| Modo | Descripcion | |------|-------------| | `columns [GROUP]` | Listar columnas (todas o un grupo concreto) | | `groups` | Listar bundles pre-armados | | `markets` | Listar mercados validos |

Combinado (1 modo)

| Modo | Descripcion | |------|-------------| | `all SYM` | Co