TradeAlpha 金融数据 API｜新闻与研报语义检索说明

了解 TradeAlpha 新闻与研报语义检索 API 的地址、参数、时间筛选与返回字段，并区分直接 API 调用和 MCP 接入方式。

更新日期：2026-10-26

选择 API 或 MCP 接入

直接调用 API 时，下方两个接口均通过 JSON 请求体的 token 字段认证。通过 MCP 客户端连接时，使用 https://finmcp.lxaa.top/mcp 和 Bearer 请求头，工具参数以客户端实际列出的定义为准。

本文依据开放平台维护的接口文档整理。以下 JSON 仅是请求参数示例，不是实时查询结果；需要自己的 Token 和对应接口权限。不要在公开链接或示例中填入真实 Token。

在开放平台查看当前接口文档

新闻语义检索

POST https://openapi.lxaa.top/api/v1/news/news_vector_search

使用自然语言寻找语义相关的新闻，结果按相似度排序。它与按时间翻页的新闻列表不同，不使用页码分页。

新闻语义检索的主要请求参数
参数	说明
token / keyword	必填：开放平台 API Token 与自然语言检索语句。
top_k	候选条数，默认 20，范围 1–50；筛选后实际返回条数可能更少。
start_time / end_time	可选时间范围。需要检索指定时期时显式传入；不传时不会按这两个参数限定时间。支持 YYYY-MM-DD 或 YYYY-MM-DD HH:mm:ss。
source / category / level	可选来源、分类和重要程度筛选，枚举值见当前接口文档。

请求参数示例

{
  "token": "<API_TOKEN>",
  "keyword": "美联储利率变化对市场的影响",
  "top_k": 10
}

响应包含 code、message 和 data。新闻在 data.list 中，包含时间、正文、来源、分类和重要程度；应结合来源与时间核对内容，而不是将相似度顺序当作发布时间顺序。

研报语义检索

POST https://openapi.lxaa.top/api/v1/research-reports/vector_search

按主题、公司、事件或产业链检索相关研报正文片段。查询公司时，使用中文名称或常用简称，而不是只输入数字股票代码。

研报语义检索的主要请求参数
参数	说明
token / keyword	必填：API Token 与检索语句。
top_k	返回相似片段数量，默认 10，范围 1–50。
recent_days	最近 N 天，范围 1–3650；显式传入 start_date 时优先使用 start_date。
start_date / end_date	可选日期范围，支持 YYYY-MM-DD 或 YYYYMMDD。
return_fields	选择返回字段，例如标题、日期、摘要、命中片段与原文链接。

请求参数示例

{
  "token": "<API_TOKEN>",
  "keyword": "AI 算力产业链的投资机会和风险",
  "top_k": 10,
  "recent_days": 90,
  "return_fields": [
    "report_id",
    "matched_content",
    "date",
    "title",
    "summary",
    "url"
  ]
}

响应的 data.items 返回匹配片段，字段由 return_fields 决定。可结合 title、date、matched_content 与 url 核对研报原文和发布时间。

如何判断查询是否有效

先检查 HTTP 状态和业务响应的 code、message，再查看是否有匹配数据。空结果不等于接口失效，应继续检查查询词、时间范围和账号权限。

新闻与研报是研究材料，语义相关不等于事实已被核实，也不构成投资结论。进一步分析时保留原始来源与日期，区分资料内容和自己的判断。