6 min read

OpenTypeBB:一键接入 TypeScript 实现的开源彭博数据源

Source: http://x.com/i/article/2032448075630063616

导言

Image

OpenBB 是开源金融数据领域的标杆项目。但如果你实际试过部署 OpenBB Platform,你大概率经历过这些:Python 版本冲突、uv 装不上、依赖链断裂、Docker 镜像跑了十分钟还没 build 完。

另外,现在主流的 Agent 工程基本都是 Typescript 家族成员,比如大名鼎鼎的 OpenClaw。这意味着如果你需要单独跑一个 openbb 来获取数据,那么就需要额外配置一次 Python。实在太麻烦了。

OpenTypeBB 是 OpenBB Platform 的 TypeScript 原生移植,作为 OpenAlice 的内置包发布(

@traderalice/opentypebb

)。覆盖股票、加密货币、外汇、大宗商品、宏观经济、新闻六大类数据。

没有 Python,没有 sidecar,没有 Docker。

这篇教程尽力带大家把东西跑通,跑不通的记得问 AI。

GitHub: https://github.com/TraderAlice/OpenAlice

安装

需要 Node.js 22+ 和 pnpm 10+,没了。

git clone

https://github.com/TraderAlice/OpenAlice.git

cd OpenAlice pnpm install

安装完之后,build 一下

pnpm build

@traderalice/opentypebb

在 packages/opentypebb/ 下,monorepo workspace 会自动 link,不用额外操作。

启动

在 clone 的目录里直接运行以下命令,启动 OpenAlice。

pnpm dev

搞定。

OpenAlice 启动时会同时带起 OpenTypeBB 的 HTTP server。跑起来之后你有两个端口:

你可以访问到 http://localhost:3002/data-sources,然后看看情况。

如下图所示,特别是 Expose OpenBB HTTP API 开关要打开。这个打开了就没什么问题。

有时候可能这里需要重启进程才会生效,不理解的话让 AI 操作吧。

Image

试几个请求

server 暴露的是标准的 OpenBB REST 接口。直接 curl 试试:

# 健康检查 curl http://localhost:6901/api/v1/health # 拿 AAPL 的实时报价 curl "http://localhost:6901/api/v1/equity/price/quote?symbol=AAPL&provider=yfinance" # BTC 历史 K 线 curl "http://localhost:6901/api/v1/crypto/price/historical?symbol=BTC-USD&provider=yfinance"
Image

注意:以上全部用的 yfinance 不需要任何 API key。装完即用。

配置数据源 API Key(可选)

默认的 yfinance 覆盖了股票报价、加密货币、外汇和公司新闻,开箱即用。

如果你需要更深的基本面数据(财报、分析师预期等),可以接入 FMP、EIA 之类的付费数据源。

当然对于第一次使用的用户,我建议你们先跳过这里,先用上再说,毕竟配 Key 挺烦人的。

推荐通过 Alice 的前端界面来配置:打开 http://localhost:3002,进入设置面板,在数据源配置区域直接填入 API key。改完即时生效,不用重启。

Image

连接 OpenBB 原生前端

OpenTypeBB 的 HTTP server 兼容 OpenBB 的接口协议,可以直接接

OpenBB Workspace

作为可视化前端。

打开 OpenBB Workspace,在连接设置(Data Connectors)中添加一个 Custom Backend,地址填 http://localhost:6901:

Image

连接成功后,Workspace 会自动发现 OpenTypeBB 暴露的一堆 widget(通过 http://localhost:6901/widgets.json)。

你可以直接在 Workspace 里用图表看行情、查财报、浏览宏观数据——所有数据都从你本地的 OpenTypeBB 走。

Image

这意味着不需要 OpenBB 官方的 Python 后端,也能用上他们的前端产品,而且配置方法简单了无数倍。省心省力了。

接入 Alice

前面 pnpm dev 启动的时候,Alice 已经在跑了。

打开 http://localhost:3002,直接对话就行。

默认配置用 Claude Code 作为 AI 后端,OpenTypeBB 以 SDK 模式(in-process)提供数据,不需要额外配置。

Image

关于 Alice 的完整使用教程——怎么配置 AI provider、怎么自定义工具、怎么对接你自己的交易逻辑——下一篇再写。

能拿到什么数据

简单过一下 OpenTypeBB 目前支持的数据范围:

股票 — 实时报价、历史 K 线、公司概况、财务报表、分析师预期、财报日历、内部交易、机构持仓、涨跌幅榜

加密货币和外汇 — 实时价格、历史 K 线、多时间周期

技术分析 — 内置指标计算器,支持 SMA(CLOSE('AAPL', '1d'), 50)、RSI(CLOSE('BTC/USD', '1d'), 14) 这类公式表达式

宏观经济 — OECD/IMF 的 GDP 数据、FRED 经济序列(利率、通胀、就业)、PCE、CPI、非农、FOMC 纪要、密歇根大学消费者信心指数、费城联储制造业调查

大宗商品 — EIA 石油和天然气数据、现货商品价格

新闻 — 公司新闻、全球市场新闻、后台 RSS 采集 + 全文搜索

架构

核心设计就一句话:纯 TypeScript,in-process 调用,没有 HTTP 中间层。

当 Alice(或你的代码)请求数据时,调用链是这样的:

  • 请求 AAPL 报价
  • → QueryExecutor.execute('yfinance', 'EquityQuote', { symbol: 'AAPL' })
  • → YFinanceFetcher 直接请求 Yahoo Finance API
  • → 返回结构化数据

没有 HTTP hop,没有 Python 子进程,没有序列化/反序列化的开销。数据从源头到你的代码之间只隔一层 TypeScript 函数调用。

独立 server 模式(上面启动的那个)是在这个基础上套了一层 REST API,给需要 HTTP 接口的场景用——比如接 OpenBB Workspace,或者给其他语言的项目提供数据服务。

后记

openbb 移植的工作看起来是在造轮子,但对于OpenAlice 这样一个 Node 生态的项目来说,如果启动之前要先跑起来一个 Python 进程,简直就是双倍的工作量。无论从传播还是使用体验的角度,都是让人无法接受的。

所以我们做了这个工作,利人利己,还能顺手给这套开源金融数据源修修 bug 之类的,也算回馈社会了。

顺便说一句:OpenTypeBB 的移植是全自动跑的,不是手动逐行翻译。核心路径已经验证过,但一些边缘场景可能还没覆盖到。遇到问题直接提 issue,另外建议勤 git pull——说不定你下次更新的时候,上次碰到的 bug 已经顺手修了