# deepentropy/tvscreener

TradingView Screener API - Stock, Crypto, Forex, Bond, Futures, Coin

Repository: https://github.com/deepentropy/tvscreener
Canonical: https://ross.abutalabs.com/products/tvscreener
Language: JavaScript
License: Apache-2.0
License Family: permissive
Topics: quantitative-finance, technical-analysis, tradingview
Last push: 2026-07-13T14:45:35+00:00

## Health v2 (maintenance only)
Score: 84/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 92, release rhythm 77, longevity 80
- inputs: {"age_days": 1127, "days_push": 51, "days_rel": 158, "gap_med": 19.5, "n_releases_24m": 7}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1456, forks 201 (observed 2026-08-28T04:04:46.893325+00:00)

## What it is
An unofficial Python library wrapping TradingView's Screener API to query stocks, crypto, forex, bonds, futures, and coins, returning results as Pandas DataFrames. It also ships an MCP server so AI assistants like Claude can run screener queries directly.

## Use cases
- screen stocks by technical indicators from TradingView
- get top crypto gainers and losers as a pandas dataframe
- query forex and bond market data in python
- let Claude query market data via MCP
- build custom screener filters across 13000+ fields
- fetch futures contract data for quantitative analysis

## When to choose
- you want TradingView screener data in Python/Pandas without scraping
- you need broad asset-class coverage including bonds, futures, and DEX coins
- you want an MCP server to expose market screening to AI assistants

## When to avoid
- you need an official or guaranteed-stable TradingView integration
- you need real-time streaming or order execution rather than screener snapshots
- your project is JavaScript-based and you can't use the Python package

## Facets
- artifact type: library
- maturity: active
- function: http-client, data-science, sdk, mcp
- domain: fintech, data-science, apis
- platform: python, cross-platform
- tags: tradingview, screener, market-data, technical-analysis, quantitative-finance, pandas, stocks, crypto, forex, mcp-server, trading

## Member repositories
- deepentropy/tvscreener (main) score 84

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:46.893325+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:35:36.421482+00:00, confidence not recorded.
  - readme: https://github.com/deepentropy/tvscreener (fetched 2026-08-28T04:04:46.893325+00:00, sha cd0b9c433aad)
- Data as of 2026-08-30T08:39:29.467469+00:00.