finlight API 能做什么

finlight 是一个金融新闻 API。它把持续不断、杂乱无章的全球市场新闻整理成干净、结构化、经过 AI 增强的数据，让你可以查询、流式接收，或让数据主动推送给你。你不必再自己抓取网页、解析 HTML，而是通过一个统一的接口获得内置的情绪分析、公司标注和丰富的过滤能力。

本页是一张地图，介绍 finlight 能为你提供什么、四种获取数据的方式，以及接下来该去哪里。如果你只想先完成第一次调用，请从快速入门指南开始。

每篇文章包含什么

finlight 返回的每篇文章都是结构化并经过增强的，而不仅仅是一个标题加一个链接。你会得到：

核心字段： 标题、摘要、完整正文（可选）、来源、发布日期、语言和图片。
情绪： 每篇文章都会被评为 positive、neutral 或 negative，并附带置信度分数，让你能够量化情绪倾向，而不必逐篇阅读。
公司实体： finlight 会标注文章所涉及的公司，并将其解析为真实标识符：股票代码、ISIN、OpenFIGI、所属板块与行业，以及该公司挂牌的每一个交易所（主要与次要上市信息，各自附带交易所代码和国家）。
分类： 每篇文章都会标注其影响的国家，以及 13 个分类中的一个或多个。

这意味着你可以回答诸如“本周 AAPL 的情绪如何变化？”或“给我看影响某组公司的所有监管类新闻”这样的问题，而无需自己搭建 NLP 流水线。

四种获取数据的方式

同一份增强数据可以通过四种交付方式获取。你可以选择最适合自己工作负载的那一种。

REST API

按需查询新闻：发送一个请求，返回一页匹配的文章。最适合搜索、回填历史数据、定时刷新的仪表盘，以及任何请求/响应式的工作流。高级的 POST /v2/articles 端点支持完整的过滤条件，此外还有按 URL 获取单篇文章和列出可用来源的端点。详见 REST 文档。

WebSocket

在文章发布时实时推送，无需轮询。它有两种形式：带完整增强（情绪与实体）的增强版数据流，以及只需要快速获取基础数据时使用的轻量原始数据流。非常适合实时仪表盘、交易信号和监控场景。详见 WebSocket 文档。

Webhooks

让 finlight 在新闻匹配你的过滤条件时，主动把它推送到你自己的接口。提供增强版和原始版两种形式，且每次推送都带有签名，便于你验证。最适合事件驱动的流水线、告警，以及无需轮询即可运行的自动化。详见 webhook 文档。

MCP 服务器

通过 Model Context Protocol 把 finlight 接入 Claude 或 ChatGPT 等 AI 助手，然后用自然语言查询市场新闻。最适合无需写代码的研究和临时分析。详见 AI 助手文档。

经验法则：按需用 REST，实时用 WebSocket，推送自动化用 webhooks，AI 驱动的研究用 MCP。一篇专门的对比指南即将推出。

精确过滤

finlight 的核心理念就是让你精确获取想要的新闻。在 REST、WebSocket 和 webhooks 中，你都可以按以下条件过滤：

股票代码： 如 AAPL 或 NVDA 等公司。
国家： ISO 国家代码，用于聚焦特定市场。
分类： 13 个分类中的任意一个，从 markets、economy 到 crypto、regulation 和 energy。
来源： 包含或排除特定媒体，或额外选入更多来源。
日期范围以及完整的查询语言，支持布尔运算符和字段过滤，例如 (ticker:AAPL OR ticker:NVDA) AND NOT source:reuters.com。

完整的查询语法请见高级查询文档。

全球化、多语言覆盖

finlight 覆盖 9 种语言的新闻：英语、简体中文、印地语、西班牙语、日语、韩语、葡萄牙语、阿拉伯语和俄语。结合国家和分类过滤，你可以用某个市场自己的语言和地区来追踪它，而不必依赖只有英语的报道。

为开发者打造

你可以用纯 HTTP 调用 finlight，也可以使用官方 SDK：

Node / TypeScript： npm install finlight-client
Python： pip install finlight-client

两者都封装了 REST 和 WebSocket API，处理鉴权与重试，并返回带类型的对象。鉴权只需在每次请求中携带一个 X-API-KEY 请求头，密钥在控制台生成。一个最简请求如下所示：

curl -X POST https://api.finlight.me/v2/articles \
  -H "X-API-KEY: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "tickers": ["AAPL"], "pageSize": 5 }'

套餐

finlight 提供从用于测试的免费套餐到企业版的多种套餐，主要区别在于请求量、历史数据深度、实时访问，以及自定义来源等功能。免费套餐仅支持 REST，非常适合用于评估。各套餐的具体限额和解锁的功能，请见 finlight.me/pricing。

开始构建

第一次使用？跟随快速入门指南，五分钟内完成第一次调用。
想深入了解？浏览完整文档。
有问题？加入 Discord 或发送邮件至 info@finlight.me。

获取免费 API 密钥 →

Monday, June 22, 2026

finlight API 能做什么：完整概览