finlight Logo

Thursday, July 16, 2026

正确使用股票代码与交易所（finlight API）

Kevin Bartsch
TutorialGuide

正确使用股票代码与交易所（finlight API）

按股票代码过滤新闻听起来很简单，直到你撞上现实：同一个代码在不同交易所可能代表不同的公司，而同一家 公司在全球又可能以多个代码交易。一旦弄错，你的“苹果”新闻流就会悄悄混入错误的报道。

finlight 通过把每一家被标注的公司解析为真实、无歧义的标识符来解决这个问题。本指南将演示如何按股票 代码过滤，以及如何读取这些标识符，从而始终精准定位到正确的公司。

按股票代码过滤

最快的方式是使用结构化的 tickers 过滤：

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

注意 includeEntities: true。它告诉 finlight 为每篇文章返回解析后的公司数据，而这正是你用来确认匹配 到正确公司的依据。

读取解析后的实体

开启 includeEntities 后，每篇文章都会带有一个 companies 数组。单家公司的结构如下：

{
  "companyId": 320,
  "name": "Apple Inc.",
  "ticker": "AAPL",
  "confidence": "0.98",
  "isin": "US0378331005",
  "openfigi": "BBG000B9XRY4",
  "sector": "Technology",
  "industry": "Consumer Electronics",
  "primaryListing": {
    "ticker": "AAPL",
    "exchangeCode": "NASDAQ",
    "exchangeCountry": "US"
  },
  "otherListings": [
    { "ticker": "APC", "exchangeCode": "XETRA", "exchangeCountry": "DE" }
  ]
}

有几个字段是关键：

  • primaryListing 是公司的主要上市，包含其 exchangeCode 和 exchangeCountry。
  • otherListings 包含所有次要上市。你可以由此看到，苹果在德国 XETRA 还以 APC 交易。
  • isin 和 openfigi 是全球唯一标识符。与单纯的股票代码不同，它们精确指向唯一的证券，因此非常 适合用来与你自己的数据匹配。
  • confidence 告诉你 finlight 有多确信这篇文章确实是关于这家公司的。

用精确条件消除歧义

当单纯的股票代码存在歧义时，用查询语言缩小范围。 你可以按交易所或唯一标识符过滤：

ticker:AAPL AND exchange:NASDAQ

isin:US0378331005

按 isin 或 openfigi 过滤可以彻底消除歧义，因为无论公司以多少个代码交易，它们都只解析到唯一的证券。

一个实用模式

在处理投资组合或自选股时，用你最信任的标识符来匹配：

  1. 如果你只有股票代码，发送 tickers 并开启 includeEntities，然后确认 primaryListing 与你预期的 交易所一致。
  2. 如果你有 ISIN 或 OpenFIGI，用查询中的 isin: / openfigi: 进行精确匹配。
  3. 把 finlight 的 companyId 与你的记录一起存储，让以后的查找不再有歧义。

接下来去哪里

获取免费 API 密钥 →

Back to blog