tradingview-news-feed 是 TradingView 官方新闻流 API 的 Python 客户端封装，支持按交易标的、市场类型等多维度过滤新闻，提供同步/异步调用方式，本文档包含项目介绍、安装指南、使用说明与API参考。
tradingview-news-feed 是 TradingView 新闻流 API 的 Python 客户端库，封装了官方新闻接口的请求逻辑与数据解析，支持多维度新闻过滤与类型安全返回，可降低开发者对接 TradingView 新闻数据的开发成本。
tradingview-news-feed 是 TradingView 新闻流 API 的官方 Python 客户端封装库，当前版本 0.1.2，由 Siddhesh Agarwal 开发维护。该库直接对接 TradingView 官方新闻流接口 https://news-mediator.tradingview.com/news-flow/v2/news，为 Python 开发者提供标准化的新闻数据获取能力，无需自行逆向接口或处理底层请求逻辑。项目托管于 GitHub，官方 API 参考文档托管于 GitHub Pages，支持通过 PyPI 或 GitHub 源码两种方式安装。
开发者自行对接 TradingView 新闻流 API 时，通常需要逆向分析接口参数、手动拼接请求参数、处理非结构化的响应数据，开发成本高且容易出现参数错误、解析异常等问题。tradingview-news-feed 封装了所有底层请求逻辑与参数拼接规则，提供类型安全的返回模型，开发者无需关心接口细节，即可直接获取结构化的新闻数据，大幅降低对接成本与出错概率。
该库适用于需要获取 TradingView 官方新闻数据的各类 Python 开发场景：1. 量化交易策略开发中，获取持仓标的相关的新闻舆情数据，作为策略决策的参考维度；2. 金融资讯聚合工具开发，接入 TradingView 官方新闻源，丰富资讯内容；3. 个人开发者搭建交易辅助工具，获取实时市场新闻推送。从当前仓库信息可见，该库目前仅支持新闻流数据的获取，未提供新闻分析、存储等额外能力。
该库支持两种安装方式：1. 通过 PyPI 安装稳定版，执行命令 pip install tradingview-news-feed 即可完成安装，适合大多数生产环境使用；2. 从 GitHub 源码安装最新开发版，执行命令 pip install git+https://github.com:Siddhesh-Agarwal/tradingview-news-feed.git 即可拉取最新代码安装。仓库中未明确给出本地开发环境的安装步骤与依赖配置说明。
使用该库获取新闻数据分为三步：1. 导入客户端类：from tradingview import TradingViewNewsFeed；2. 实例化客户端，可按需传入过滤参数，例如指定交易标的 symbol="NSE:TCS"、指定市场类型 markets=["stock"] 等；3. 调用 fetch() 方法获取 Feed 类型的新闻结果，遍历 result.items 即可获取单条新闻的标题、发布时间等字段。该库同时提供异步方法 fetch_async()，支持在异步上下文中调用。
1. 依赖要求：生产环境仅依赖 httpx（>=0.28.1）与 pydantic（>=2.13.4），开发依赖包含 ruff、ty 代码规范与类型检查工具；2. 默认参数：客户端内置默认请求参数 lang=en、client=screener、streaming=false、user_prostatus=non_pro，无需手动配置；3. 类型安全：所有新闻数据与过滤参数均基于 pydantic 实现类型定义，返回结构化模型，避免手动解析错误；4. 仓库中未明确给出错误处理、请求限流、代理配置等高级用法的说明。
它是 TradingView 新闻流 API 的 Python 客户端库，封装了官方新闻接口的请求与解析逻辑，开发者可快速获取结构化的 TradingView 新闻数据。
支持两种安装方式：通过 PyPI 安装稳定版执行 pip install tradingview-news-feed，或从 GitHub 源码安装最新版执行 pip install git+https://github.com:Siddhesh-Agarwal/tradingview-news-feed.git。
支持按经济分类、新闻优先级、交易标的（EXCHANGE:TICKER 格式）、市场类型、市场所属国家、行业板块等多维度过滤新闻，也可使用客户端内置的默认过滤参数。
根据 pyproject.toml 配置，要求 Python >=3.11；官方 API 参考文档中标注要求 Python 3.14+，实际版本要求以项目最新配置为准。
支持，客户端提供了 fetch_async() 异步方法，可在异步上下文中调用获取新闻数据，同步调用使用 fetch() 方法即可。