xfinlab

XFINLAB

金融智能基础设施——为开发者和 AI Agent 提供 API、SDK 和 MCP 服务，同时提供基于同一后端构建的消费者研究平台。

真实市场事件、FinBERT 情绪分析、技术面／市场结构分析、SEC/CFTC/FDIC/USDA/CBOE 官方数据，以及蒙特卡洛压力测试。每个字段都可追溯到真实计算或官方数据源——绝不捏造或插值。

架构 · 获取免费 API 密钥 · API 文档 · llms.txt · 消费者产品

快速开始（API）

pip install "git+https://github.com/lnanology/Xfinlab.git#subdirectory=sdk/python"

from xfinlab_intelligence import XfinlabClient

client = XfinlabClient(api_key="xfl_...")  # free tier, issued instantly
sentiment = client.sentiment("AAPL")
technical = client.technical("AAPL", period="6mo")
fundamentals = client.fundamentals("AAPL")

也可使用 JavaScript/Node：

npm install "github:lnanology/Xfinlab#path:sdk/js"

const { XfinlabClient } = require('xfinlab-intelligence');
const client = new XfinlabClient('xfl_...');
const sentiment = await client.sentiment('AAPL');

共 19 个端点——市场事件、情绪分析、AI 辩论、技术面／市场结构分析、蒙特卡洛压力测试、内幕交易、机构持仓、卖空兴趣、SEC XBRL 基本面数据、CBOE VIX 期限结构、FDIC 银行健康状况、USDA 农业、EIA 能源、加密货币、跨区域市场地图，以及 Pro 级 Webhook。完整参考：intelligence-api.html。

MCP 服务（适用于 Claude 和其他 AI Agent）

此服务返回的每个字段要么来自真实计算／真实官方来源，要么为附带说明的 null——如今 MCP 生态中服务众多，但很少有服务会说明工具调用背后数据的实际质量。本服务会公开说明：xfinlab.com/trust.html 实时显示每个底层数据采集器的运行／宕机状态。

已在生产环境上线——无需设置，只需将兼容 MCP 的客户端指向此服务：

{
  "mcpServers": {
    "xfinlab": {
      "url": "https://api.xfinlab.com/api/mcp",
      "headers": { "X-API-Key": "xfl_..." }
    }
  }
}

托管服务（服务实现为专有，运行于 api.xfinlab.com）。工具（6 个）：get_market_events、get_sentiment、get_technical_analysis、get_intelligence_feed、get_global_market_map、get_fundamentals_as_of（特定时间点的 SEC 基本面数据）。与 REST API 使用相同的身份验证方式和免费额度。文档：intelligence-api.html#mcp。

生产环境使用情况

早期阶段的真实数据 — 于 2026-09-22 从平台自身的管理指标中提取，并非为了效果而筛选。此处不会公开个人邮箱，尽管这些地址在管理面板中可见 — 没有理由在公开的 README 中暴露真实用户的邮箱地址。

• 自推出自助免费套餐以来，已发放 15 个 API 密钥（14 个有效，1 个已撤销），约有 13 位不同的外部开发者／研究人员使用 — 不包括运营者自己的测试密钥，该密钥调用量为 0，因此以下所有流量都不是自测产生的。
• 累计处理 669 次加权 API 调用，主要来自少数真实集成：调用量最高的单个账户占累计总量的一半以上，第二高的账户约占五分之一。
• 一位注册用户使用了 .edu 邮箱 — 这是学术／研究兴趣的早期微弱信号，而不只是随意试用。
• 消费者研究网站（xfinlab.com）上有 5 个自然增长账户，与上述仅使用 API 注册的账户分开统计。总计注册的 7 个账户中，2 个是运营者自己的账户和内部 LINE 机器人集成，并非外部用户 — 统计时不计入。
• 此处未公布响应时间或正常运行时间 SLA 指标 — 目前实际上尚未测量，而且本项目对自己也执行面向用户宣传的同一项零捏造政策，因此不会为了案例研究凭空编造未经测量的数据。各数据源的状态（而非逐个请求的延迟）可在同一页面实时查看。

发现了两个真实问题，并且都在发现当天修复：

• SEC Form 4 误报（2026 年 9 月）。 SEC EDGAR 自带的 browse-edgar type 筛选器原来表现为前缀通配符，而非精确匹配 — type=4 会悄无声息地将不相关的 424B 系列申报匹配为“内幕交易”动态。这个问题由平台自身的数据源健康告警发现（并非用户提交的错误报告），并通过 SEC 的实时响应确认 — SEC 自己的分页链接会将 type=4 重写为 type=4%25，这才暴露了问题。
• 时点／版本数据存储（2026 年 9 月）。 一位量化研究人员在 r/quant 上的评论指出，将申报的期末日期视为“该日期已知”会忽略实际申报延迟和后续重述 — 这是回测中常见的前视偏差来源。我们构建了一个专用的（专有）存储，其中每个基本面数据值都带有真实的申报可用时间戳，而不是其描述的期间；重述值则作为新的不可变行存储，而非覆盖原始值 — 因此，“日期 X 时我们知道什么”和“目前已知的最新值”是两个不同但都正确的查询。

SDK 和示例

Python SDK	sdk/python — README
JavaScript/Node SDK	sdk/js — README
快速入门脚本	sdk/examples/python_quickstart.py、sdk/examples/js_quickstart.js
OpenAPI 规范	https://api.xfinlab.com/api/intelligence/openapi.json
Postman 集合	https://api.xfinlab.com/api/intelligence/postman.json

两个 SDK 均采用 MIT 许可证（sdk/LICENSE），除标准库／原生 fetch 外没有任何必需依赖。

消费者产品

同一后端也为 xfinlab.com 提供支持，这是一个面向散户的投资研究平台：

模块	路径
首页	index.html
AI Market Research™	ai-analysis.html
Chart Research™	chart-analysis.html
Company Compare™	company-compare.html
Event Intelligence™	news-denoise.html
Risk Engine™	stress-lab.html

本地开发

python3 mock-server.py

然后打开 http://localhost:8080。生产后端是一个独立的私有服务（部署为 api.xfinlab.com）；上方的静态网站则单独部署在 Vercel，域名为 xfinlab.com。

更多文档

• XFINLAB_ARCHITECTURE.md — 完整的系统架构
• PROJECT_ROADMAP.md — 项目路线图
• PROJECT_STYLE_GUIDE.md — UI 风格指南
• DATA-LICENSE-MATRIX.md — 每个付费端点对应的上游数据源许可信息
• MCP_MARKETPLACE_SUBMISSION.md — MCP 服务目录提交文案