Open Data Platform by OpenBB (ODP) 是一套开源工具集，旨在帮助数据工程师将专有、授权及公开数据源整合至下游应用中，例如 AI 助理和研究仪表板。

ODP 充当“一次连接，多端消费”的基础设施层，可同时将数据整合并暴露给多个平台：供量化分析师使用的 Python 环境、供分析师使用的 OpenBB Workspace 和 Excel、供 AI 代理使用的 MCP 服务器，以及供其他应用调用的 REST API。

开始使用：pip install openbb

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

可用的数据集成可在以下链接找到：https://docs.openbb.co/python/reference

---

OpenBB Workspace

虽然 Open Data Platform 提供了开源的数据集成基础，但 OpenBB Workspace 则为分析师提供了企业级用户界面，用于可视化数据集并利用 AI 代理。该平台的“一次连接，多端消费”架构实现了两者的无缝集成。

您可以在 https://pro.openbb.co 找到 OpenBB Workspace。

数据集成：

• 您可以从 文档 或 此开源仓库 中了解更多关于如何将数据添加到 OpenBB Workspace 的信息。

AI 代理集成：

• 您可以从 此开源仓库 中了解更多关于如何将 AI 代理添加到 OpenBB Workspace 的信息。

将 Open Data Platform 集成到 OpenBB Workspace

只需在 Python（3.9.21 - 3.12）环境中执行几条简单命令，即可将此库连接到 OpenBB Workspace。

运行 ODP 后端

• 安装相关包。

pip install "openbb[all]"

• 在本地主机上启动 API 服务器。

openbb-api

这将通过 Uvicorn 启动一个 FastAPI 服务器，地址为 127.0.0.1:6900。

您可以通过访问 http://127.0.0.1:6900 来检查其是否正常运行。

将 ODP 后端集成到 OpenBB Workspace

登录 OpenBB Workspace，然后按照以下步骤操作：

1. 转到“Apps”选项卡
2. 点击“Connect backend”
3. 填写表单： 名称：Open Data Platform URL：http://127.0.0.1:6900
4. 点击“Test”。您应该会看到一条显示已找到应用数量的“Test successful”消息。
5. 点击“Add”。

完成！

---

目录

1. 安装
2. 贡献
3. 许可证
4. 免责声明
5. 联系方式
6. 星标历史
7. 贡献者

1. 安装

ODP Python 包可通过 PyPI 安装，运行 pip install openbb 即可；或者直接克隆仓库：git clone https://github.com/OpenBB-finance/OpenBB.git。

有关安装过程的更多信息，请参阅 OpenBB 文档。

ODP CLI 安装

ODP CLI 是一个命令行界面，允许您直接从命令行访问 ODP。

您可以运行 pip install openbb-cli 来安装，也可以直接克隆仓库：git clone https://github.com/OpenBB-finance/OpenBB.git。

有关安装过程的更多信息，请参阅 OpenBB 文档。

2. 贡献

参与本项目主要有三种方式。（希望您现在已经为该项目加星 ⭐️）

成为贡献者

• 更多信息请参阅我们的 开发者文档。

创建 GitHub 问题

在创建问题之前，请确保您要创建的问题尚未存在于 现有问题列表 中。

• 报告 bug
• 提出改进建议
• 请求新功能

提供反馈

我们在 我们的 Discord 上最为活跃，但您也可以通过任何 我们的社交媒体 与我们联系，提供反馈。

3. 许可证

本项目采用 AGPLv3 许可证进行分发。更多信息请参阅 LICENSE 文件。

4. 免责声明

金融工具交易涉及高风险，包括损失部分或全部投资金额的风险，可能并不适合所有投资者。

在决定交易某种金融工具之前，您应当充分了解与金融市场交易相关的风险和成本，仔细考虑您的投资目标、经验水平和风险承受能力，并在必要时寻求专业建议。

开放数据平台中包含的数据未必准确。

OpenBB及本网站所载数据的任何提供方均不对您因交易或依赖所展示信息而产生的任何损失或损害承担责任。

我们网站、产品或文档中可能引用的第三方名称、标识和品牌均为其各自所有者的商标。除非另有说明，OpenBB及其产品和服务并未获得这些第三方的认可、赞助或关联。

我们使用这些名称、标识和品牌仅用于识别目的，并不意味着存在任何形式的认可、赞助或关联。

5. 联系方式

如果您对平台或OpenBB有任何疑问，请随时发送邮件至 support@openbb.co。

如果您想打个招呼，或有意与我们合作，欢迎通过 hello@openbb.co 联系我们。

我们的社交媒体平台：openbb.co/links

6. 星标历史

这是我们成长的一个指标，也表明我们才刚刚起步。

如需了解更多对我们重要的指标，请访问 openbb.co/open。

7. 贡献者

没有您，OpenBB就不会是现在的OpenBB。如果我们想要颠覆金融行业，每一份贡献都至关重要。感谢您参与这一旅程。

OpenBB 快速上手指南

OpenBB (Open Data Platform) 是一个开源数据平台，旨在帮助数据工程师将专有、授权和公共数据源集成到下游应用（如 AI 助手、研究仪表板）中。它采用“一次连接，随处消费”的架构，支持 Python、Excel、REST API 等多种环境。

1. 环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows、macOS 或 Linux
• Python 版本：3.9.21 至 3.12
• 包管理工具：pip
• 前置依赖：建议更新 pip 至最新版本以确保兼容性

  python -m pip install --upgrade pip
  

提示：国内开发者若遇到下载速度慢的问题，建议使用国内镜像源（如清华源或阿里源）进行安装。

2. 安装步骤

您可以通过 PyPI 直接安装 OpenBB 核心库或命令行工具。

安装 Python SDK（推荐）

安装基础包：

pip install openbb

安装包含所有数据集成扩展的完整包（推荐用于全面功能体验）：

pip install "openbb[all]"

(国内加速示例)

pip install openbb -i https://pypi.tuna.tsinghua.edu.cn/simple
pip install "openbb[all]" -i https://pypi.tuna.tsinghua.edu.cn/simple

安装命令行界面 (CLI)

如果您希望通过终端直接交互，可单独安装 CLI 工具：

pip install openbb-cli

3. 基本使用

方式一：在 Python 脚本中使用

这是最基础的用法，适用于量化分析、数据提取及集成到 AI 应用中。

from openbb import obb

# 获取苹果公司 (AAPL) 的历史股价数据
output = obb.equity.price.historical("AAPL")

# 将结果转换为 Pandas DataFrame 以便进一步处理
df = output.to_dataframe()

# 查看前几行数据
print(df.head())

方式二：启动本地 API 后端 (连接 OpenBB Workspace)

若需将数据源连接到 OpenBB Workspace 可视化界面或供 AI Agent 调用，需启动本地 API 服务。

1. 启动服务： 运行以下命令将在 127.0.0.1:6900 启动一个 FastAPI 服务器。

   openbb-api
   

2. 验证服务： 在浏览器中访问 http://127.0.0.1:6900 确认服务正常运行。

3. 连接 Workspace（可选）：

   • 登录 OpenBB Workspace。
   • 进入 Apps 标签页，点击 Connect backend。
   • 填写表单：
     • Name: Open Data Platform
     • URL: http://127.0.0.1:6900
   • 点击 Test 验证，显示 "Test successful" 后点击 Add 即可完成集成。

方式三：使用命令行交互

安装 openbb-cli 后，直接在终端输入以下命令进入交互式界面：

openbb

进入界面后，您可以直接使用类似 /equity/price/historical --symbol AAPL 的命令获取数据。