OpenBB-finance/OpenBB · 上手攻略

  • 仓库：OpenBB-finance/OpenBB
  • 链接：https://github.com/OpenBB-finance/OpenBB
  • 分类：Finance · AI / Data Platform
  • 作者：Tom
  • 更新：2026-08-17

这是什么

OpenBB Open Data Platform（ODP）是面向金融分析师、量化交易员和 AI Agent 的开源数据集成平台。它的核心定位是"连接一次，多处消费"的数据中间件层：连接股票/加密/宏观/情绪等数据源，通过 Python SDK、CLI、REST API、MCP Server 等多种接口输出，供 AI Copilot、研究仪表盘和 Excel 等下游应用消费。

简单说：Bloomberg Terminal 的数据层，开源版本，AI Native。

解决什么问题

金融数据的获取和清洗一直是工程负担：多个数据源（Yahoo Finance、SEC、Polygon、FRED 等）API 各不相同，数据格式不统一，rate limit 处理、缓存、更新调度都要自己写。OpenBB 将这些全部封装成统一接口：

  • 分析师：不需要写代码，直接用 OpenBB Workspace（Pro 版）拖拽出图表，连接 Python 环境或 Excel 做二次分析。
  • 量化/数据工程师：Python SDK 统一所有数据源，.to_dataframe() 直接拿 Pandas，不用管底层来源。
  • AI Agent：通过 MCP Server（agents-for-openbb）让大模型直接调用金融数据工具，实现"用自然语言查财务数据"的工作流。

快速安装

Python SDK（最常用）

pip install "openbb[all]"      # 全量依赖
# 或
pip install openbb              # 基础版，按需安装各 provider 扩展

验证安装：

from openbb import obb
output = obb.equity.price.historical("AAPL")
df = output.to_dataframe()
print(df.tail())

⚠️ Python 版本要求：3.9.21 ~ 3.12（README 原文标注，3.9 以下或 3.13+ 未测试）。

CLI

pip install openbb-cli
openbb-api          # 启动 FastAPI 服务器在 127.0.0.1:6900

OpenBB Workspace（Pro）

需要同时： 1. pip install "openbb[all]" 2. openbb-api 启动本地后端 3. 登录 https://pro.openbb.co/ → Apps → Connect backend → 填写 http://127.0.0.1:6900 → Test → Add

开发版 / 从源码

git clone https://github.com/OpenBB-finance/OpenBB.git
# 参考 docs.openbb.co/python/installation 完整说明

核心用法

Python SDK 基本模式

from openbb import obb

# 股票价格历史
df = obb.equity.price.historical("AAPL", start="2024-01-01", end="2024-12-31").to_dataframe()

# 财务指标
df = obb.equity.metrics("AAPL").to_dataframe()

# 加密数据
df = obb.crypto.price.historical("BTC", start="2024-01-01").to_dataframe()

# 宏观经济
df = obb.economy.macro("GDP", countries=["USA", "CHN"]).to_dataframe()

# 新闻/情绪
news = obb.news("NVDA", provider="benzena").to_dataframe()

所有 obb.<asset>.<data_type> 接口返回统一的 obb.core.QueryResults 对象，调用 .to_dataframe() 即得 Pandas DataFrame。

MCP Server（AI Agent 集成）

通过 agents-for-openbb 仓库（https://github.com/OpenBB-finance/agents-for-openbb）接入 AI Agent：

# 参考 agents-for-openbb README 配置 MCP server
# 接入后 AI Agent 可直接用自然语言查询金融数据

REST API

openbb-api 启动后，FastAPI 文档在 http://127.0.0.1:6900/docs，可直接在此尝试各接口。

典型适用场景

  1. 个股研究：一个 Notebook 里调 AAPL 历史价格 + 财务指标 + 分析师评级 + 宏观对比。
  2. 量化因子挖掘：Python SDK 批量拉取数据，用 Pandas/Polars 构建因子库。
  3. AI Copilot 金融助手：接入 MCP Server，大模型直接查实时股价、财报、宏观经济数据。
  4. Excel 联动：OpenBB Workspace → Excel，数据更新后 Excel 实时刷新。
  5. 加密+股票统一视图：一个 SDK 拉加密货币和传统资产数据，无需切换 API。

坑与注意

  1. 数据准确性免责：README 明确声明"The data contained in the Open Data Platform is not necessarily accurate."——金融数据需要自行核实，不要未经校验直接用于交易决策。
  2. 免费数据源有 rate limit：公共数据源（如 Yahoo Finance）无 Key 情况下有限速，正式使用建议配置各 provider 的 API Key。
  3. Provider 依赖：部分高级数据（SEC filings、Wall Street Journal 等）需要对应 provider 的商业授权，不是开箱即用。
  4. 企业版与开源版区别：OpenBB Workspace（可视化 UI + AI Agent 功能）是 Pro 版（https://pro.openbb.co），开源版是纯数据 SDK。
  5. 安装体积：pip install "openbb[all]" 全量依赖较大，建议按需安装各 provider 扩展（openbb[equity]、openbb[crypto] 等）。
  6. 免责声明风险：Trading in financial instruments involves high risks——README 有完整免责声明，工程层面无法控制用户如何使用数据。

与同类对比

平台 数据覆盖 开源 AI Native 目标用户
OpenBB ODP 股票+加密+宏观+情绪 ✅ ✅ MCP Server 分析师/Quant/AI Agent
Bloomberg Terminal 全（最全） ❌ 有限 专业机构
Yahoo Finance API 基础 ❌ 需自己封装 个人
YFinance（Python） 基础 ✅ 否 个人快速查询
Twelve Data 股票+加密 ❌ API 为主 量化/开发者

OpenBB 的核心差异：开源 + 统一 SDK + MCP Server，是唯一一个同时对分析师（可视化）和开发者（Python API）和 AI Agent（MCP）都提供原生支持的金融数据平台。

一句话推荐

需要免费/开源金融数据做研究或接入 AI 助手？OpenBB ODP 是目前最完整的开源方案：pip 安装、统一 Python SDK、MCP Server 支持，上游对接 50+ 数据源，适合个人研究到 AI Copilot 生产的全场景。