OpenBB-finance / OpenBB

56,7715,520+436 todayPython

面向分析师、量化交易员和AI代理的金融数据平台

OpenBB是一个基于Python的开源金融数据平台，旨在为分析师、量化交易员和AI代理提供统一的数据接入与分析工具。其核心是Open Data Platform（ODP），能够整合来自专有、授权及公开市场的多种数据源，包括股票、加密货币、衍生品、固定收益等金融资产。通过“一次连接，多处使用”的架构，ODP将数据同时暴露给Python量化环境、OpenBB Workspace分析界面、AI代理的MCP服务器以及REST API，方便用户在不同场景下调用。用户可通过`pip install openbb`快速安装，并在本地启动后端服务，将数据无缝对接到OpenBB Workspace的可视化界面或自定义的AI辅助分析流程中。该项目降低了金融数据整合的复杂度，支持从基础研究到自动化交易策略开发的多种应用。

💡 应用场景

最适合需要统一接入多源金融数据并支持多种消费场景（Python分析、AI代理、可视化界面）的开发者和团队。

量化策略数据整合

问题：量化交易员需要从多个数据源（如股票、加密货币、期权）获取数据，但每个API接口不同，整合费时费力。

方案：使用OpenBB统一接入各类金融数据源，通过Python接口一次性获取标准化数据，节省数据整合时间。

示例：在Python中运行`openbb.equity.price.historical('AAPL')`获取苹果股价，同时用`openbb.crypto.price.historical('BTC')`获取比特币数据，无需分别处理不同API。

AI金融助手数据源

问题：开发金融AI助手时，需要为AI代理提供实时、准确的金融数据接口，但自行搭建数据管道复杂且维护成本高。

方案：将OpenBB作为MCP服务器，为AI代理提供标准化的金融数据查询接口，实现“一次连接，多处使用”。

示例：在OpenBB Workspace中连接本地ODP后端，AI助手可以直接查询股票基本面、期权链数据，用于生成投资分析报告。

分析师多平台数据同步

问题：金融分析师需要在Python、Excel和可视化仪表盘中使用同一套数据，但手动同步容易出错且效率低下。

方案：利用OpenBB的“连接一次，随处消费”架构，在Python中处理数据后，自动同步到OpenBB Workspace和Excel插件。

示例：在Python中计算股票技术指标，结果自动推送到OpenBB Workspace生成图表，同时通过Excel插件供团队其他成员使用。

金融数据应用快速原型

问题：想快速验证一个金融数据应用想法，但搭建完整的数据基础设施需要大量开发时间。

方案：使用OpenBB的REST API和Python SDK快速获取各类金融数据，专注于应用逻辑开发而非数据管道。

示例：启动本地ODP服务器（`uvicorn openbb_core.api.rest_api:app`），通过REST API快速构建一个期权波动率监控仪表盘原型。

📊 项目信息

语言: Python
Stars: ⭐ 56,771
Forks: 5,520
今日新增: +436
排名: #1
收录: 总榜
趋势日期: 2026年1月4日

🏷️ 标签

FastAPI数据集成企业级可扩展量化交易员金融分析师

📸 截图

OpenBB 5分钟快速开始

OpenBB是一个开源金融数据平台，通过Python快速安装并启动后端服务，无缝对接可视化界面或AI分析流程。

🖥️ 操作系统

macOSWindowsLinux

⚙️ 运行环境

Python3.9.21 - 3.12

🔧 工具

pip— Python包管理器，用于安装OpenBB

📝 操作步骤

安装OpenBB包

使用pip安装OpenBB核心包，确保Python环境已配置。

从PyPI安装OpenBB

$ pip install openbb

✓预期输出：Successfully installed openbb及相关依赖包，无错误信息。

💡如果遇到权限问题，可尝试添加--user标志或使用虚拟环境。

启动后端API服务器

运行命令启动FastAPI服务器，提供本地数据服务。

启动OpenBB后端服务器

$ openbb start

✓预期输出：服务器启动成功，显示类似'Uvicorn running on http://127.0.0.1:6900'的信息。

💡确保端口6900未被占用，否则可修改配置或停止其他服务。

✅ 验证服务器运行

检查后端服务器是否正常启动并响应请求。

✓在浏览器中访问http://127.0.0.1:6900/docs显示API文档
✓命令行无错误日志，服务器持续运行

⚡ 快速提示

命令行安装后运行openbb --help查看所有可用命令

环境使用虚拟环境（如venv）隔离依赖，避免冲突

开发快速测试数据获取：在Python中导入openbb并调用函数

🔍 常见问题排查

❓ pip install openbb失败，提示依赖错误

→ 升级pip到最新版本：pip install --upgrade pip，然后重试。

❓ openbb start命令未找到

→ 确保OpenBB安装成功，或尝试重新安装：pip uninstall openbb && pip install openbb。

❓ 端口6900被占用，服务器无法启动

→ 停止占用端口的进程，或修改OpenBB配置使用其他端口。

🎯 下一步

连接OpenBB Workspace

登录OpenBB Workspace，在'Apps'标签中连接后端URL http://127.0.0.1:6900，进行可视化分析。

