deepentropy/tvscreener

这是什么？

核心功能

• 01覆盖股票、ETF、加密货币、外汇、债券、期货、币种、指数和经济数据等筛选器
• 02支持 OR 与嵌套过滤条件及 has()、above_pct() 等运算符
• 03提供财务报表、公司事件和季节性收益数据
• 04支持获取 TradingView 推送的实时报价
• 05可获取新闻、披露文件和财报电话会议文字稿
• 06结果以 Pandas DataFrame 返回，并支持定时刷新

适用场景

• 在 Jupyter 中按估值、股息或动量指标筛选股票
• 定时刷新数据，监控加密货币或外汇的涨跌变化
• 拉取财务报表和财报日历用于研究分析
• 通过 MCP 服务器让 AI 助手调用筛选器数据

快速上手

1. 1

   从 PyPI 安装该库

   pip install tvscreener
2. 2

   导入库并运行基础股票筛选查询

   python -c "import tvscreener as tvs; df = tvs.StockScreener().get(); print(df.head())"

使用前须知

• !这是非官方的第三方库，与 TradingView 没有任何关联。
• !使用需遵守 TradingView 的服务条款，且若 TradingView 更改数据可能导致功能失效。

标签

常见问题

tvscreener 是什么？

非官方 Python 库，可将 TradingView 的股票、加密货币、外汇等筛选器数据获取为 Pandas DataFrame。 tvscreener 是一个用于获取 TradingView 筛选器数据的 Python 客户端。它支持股票、ETF、加密货币、外汇、债券、期货、币种、指数和经济指标等多类筛选器，可按字段、市场、国家等条件过滤，并以 Pandas DataFrame 返回结果。

tvscreener 可以免费使用吗？用的什么许可证？

tvscreener 以 Apache-2.0 许可证开源。用于商业产品前，请先确认许可证条款。

tvscreener 还在维护吗？

活跃维护中。tvscreener 最近一次提交是在 2026年11月1日。

tvscreener 适合用来做什么？

在 Jupyter 中按估值、股息或动量指标筛选股票 定时刷新数据，监控加密货币或外汇的涨跌变化 拉取财务报表和财报日历用于研究分析 通过 MCP 服务器让 AI 助手调用筛选器数据

tvscreener 怎么安装和运行？

从 PyPI 安装该库: pip install tvscreener 导入库并运行基础股票筛选查询: python -c "import tvscreener as tvs; df = tvs.StockScreener().get(); print(df.head())"

在哪里获取 tvscreener？

源代码和安装说明在 GitHub 上：https://github.com/deepentropy/tvscreener