finlight 金融新闻 API 快速入门

实时金融新闻往往杂乱无章：来源众多、格式各异、缺乏结构，也没有信号。finlight 把这股信息洪流整理成 干净、结构化、经过 AI 增强的数据，让你用一次请求即可查询，并附带情绪分析以及每条新闻所涉及的公司。

本指南将带你在大约 五分钟内完成第一次 API 调用。读完之后，你将拉取到某只股票的最新新闻、读懂 返回结果，并了解如何开启实时数据流。

你能获得什么

finlight 是一个金融新闻 API，提供四种方式来获取同一份增强数据：

• REST. 按需查询新闻（本指南）。
• WebSocket. 在文章发布时实时推送。
• Webhooks. 将新闻推送到你自己的接口。
• MCP 服务器. 让 AI 助手（Claude、ChatGPT）替你查询新闻。

每篇文章返回时都是结构化并经过增强的，包含：

• 情绪（positive、neutral 或 negative）以及置信度分数。
• 公司实体： 股票代码、ISIN、交易所上市信息、所属板块与行业。
• 覆盖 9 种语言 和 13 个分类（市场、经济、加密货币、科技等）。

第 1 步：获取 API 密钥

1. 在 app.finlight.me 免费注册账号。
2. 打开控制台并生成 API 密钥。
3. 妥善保管。每次请求都需要在 X-API-KEY 请求头中携带它。

免费套餐仅支持 REST，非常适合用于测试。各套餐的具体限额和功能请见 finlight.me/pricing。

第 2 步：安装客户端（可选）

你可以直接用纯 HTTP 调用 API，不过官方 SDK 会帮你处理鉴权、重试和类型。

# TypeScript / Node.js
npm install finlight-client

# Python
pip install finlight-client

更喜欢用原生 HTTP？可以跳过这一步。下面每个示例都附有 cURL 版本。

第 3 步：你的第一次请求

让我们获取关于 苹果（AAPL） 的最新文章。这会调用 POST /v2/articles，并使用 tickers 过滤条件。

# cURL
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
  }'

// TypeScript
import { FinlightApi } from 'finlight-client';

const client = new FinlightApi({ apiKey: 'YOUR_API_KEY' });

const response = await client.articles.fetchArticles({
  tickers: ['AAPL'],
  pageSize: 5,
});

console.log(`Got ${response.articles.length} articles`);
for (const article of response.articles) {
  console.log(article.publishDate, article.sentiment, article.title);
}

# Python
from finlight_client import FinlightApi, ApiConfig
from finlight_client.models import GetArticlesParams

client = FinlightApi(config=ApiConfig(api_key="YOUR_API_KEY"))

response = client.articles.fetch_articles(
    GetArticlesParams(tickers=["AAPL"], pageSize=5)
)

print(f"Got {len(response.articles)} articles")
for article in response.articles:
    print(article.publishDate, article.sentiment, article.title)

第 4 步：读懂返回结果

返回结果是一个分页信封。每篇文章都包含来源、标题、摘要和增强信息：

{
  "status": "ok",
  "page": 1,
  "pageSize": 5,
  "articles": [
    {
      "link": "https://www.example.com/apple-earnings",
      "title": "Apple beats expectations on services revenue",
      "summary": "Apple reported quarterly results above analyst estimates...",
      "source": "www.example.com",
      "publishDate": "2026-06-18T14:32:00.000Z",
      "language": "en",
      "sentiment": "positive",
      "confidence": "0.93",
      "images": ["https://www.example.com/img/apple.jpg"]
    }
  ]
}

通过两个开关，你可以在需要时获取更多内容：

• includeContent: true 返回抓取到的完整文章正文，而不仅仅是摘要。
• includeEntities: true 为每篇文章返回 companies 数组（股票代码、ISIN、交易所上市信息）。

提示：在轻量的列表视图中保持 includeContent 和 includeEntities 关闭，只在需要详情时才打开。 这样能让返回结果更小、更快。

第 5 步：开启实时数据（当你准备好时）

刚开始用轮询没问题，但对于实时仪表盘和交易信号，你会希望新闻在发布的那一刻就被推送过来。这正是 WebSocket 的作用：过滤条件相同，无需轮询。

// TypeScript
import { FinlightApi } from 'finlight-client';

const client = new FinlightApi({ apiKey: 'YOUR_API_KEY' });

client.websocket.connect({ tickers: ['AAPL'] }, (article) => {
  console.log('New article:', article.sentiment, article.title);
});

WebSocket 流式传输在付费套餐中提供。完整配置请见 WebSocket 文档。

下一步

你已经完成了第一次调用，并了解了数据的结构。接下来：

• 阅读完整 API 文档，了解各端点、参数，以及 WebSocket 和 webhook 指南。
• 学习高级过滤。 组合股票代码、国家、分类和查询语言，精确获取你想要的新闻*（文章即将推出）*。
• 比较套餐，当你准备好超越免费套餐时。

有问题？加入 Discord 或发送邮件至 info@finlight.me。

免费开始构建 →