探索数据集成

查看文档或GitHub仓库，了解如何添加股票、加密货币等数据源。

集成AI代理

参考开源仓库，将AI代理接入OpenBB平台，辅助金融分析。

难度

初级

预计时间

3-5小时

目标人群

对金融数据分析感兴趣的Python初学者、金融专业学生、希望快速获取金融数据的分析师、想了解开源金融数据平台的开发者

🎯 学完你将掌握

学会安装和使用OpenBB平台，能够通过Python获取多种金融资产数据，并了解如何将数据接入可视化界面或AI分析流程

📋 前置知识

Python基础熟悉

需要了解Python基本语法、变量、函数、包管理等，因为OpenBB是基于Python的库

pip包管理了解

需要知道如何使用pip安装Python包，这是安装OpenBB的主要方式

终端/命令行基础了解

需要在命令行中执行安装命令和启动服务

金融基础知识了解(可选)

了解股票、加密货币等基本金融概念有助于理解数据含义，但不是必须的

📚 学习资源

必看

OpenBB文档

完整的安装指南、API参考和教程

🗺️ 学习阶段

环境准备与安装

⏱ 30分钟

检查Python环境

确认你的Python版本在3.9.21到3.12之间，可以在终端运行 `python --version` 或 `python3 --version` 查看

💡如果版本不符合，建议使用pyenv或conda管理多个Python版本

安装OpenBB核心包

在终端中运行 `pip install openbb` 安装核心Python包

💡建议在虚拟环境中安装，避免包冲突。可以使用 `python -m venv openbb_env` 创建虚拟环境

验证安装

在Python交互环境中尝试导入OpenBB：`import openbb`，如果没有报错说明安装成功

💡如果导入失败，检查pip是否安装成功，可能需要重启终端

快速上手：获取第一份金融数据

⏱ 1小时

创建Python脚本

创建一个新的Python文件（如first_data.py），导入openbb模块

💡可以从最简单的数据获取开始，比如获取股票价格

获取股票数据

尝试获取苹果公司（AAPL）的股票数据：`data = openbb.stocks.load('AAPL')`

💡首次运行可能需要配置数据源，按照提示操作即可

查看数据

打印或查看获取的数据结构：`print(data.head())` 或 `print(data.columns)`

💡了解数据的格式和包含的字段（如开盘价、收盘价、成交量等）

尝试其他资产类型

尝试获取加密货币数据：`crypto_data = openbb.crypto.load('BTC')`

💡OpenBB支持多种资产类型，可以在文档中查看完整列表

启动后端服务与可视化界面

⏱ 1小时

安装额外依赖

如果需要启动后端API服务，安装相关包：`pip install 'openbb[api]'`

💡方括号内的'api'是extras标记，用于安装可选依赖

启动本地后端服务

在终端运行 `openbb start` 或 `python -m openbb start` 启动FastAPI服务器

💡默认会在127.0.0.1:6900启动，确保端口没有被占用

访问API文档

在浏览器中打开 http://127.0.0.1:6900/docs，查看可用的API端点

💡这是自动生成的Swagger/OpenAPI文档，可以在这里测试API

了解OpenBB Workspace

访问 https://my.openbb.co 了解OpenBB Workspace可视化界面

💡Workspace是付费的企业版界面，但可以免费试用或使用社区版

探索核心功能与数据源

⏱ 1-2小时

查看可用数据源

访问项目文档或GitHub页面，查看支持的数据集成列表

💡数据源可能包括股票、加密货币、衍生品、经济指标等

尝试不同的数据函数

探索openbb模块下的不同子模块：stocks, crypto, economy, forex等

💡使用Python的dir()函数查看模块内容：`dir(openbb.stocks)`

学习数据过滤与处理

尝试对获取的数据进行基本处理，如选择特定时间范围、计算移动平均等

💡OpenBB返回的数据通常是Pandas DataFrame，可以利用Pandas进行数据处理

配置数据源API密钥

如果需要访问付费或受限数据源，按照文档配置API密钥

💡一些数据源可能需要注册获取免费或试用API密钥

⚠️ 常见错误

❌ Python版本不兼容

✅ 确保Python版本在3.9.21到3.12之间，使用pyenv或conda管理多版本

❌ 直接使用系统Python安装导致权限错误

✅ 使用虚拟环境或在pip安装时添加--user标志

❌ 未安装可选依赖导致某些功能不可用

✅ 根据需要使用`pip install 'openbb[api]'`或`pip install 'openbb[all]'`安装完整功能

❌ 端口冲突导致后端服务启动失败

✅ 检查6900端口是否被占用，或使用`openbb start --port 其他端口`指定不同端口

❌ 直接复制代码但未理解数据源配置

✅ 阅读数据源配置文档，某些数据源需要API密钥或特殊配置

🚀 后续方向

掌握基础后，可以探索：1) 将OpenBB集成到自己的量化交易策略中；2) 学习使用OpenBB的REST API构建自定义前端；3) 探索AI代理集成，将OpenBB数据接入AI分析流程；4) 贡献代码或数据源到开源项目；5) 深入学习金融数据分析与可视化